Repository map

Trile is split across four repositories under one workspace. This page orients a new engineer.

Repo	Stack	Responsibility
`trile`	NestJS 11, Drizzle, PostgreSQL 16, Redis 7 + BullMQ, Better Auth	The backend. Serves the `/v1` API and runs the billing/worker/scheduler processes. Source of truth for the OpenAPI spec.
`trile_frontend`	React, Vite, TanStack Router/Query, Tailwind, Storybook	The merchant dashboard (manage business, catalog, subscriptions, keys, webhooks, team).
`trile_checkout`	React, Vite, TanStack Router/Query, Tailwind	The hosted checkout app a customer uses to top up and subscribe. Backs `checkout.trile.app`.
`trile-landing`	Astro	Marketing site (`trile.app`).
`docs`	Astro Starlight	This documentation site (`docs.trile.app`).

How they connect

trile-landing (marketing)  ──▶  trile_checkout (hosted checkout)  ──┐
                                                                    │  HTTP /v1
trile_frontend (dashboard) ─────────────────────────────────────-──┤
                                                                    ▼
                                                            trile (backend API)
                                                                    │
                                                  ┌─────────────────┼─────────────────┐
                                                  ▼                 ▼                 ▼
                                              PostgreSQL          Redis            providers
                                                                (BullMQ)     (eSewa/Khalti/IME)

Both frontends consume the backend’s OpenAPI spec to generate a typed client: npm run api:generate runs openapi-typescript against the backend’s /docs-json.
This docs site consumes the same /docs-json for its API Reference — see Local development.

Key backend files

Path	What
`src/main.ts`	Bootstrap; selects the process role.
`src/app.module.ts`	Root module wiring.
`src/modules/*`	One folder per bounded context (wallet, billing, subscriptions, catalog, checkout, webhooks, customers, events, merchant, team, security, auth, payment, …).
`src/shared/money.ts`	The `Money` value object.
`src/shared/ids.ts`	Prefixed ULID generation.
`src/common/idempotency/`	The idempotency interceptor + store.
`src/auth/`	Better Auth configuration (3 auth modes).
`docs/runbooks/`	Operational runbooks (also summarized here).