Applications

The Sustentus monorepo contains six applications. The platform itself is apps/web; the others are the marketing site, role-based dashboards, two Nextra doc sites, and Storybook.

Overview

Application details

Web (apps/web)

The main platform — Next.js 16 with the App Router and Turbopack. Hosts the portals for all six personas (admin, CSM, SDM, expert, vendor, customer), the server surface (route handlers + Server Actions), and the runtime AI (the BRD agent via @sustentus/services/ai). Imports UI from @sustentus/ui and data/logic from @sustentus/services/server. See [apps/web/AGENTS.md] in the repo for app-specific rules.

Dashboards (apps/dashboards)

Next.js 16 role-based dashboards (port 3005). Self-contained — it does not import @sustentus/ui; UI primitives live locally in components/ui/, and all text uses the local Typography component. Charts use Recharts.

Marketing (apps/marketing)

Next.js 15 public site (port 3001) — landing, pricing, and waitlist signup with Clerk auth. Imports UI from @sustentus/ui. Learn more →

Documentation (apps/docs)

This Nextra site — MDX content under app/business/ (direction, strategy, roles, journey) and app/technical/ (architecture, applications, packages, development). Built-in Pagefind search. Learn more →

Help (apps/help)

Nextra help & support centre for end users.

Storybook (apps/storybook)

Storybook 10 (port 3002) documenting every component exported from @sustentus/ui — one Default story per component, props exposed via Controls. Learn more →

Running applications

pnpm dev                # all apps
pnpm web:dev            # main platform (3000)
pnpm dashboards:dev     # dashboards   (3005)
pnpm marketing:dev      # marketing    (3001)
pnpm storybook:dev      # storybook    (3002)

Building

pnpm build              # all apps and packages

Turborepo builds the shared packages (@sustentus/ui, @sustentus/services) before the apps that depend on them.