Skip to content

CLAUDE.md

Latest commit

 

History

History
19 lines (14 loc) · 1.17 KB

CLAUDE.md

File metadata and controls

19 lines (14 loc) · 1.17 KB
Raw

CLAUDE.md

Quackback - open-source customer feedback platform. Bun monorepo, TanStack Start, PostgreSQL + Drizzle, Tailwind v4 + shadcn/ui.

Commands

bun run setup              # One-time setup (deps, Docker, migrations, seed)
bun run dev                # Dev server at localhost:3000 (login: demo@example.com / password)
bun run build && bun run db:generate && bun run db:migrate
bun run test && bun run test:e2e && bun run lint && bun run typecheck

Rules

  • Entity IDs are branded TypeIDs via @quackback/ids
  • Never add co-author trailers to git commits
  • When cutting a release, bump version in apps/web/package.json to match the git tag — this is the source of truth for __APP_VERSION__ (injected at build time via Vite)
  • Tier limits live in settings.tier_limits (JSON column) and are enforced via getTierLimits() + the helpers in apps/web/src/lib/server/domains/settings/tier-enforce.ts. The default (no row) is unlimited. The control-plane writes per-tenant limits via /api/v1/internal/tier-limits (scope-gated). The OSS code is unaware of "cloud" as a concept — limits and their writer are the same mechanism for self-hosters and cloud tenants.