Monorepo Quickstart

Purpose

This page is the default starting point for internal engineering contributors.

Use this with System Architecture to understand service boundaries before coding.

Local Setup

pnpm install
pnpm dev

For service-specific loops:

pnpm --filter @hikari/<app> dev
pnpm --filter @hikari/<app>... build
pnpm --filter @hikari/<app> lint
pnpm --filter @hikari/<app> test

Environments

• *.zenku.dev: staging/dev remote backends
• *.zenku.app: production
• localhost: local development

When local frontend needs remote backend data, use *.zenku.dev.

Collaboration Loop

1. Read the relevant app/package docs from App Catalog and Package Catalog.
2. Implement in small increments.
3. Run lint and tests locally.
4. Update docs metadata and links when behavior changes.

Doc Update Rule

If you touched apps/*, packages/*, or deploy/*, update at least one docs page in apps/docs/docs.

See Engineering Standards.