KD SOLUTION IT

Enterprise multi-tenant SaaS platform for invoicing, payments, payroll and accounting, built for the Asia-Pacific market (secondary market: United States).

Stack

Next.js 16 (App Router, Turbopack), React 19, TypeScript (strict), Tailwind CSS, shadcn/ui, Supabase (PostgreSQL, Auth, RLS, Realtime, pg_cron), Google Drive API (optional per-company file storage), 16 pluggable payment processor adapters, universal SMTP email, WhatsApp Meta Cloud API, Netlify (primary) and Docker/VPS (alternative), Sentry, Cloudflare Turnstile.

How the project is built

The work is split into 16 STEPs. One STEP is built in one chat; every STEP is divided into sub-steps before code is written. Read these files first:

File	Purpose
CLAUDE.md	Rules loaded in every chat (20 absolute rules, branch policy, scope discipline)
docs/execution/STEP_PROTOCOL.md	The procedure every STEP follows
docs/execution/OWNERSHIP_MAP.md	Which STEP owns which paths and tables
docs/execution/CONTRACTS.md	Interfaces between STEPs
docs/execution/REQUIREMENTS_SPEC.md	Formal requirements (login lock, card rules, processors, storage)
docs/execution/PAYMENT_PROCESSORS.md	The 16 processors and the documentation rule
docs/steps/STEP-NN/SCOPE.md	Scope of each STEP
docs/execution/INTEGRATION_CHECKLIST.md	How STEPs are merged into integration

integration is the main branch.

Getting started

nvm use                       # Node 22
npm ci --ignore-scripts
cp .env.example .env.local    # fill in the values (see comments in the file)
npm run gen                   # generates barrels from fragments
npm run dev

Development preview of the shared interface elements: set APP_ENV=development and SHELL_PREVIEW=1, then open /dev/shell-public, /dev/shell-auth, /dev/shell-dashboard, /admin/dev/shell-admin and /dev/shell-portal.

Commands

Command	What it does
npm run lint / npm run typecheck	ESLint and TypeScript
npm run gen / node scripts/gen.mjs --check	Generate or verify generated files
npm run check	All guard scripts (language, tests, markers, path comments, any, console, card data, brand names, money, secrets, migrations, dead links)
bash scripts/integration-check.sh [--quick]	Merge check
bash scripts/db-apply.sh --clean	Apply all migrations to a fresh database and run SQL assertions
npm run verify:step01	Verification of the STEP 01 libraries and guards

Rules in short

English only in code and UI. USD only, numeric(18,4), never JavaScript Number for money. No test files. No unfinished markers. No any. No console output. Every table has RLS and audit. Details: CLAUDE.md.