Aragon App monorepo
pnpm workspaces + Turborepo. Node >=24.22.1 (see .nvmrc), pnpm (see packageManager in package.json).
Workspaces
| Path | Package | What it is |
|---|
apps/app | @aragon/app | The Aragon App (app.aragon.org) — see its own README |
apps/assistant | @aragon/assistant | Assistant service: support-chat intake API |
packages/aragon-domain | @aragon/aragon-domain | Governance business logic over the Envio indexer, also on npm |
packages/assistant-chat | @aragon/assistant-chat | Support-chat widget for the app |
packages/assistant-contracts | @aragon/assistant-contracts | Zod contracts shared by the assistant service and the widget |
packages/gov-ui-kit | @aragon/gov-ui-kit | Governance UI Kit, also published to npm |
Quick start
pnpm install
pnpm dev # runs the app dev server (turbo)
The root only carries workspace-wide tasks, fanned out through turbo: pnpm dev, pnpm build, pnpm test, pnpm type-check, pnpm lint. Anything app-specific (e2e, env setup, codegen, watch modes) runs inside the workspace that owns it: cd apps/app (or pnpm --filter @aragon/app <script>).
Repo layout
apps/app/ — all app source, configs, e2e/, docs/, scripts/, CHANGELOG.md.github/workflows/ — CI, grouped per app: app-*.yml (the app), shared-*.yml (reusable deploy/e2e building blocks).changeset/ — release versioning for every workspace; which packages release together is set in .github/release-scopes.yml.agents/, .claude/ — agent tooling; see AGENTS.md
Migrating a branch created before the monorepo restructure? See MIGRATION.md.
