App development
MERGED, NOT DEPLOYED — commands and repository structure are verified from the supplied app branch. Latest CI success, required-check settings and actual release completion are NOT VERIFIED; a workflow definition is not a successful run.
| Path | Purpose / evidence |
|---|---|
| apps/web | React/Vite SPA, tests and browser QA. A:apps/web/package.json:6-22 |
| apps/api | Nest/Fastify API, migration and maintenance entrypoints. A:apps/api/src/app.ts:153-194; A:apps/api/package.json:6-23 |
| packages/shared | Shared validation and permission contract. A:packages/shared/src/index.ts:35-126 |
| apps/api/drizzle/public and tenant | Owner-run migration definitions. See the source-by-column data model. |
| .set/work and docs/threat-models | Design, approval and QA records; not staging observations. A:.set/work/P2.22.md:3-17 |
| openwiki | App-side architecture summaries. These must agree with this section; they do not replace primary code or live evidence. A:.set/work/decisions-2026-10-26.md:74 |
Local setup and checks
Use Node >=22.12 and the repository pin pnpm 12.4.0. Read the app's setup guidance for local Postgres/Redis and WorkOS configuration; obtain secrets through the approved local secret mechanism. Do not put credentials into docs or committed URLs. A:package.json:5-8 A:apps/api/src/standards/store.ts:10-12 A:apps/api/src/db/credentials.ts:1-30
The following are documented commands, not commands executed during this task. Dependency installation, Docker/image pulls, cloud access and builds were deliberately not run.
| Check / action | Command | Source |
|---|---|---|
| Web development | pnpm --filter @set/web dev | A:apps/web/package.json:7 |
| API start after build | pnpm --filter @set/api start | A:apps/api/package.json:14 |
| Typecheck | pnpm typecheck | A:package.json:13 |
| Lint and format check | pnpm lint; pnpm format:check | A:package.json:10-12 |
| Build | pnpm build | A:package.json:14 |
| Unit/integration/coverage | pnpm test | A:package.json:15; A:.github/workflows/ci.yml:109-117 |
| Tenant isolation | pnpm test:isolation | A:package.json:16 |
| Mutation | pnpm mutation | A:package.json:17 |
| Geometry after web build | pnpm --filter @set/web run geometry | A:apps/web/qa/geometry.mjs:1-27 |
| Interactions | node apps/web/qa/interactions.mjs | A:apps/web/qa/interactions.mjs:1-16,36-41 |
Geometry runs Chromium against mock API data across 1024/1280/1440/1920 widths, LTR/RTL and light/dark themes. It checks layout contracts, missing selectors, unexpected calls and page errors. Interactions also test reduced motion. These are local browser gates, not evidence that staging workflows work. A:apps/web/qa/geometry.mjs:1-27 A:apps/web/qa/interactions.mjs:1-16,36-41
Delivery and CI
The documented delivery process is design → Codex design review → Ron approval → build → QA → reviews and threat-model sign-off → daily PR → staging release. Design revisions and approval are explicit in the work records. Documentation and diagrams are part of done, not follow-up work. A:.set/work/P2.22.md:5-17 A:.set/work/decisions-2026-10-26.md:39-50,74
| Workflow | Defined behavior | Status |
|---|---|---|
| ci.yml | Typecheck; lint/format; build; unit/integration coverage; isolation; scoped/full mutation decision; image build and scan. A:.github/workflows/ci.yml:89-188 | MERGED, NOT DEPLOYED |
| security.yml | Calls the pinned reusable set-platform security-core workflow. No successful-run attestation supplied. A:.github/workflows/security.yml:1-10 | MERGED, NOT DEPLOYED |
| deploy-staging.yml | Develop/manual deploy, protected environment names nonprod and nonprod-deploy, digest reuse and migration-before-release. Environment protection settings need live evidence. A:.github/workflows/deploy-staging.yml:32-33,153,230-237,280-417 | MERGED, NOT DEPLOYED |
| mutation-weekly.yml | Sunday 02:00 UTC, full mutation on default branch. A:.github/workflows/mutation-weekly.yml:5-12,44-52 | MERGED, NOT DEPLOYED |
| alerts.yml | Workflow notification definition; delivery and destination NOT VERIFIED. A:.github/workflows/alerts.yml:1-45 | MERGED, NOT DEPLOYED |
| log-archive.yml | Log-archive workflow definition; successful archive and retention NOT VERIFIED. A:.github/workflows/log-archive.yml:1-45 | MERGED, NOT DEPLOYED |
Do not mark geometry or interactions as CI-enforced solely because their scripts exist. The inspected CI workflow invokes the listed package gates; a release review must record browser QA separately. See environments and deploy.
Local bootstrap, as documented by the app, starts Postgres/Redis with docker compose up --wait. The full setup also needs the approved environment configuration, dependencies at the pinned lockfile and owner migrations before the API starts. These instructions are descriptive; nothing was installed, started or migrated here. A:CLAUDE.md:1465-1500
Local setup sequence (MERGED, NOT DEPLOYED, not executed here):
- Use the pinned toolchain and dependency lockfile. CI installs with pnpm install --frozen-lockfile --ignore-scripts.
A:package.json:5-8A:.github/workflows/ci.yml:89-91 - Copy .env.example to the ignored .env and obtain the approved local configuration. Start local Postgres and Redis with docker compose up --wait. No secret values are listed here.
A:CLAUDE.md:1469-1470 - Build the workspace, then run pnpm db:migrate with the local owner configuration. For a new local buyer, run the provision-local.mjs script from apps/api using the buyer slug, display name and WorkOS organization ID. Its local secret store is anchored to apps/api/.local-secrets.
A:package.json:14,19A:CLAUDE.md:1471-1476 - Start API and web in separate terminals. Vite uses port 5173 and proxies /api to 127.0.0.1:3000. Local VITE_API_ORIGIN is empty; deployed builds embed the configured origin.
A:CLAUDE.md:1471-1479 - Run the listed test gates and browser QA. No production or staging state is needed for the mock-backed geometry/interactions checks.
A:apps/web/qa/geometry.mjs:1-6A:apps/web/qa/interactions.mjs:1-16