The package you download is an npm workspace monorepo: three React frontends, one .NET API and a declarative configuration layer that drives all of them.
Requirements
- Node.js 22 or newer
- .NET 10 SDK
- Docker, for the local PostgreSQL instance
Install and run
Unzip the package, then run these from its root:
npm install
npm run setup
npm run validate-config
docker compose up -d postgres
npm run dev
npm run dev starts the API and all three frontends at once. To run a single app, use
npm run dev:marketing-site, npm run dev:web-app or npm run dev:admin-panel.
What each app is for
| App | Purpose |
|---|---|
apps/marketing-site |
Public site: landing pages, pricing, blog, checkout entry point |
apps/web-app |
The authenticated product your customers log into |
apps/admin-panel |
Internal operation: users, plans, blog posts, payment providers |
backend/api |
.NET API shared by both authenticated apps |
Before you commit
npm run validate-config checks the configuration files against their schemas, and
npm run qa:fast runs the guard suite the CI pipeline also runs. Both are fast enough to
run on every change.