Skip to main content

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.

PathPurpose / evidence
apps/webReact/Vite SPA, tests and browser QA. A:apps/web/package.json:6-22
apps/apiNest/Fastify API, migration and maintenance entrypoints. A:apps/api/src/app.ts:153-194; A:apps/api/package.json:6-23
packages/sharedShared validation and permission contract. A:packages/shared/src/index.ts:35-126
apps/api/drizzle/public and tenantOwner-run migration definitions. See the source-by-column data model.
.set/work and docs/threat-modelsDesign, approval and QA records; not staging observations. A:.set/work/P2.22.md:3-17
openwikiApp-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 / actionCommandSource
Web developmentpnpm --filter @set/web devA:apps/web/package.json:7
API start after buildpnpm --filter @set/api startA:apps/api/package.json:14
Typecheckpnpm typecheckA:package.json:13
Lint and format checkpnpm lint; pnpm format:checkA:package.json:10-12
Buildpnpm buildA:package.json:14
Unit/integration/coveragepnpm testA:package.json:15; A:.github/workflows/ci.yml:109-117
Tenant isolationpnpm test:isolationA:package.json:16
Mutationpnpm mutationA:package.json:17
Geometry after web buildpnpm --filter @set/web run geometryA:apps/web/qa/geometry.mjs:1-27
Interactionsnode apps/web/qa/interactions.mjsA: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

WorkflowDefined behaviorStatus
ci.ymlTypecheck; lint/format; build; unit/integration coverage; isolation; scoped/full mutation decision; image build and scan. A:.github/workflows/ci.yml:89-188MERGED, NOT DEPLOYED
security.ymlCalls the pinned reusable set-platform security-core workflow. No successful-run attestation supplied. A:.github/workflows/security.yml:1-10MERGED, NOT DEPLOYED
deploy-staging.ymlDevelop/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-417MERGED, NOT DEPLOYED
mutation-weekly.ymlSunday 02:00 UTC, full mutation on default branch. A:.github/workflows/mutation-weekly.yml:5-12,44-52MERGED, NOT DEPLOYED
alerts.ymlWorkflow notification definition; delivery and destination NOT VERIFIED. A:.github/workflows/alerts.yml:1-45MERGED, NOT DEPLOYED
log-archive.ymlLog-archive workflow definition; successful archive and retention NOT VERIFIED. A:.github/workflows/log-archive.yml:1-45MERGED, 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):

  1. Use the pinned toolchain and dependency lockfile. CI installs with pnpm install --frozen-lockfile --ignore-scripts. A:package.json:5-8 A:.github/workflows/ci.yml:89-91
  2. 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
  3. 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,19 A:CLAUDE.md:1471-1476
  4. 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
  5. 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-6 A:apps/web/qa/interactions.mjs:1-16