Corex Digital Solutions
Monorepo for the Corex MVP: the marketing website and three business systems (School, Clinic, Finance), each testable in a live demo before purchase.
Layout
| Path | What it is |
|---|
apps/web | Marketing website |
apps/school | School Management System (EDITION=college or highschool) |
apps/clinic | Clinic Management System |
apps/finance | Financial Management System |
packages/config | Shared TypeScript, ESLint, Prettier, Vitest and Next.js config |
packages/ui | Corex theme tokens, shadcn/ui components, app shell |
packages/db | Client schemas: migrations, provisioning, backups, RLS, audit |
supabase/ | Local Supabase stack config (development only) |
e2e/ | Playwright end-to-end and accessibility tests |
docs/ | Specification, mockup and operations notes |
Requirements
- Node.js 22 (
.nvmrc)
- pnpm 10 (
corepack enable)
- Docker (for the local Supabase stack)
Common commands
pnpm install # install all workspaces
pnpm dev # run every app in development
pnpm --filter @corex/web dev # run one app
pnpm lint # ESLint
pnpm typecheck # TypeScript
pnpm test # Vitest unit tests
pnpm build # production builds
pnpm test:e2e # Playwright (builds must exist)
pnpm check # format, lint, typecheck, test, build
App ports in development: web 3000, school 3001, clinic 3002, finance 3003.
Database scripts (see docs/database.md):
pnpm db:provision --schema <name> --product <school|clinic|finance> --org "<name>" --admin-email <email>
pnpm db:migrate --schema <name> --product <product>
pnpm db:migrate:all --product <product>
pnpm db:backup --schema <name> --project <label>
pnpm db:restore --schema <name> --project <label> --confirm <name>
pnpm --filter @corex/db test:db # database tests (needs pnpm db:local:start)
See each app's and package's README.md for details, and docs/local-dev.md for the local database.
Guides: deploying (Vercel and Docker), offline use, restoring a backup, handing a system over to a client, demos.
