Developer Guide

Singularity is the Cyberia monorepo. It combines the public site and bridge, a DEX, EVM and Solana contracts, native application shells, games, bots, AI agents, and infrastructure integrations.

There is no single root application to start. Pick a component, follow its nested instructions, and run the narrowest relevant verification command.

Start here

Goal	Read	Main source
Understand the system	Architecture	Repository-wide
Find the right component	Component guide	Product and service map
Run a component locally	Local development	Component-specific
Pick the right checks	Testing and verification	Component-specific
Integrate the chain	Network reference	Cyberia EVM L1
Build a user-facing page or API	Laravel AGENTS.md	backend/laravel/
Build or test EVM contracts	crypto/hardhat/README.md	crypto/hardhat/
Work on the DEX	frontend/ritual/README.md	frontend/ritual/
Use Cyberia-hosted inference	Inference API	/api/ai/v1
Work on autonomous agents	LainOS	services/lainos/

Repository rules

• Read the root AGENTS.md, then the nearest nested AGENTS.md before changing a subtree.
• Treat environment files, wallet JSON, cookies, tokens, private keys, and production service configuration as secrets.
• Do not edit dependency trees or generated build and contract outputs.
• Keep changes focused and preserve unrelated working-tree changes.
• Verify with the smallest useful test, type check, build, or configuration command.

For a complete directory map, see Architecture.

A typical contribution

1. Read the root AGENTS.md and the nearest component README or nested AGENTS.md.
2. Start only the component you need; the repository has no required root-wide bootstrap.
3. Make one focused change and keep unrelated working-tree edits intact.
4. Run the narrow checks listed in Testing and verification.
5. Update user or developer documentation when a public flow, endpoint, contract, command, or limitation changes.