Project structure

This is a high-level map of the monorepo, aligned with the current layout.

Top level (tree)


/
├── .devcontainer/           # Devcontainer image + settings
├── docker-compose.yml       # local stack orchestration
├── bin/                     # helper scripts (Docker, Gno, tooling)
├── client/
│   ├── docs/                # docs site (Nextra)
│   └── game/                # game client (Svelte)
├── server/
│   ├── world/               # world/multiplayer backend
│   ├── communicate/         # chat/rooms
│   ├── bridge/              # integration/bridge layer
│   ├── internal-api/        # internal HTTP APIs
│   └── internal-worker/     # background workers and stream processors
├── shared/
│   ├── common/              # shared utilities and errors
│   ├── network/             # protocol/DTO types
│   ├── config/              # config helpers
│   └── expr/                # expression helpers
├── contracts/               # Gno contracts
├── database/                # Prisma schema, migrations, and DB tooling
├── seed/                    # asset generation and seed data
├── git-ops/                 # Argo CD manifests for staging/production
├── gcloud/                  # cloud scripts and configs
└── gno/                     # local chain balances/config inputs

Where to start

Docs: client/docs/content
Game client: client/game
Backend services: server/world, server/communicate, server/bridge
Internal services: server/internal-api, server/internal-worker
Shared types: shared/network, shared/common
Chain/contracts: contracts/, gno/
Dev environment: .devcontainer/, docker-compose.yml, bin/docker/