Development Setup
Prerequisites
Section titled “Prerequisites”- Node.js 22+
- pnpm 9+ (
corepack enablerecommended) - Docker / Docker Compose
git clone https://github.com/grand2-products/echolore.gitcd echolorepnpm install
# Copy environment filescp apps/api/.env.example apps/api/.envcp apps/web/.env.local.example apps/web/.env.localcp apps/worker/.env.example apps/worker/.envRunning
Section titled “Running”# Start DB / Valkey / LiveKit etc. via Dockerpnpm docker:dev
# App dev servers (turbo)pnpm devOn Windows, use ./dev.ps1 (or pnpm dev:daily).
Key commands
Section titled “Key commands”| Command | Description |
|---|---|
pnpm typecheck |
Type-check all packages |
pnpm lint |
Biome lint |
pnpm test |
All tests |
pnpm build |
Build all packages |
pnpm db:migrate |
Apply migrations |
pnpm db:generate |
Generate a migration |
pnpm docker:dev / pnpm docker:down |
Dev compose up/down |
Monorepo layout
Section titled “Monorepo layout”| Package | Contents |
|---|---|
apps/web |
Next.js frontend |
apps/api |
Hono API backend |
apps/worker |
AI agent worker |
apps/docs |
This documentation site (Starlight) |
packages/shared |
Shared contracts (DTOs, types) |
packages/ui |
Shared UI components |
Documentation site development
Section titled “Documentation site development”pnpm --filter @echolore/docs devSite content lives in apps/docs/src/content/docs/{ja,en}/ as Markdown/MDX.