Giant Realms Developer Docs

Giant Realms uses a small monorepo with explicit app, package, and infrastructure ownership. Runtime systems should move through contracts, domain logic, platform adapters, and deployable apps rather than reaching across package boundaries.

Working Model

flowchart LR
  Contracts["packages/contracts\nshared types and route contracts"]
  Domain["packages/domain\npure rules and validation"]
  Platform["packages/platform\nadapters and manifests"]
  Backend["packages/backend\nuse cases and repositories"]
  Apps["apps/*\nsite, dev, docs"]
  Infra["infrastructure\nCDK stacks"]

  Contracts --> Domain
  Contracts --> Platform
  Domain --> Backend
  Platform --> Backend
  Backend --> Apps
  Contracts --> Infra