Common tasks
Add or change a tRPC endpoint
Section titled “Add or change a tRPC endpoint”Touch packages/api/src/routers/* for procedure shape and packages/api/src/services/* for behavior. Update the relevant *.FEATURE.md when behavior changes. Run API type checks, then bun --filter @repo/docs build to regenerate the API reference.
Add a web page or form action
Section titled “Add a web page or form action”Touch the SvelteKit route in apps/svelte-web/src/routes. Prefer existing UI primitives and form patterns. Update i18n keys when user-facing text changes, compile Paraglide, then run web checks.
Add a database field
Section titled “Add a database field”Edit the relevant migration under packages/database/migrations/, run bun --filter @repo/database db:codegen to regenerate the Kysely types, adjust service transforms, update contract schemas if the field crosses native boundaries, and document the behavioral impact in the owning FEATURE.md.
Add a native model field
Section titled “Add a native model field”Update @repo/contract schemas first, regenerate Swift/Kotlin models, update fixtures, then adapt native UI/API usage. CI should fail if generated model drift is not committed.
Add a Knock workflow
Section titled “Add a Knock workflow”Add translations and payload typing in @repo/notifications, add Knock source files under knock/, add workflow metadata in generate-knock-reference.ts, and run the docs build so the workflow reference appears.
Add an env var
Section titled “Add an env var”Update .env.example, Settings → Environment variables, deployment secrets, and app-specific docs. Include default behavior and production failure mode.
Deploy and verify
Section titled “Deploy and verify”Use Operations → Release playbooks for the target deployable. Always identify the verification endpoint or user flow before deploying.