BizManager
Hebrew (RTL) business-management system for an Israeli business: projects, sales
orders, customers, financials, payroll, collections, documents and more.
Stack: Next.js 16 (App Router) · React 19 · TypeScript (strict) · Supabase
(Postgres + Auth + RLS + Storage) · Tailwind v4 + Radix · Vitest.
Hosting: Vercel (fra1) · DB region: eu-central-1 (Frankfurt).
Bootstrap (from zero)
Prerequisites: Node 20+ and npm. Get the project secrets from the owner.
npm install
cp .env.example .env # then fill in real values (see below)
npm run dev # http://localhost:3000
Environment variables
.env.example is the source of truth for what's required — copy it and fill in
each value. Real .env* files are gitignored; never commit secrets.
| Variable | Where to get it |
|---|
NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY | Supabase → Settings → API |
SUPABASE_SERVICE_ROLE_KEY | Supabase → Settings → API (server-only; needed for cron + payroll) |
OPENAI_API_KEY | platform.openai.com — all AI (voice, transcription, PDF extract) |
MORNING_* | Morning/GreenInvoice invoicing credentials |
VAPID_*, NEXT_PUBLIC_VAPID_PUBLIC_KEY | npx web-push generate-vapid-keys |
CRON_SECRET | openssl rand -hex 32 |
DEFAULT_PRODUCT_CATEGORY_ID, PAYROLL_ADMIN_PASSWORD | app config |
NEXT_PUBLIC_SENTRY_DSN | Sentry (optional; blank disables locally) |
Quality gate (must pass before merge)
CI (.github/workflows/ci.yml) runs these on every push/PR — run them locally first:
npm run typecheck # tsc --noEmit
npm run lint # eslint
npm test # vitest run
Database changes
Schema changes go through versioned migrations in supabase/migrations/ only;
db/sql/ is frozen (CI enforces it). See
supabase/migrations/README.md.
npm run db:new <name> # create a migration
npm run db:push # apply pending migrations
More
