Getting started

Prerequisites

• Node.js 22+
• Docker (Postgres + the app container)
• pnpm

Run the starter

From the repo root:

docker compose up

The app is available at http://localhost:3000. Package installs and scripts should run inside the app container so lockfiles stay aligned with the dev environment:

docker exec isotopekit_core_app pnpm add <package>
docker exec isotopekit_core_app pnpm run build

Compose packages

The starter wires @isotopekit/* packages into a thin Next.js app. Typical composition:

1. Core — config, db, logger, email, types, ui
2. Domain — auth, identity, organization, plans, billing, user
3. Modules — admin, agency, pricing, billing-ops, org-ui
4. Transport — api (Hono)

See Packages for an overview of each area.

Agent-first layout

The kit ships AGENTS.md, structured _docs specs, and Cursor skills so AI tools can navigate the monorepo without guessing folder names. Keep those files accurate when you extend packages.