mirror of
https://github.com/moeru-ai/airi.git
synced 2026-08-14 11:23:34 +00:00
4ccde2c96e
Some checks are pending
CI / Unit Test (push) Waiting to run
CI / Type Check (push) Waiting to run
CI / Check Provenance (push) Waiting to run
CI / Lint (push) Waiting to run
CI / Build Test (stage-tamagotchi) (push) Waiting to run
CI / Build Test (stage-tamagotchi-godot) (push) Waiting to run
CI / Build Test (stage-web) (push) Waiting to run
CI / Build Test (ui-loading-screens) (push) Waiting to run
CI / Build Test (ui-transitions) (push) Waiting to run
Cloudflare Pages (Auth UI) / Deploy - ui-server-auth (push) Waiting to run
Cloudflare Workers / Deploy - stage-web (push) Waiting to run
Update Nix pnpmDeps Hash / update (push) Waiting to run
1.3 KiB
1.3 KiB
AIRI server workspace
Backend deployables and backend-only packages live under this directory. Keeping them in one workspace makes the deployment boundary explicit while the repository root remains the shared pnpm workspace.
Structure
apps/api: Hono HTTP and WebSocket API, including auth, billing, chat synchronization, model gateway routing, and observability.packages/drizzle-migration: compiled Drizzle migrations consumed by the API at startup.docker-compose.yml: local API, PostgreSQL, and Redis stack.
Packages shared with browser, desktop, integrations, or plugins remain in the root packages/ directory because they are not backend-only.
Usage
From the repository root:
pnpm -F @proj-airi/api-server dev
pnpm -F @proj-airi/api-server typecheck
pnpm -F @proj-airi/api-server exec vitest run
pnpm -F @proj-airi/api-server build
pnpm dev:backend
Use the scoped package commands when PostgreSQL and Redis already exist. Use pnpm dev:backend to build and run the complete local Compose stack.
Boundaries
Use server/apps/api for API-owned routes, services, schemas, and runtime composition. Use server/packages only for packages that are private to backend deployables. Cross-runtime contracts and SDKs belong in the root packages/ workspace.