Bonafide resource launchpad

Product surfaces

The apps themselves — production and staging.

• Adminprod·staging
• POSprod·staging
• Storefront (canonical)prod·staging
• Storefront (tenant example — Hilltop)

  Customer sites are served via Cloudflare-for-SaaS custom hostnames.

• Auth (Better Auth + JWKS)prod·staging

  API surface — links to /health; endpoints under /api/auth/*.

• MCP serverprod·staging

  Protocol endpoint — links to /health; MCP clients use the root.

• Webhooks (health)prod·staging
• Test RPC (staging-only)

  E2E harness — no production surface by design.

Design & previews

Main-branch deploys. PR/branch aliases: pr-<N>-<worker>.prettygood.workers.dev

• Storybook — Admin
• Storybook — App (Bonafide Kit)
• Storybook — POS
• Storybook — Customer site
• Email template previews

Reports & dashboards

• PRD adherence dashboard

  Shared-key gated (?key=<dashboard key>).

• PRD system report (HTML)
• Code-health dashboard (HTML)

  Not deployed — open the file locally.

Observability

• Better Stack — team home
• Better Stack — Turso DB Stewardship dashboard
• Better Stack — uptime monitors
• Exception-resolution playbook

Ops & external services

• GitHub repo
• GitHub Actions
• Deploy Production (workflow)
• Deploy Staging (workflow)
• Cloudflare — Prod account
• Cloudflare — Stage account
• Cloudflare — Dev account
• Linear (WINE- workspace)
• Amplitude
• Turso (org: jesh)

  wine-prod-20250901 · wine-stage-20260121 (aws-us-west-2).

• Stripe dashboard

  Connect platform; staging = test mode.

• Resend

Docs & runbooks

• PRD index
• Source tree
• Glossary
• Environment variables
• Testing guide
• Observability
• Synthetic monitors runbook
• Guardian playbook
• Code-health playbook
• Staging account migration (service wiring)

Local dev quick reference

• Storybook dev ports — admin 6006 · customer-site 6007 · pos 6008 · app 6009
• Email preview — pnpm -F @repo/transactional dev → :3200
• Boot E2E stack — pnpm dev:e2e --kill · admin login foo@bar.co / password123