Nexus platform docs
Internal documentation for Nexus — the Turborepo monorepo powering the Innerlight platform. Use the search (top of the sidebar) to find anything; the sections below are the curated entry points.
- Concepts — how the platform is put together (architecture, auth, billing, environments).
- Flows — diagrammed user/data flows (booking, onboarding, billing, provisioning, convergence, wipe, notifications).
- Runbooks — operational procedures, indexed from the canonical files in the repo.
- Reference — auto-generated API reference (scheduler OpenAPI) and the Vendure GraphQL surface.
- Glossary — domain terms (tenant vs business vs org, stoken, contract-drift, …).
| App | Description | Port |
|---|---|---|
site-main |
Main marketing site (TanStack Start) | 3000 |
site-shop |
E-commerce storefront (TanStack Start) | 3010 |
site-hypno |
Tenant site — booking + storefront reference (TanStack Start) | 3020 |
portal |
Innerlight admin portal (TanStack Start) | 3030 |
portal-business |
Business owner portal — Vite/React SPA + Fastify BFF | 3040 |
portal-business-web |
Caddy static front serving the portal-business SPA (Railway) |
- |
scheduler-api |
Scheduling/booking API (Fastify + tRPC + Temporal) | 4000 |
scheduler-worker |
Scheduler background jobs (BullMQ) | - |
vendure-server |
Vendure headless commerce API | 3001 |
vendure-worker |
Vendure background job worker | - |
directus |
Directus headless CMS | 8055 |
Packages
Section titled “Packages”| Package | Description |
|---|---|
@nexus/ui |
Shared UI components (shadcn/Radix + Tailwind) |
@nexus/vendure-sdk |
Vendure GraphQL client + React Query hooks |
@nexus/directus-sdk |
Directus SDK client + React Query hooks |
@nexus/scheduler-contracts |
Zod source-of-truth for the scheduler public API (drift = 500) |
@nexus/scheduler-sdk |
Typed client for the public API (z.infer from contracts) |
@nexus/scheduler-client |
tRPC client for the scheduler admin surface (used by portal) |
@nexus/scheduler-platform-client |
Scheduler client for platform/server contexts (e2e + internal) |
@nexus/business-client |
Customer-facing booking / accounts / notifications hooks |
@nexus/auth-client |
Shared WorkOS AuthKit primitives |
@nexus/workos-auth |
WorkOS auth helpers (server gates / roles) |
@nexus/platform-events |
Typed platform event definitions (BullMQ) |
@nexus/registrar |
Domain registrar integration (Porkbun) |
@nexus/shared-types |
Shared TypeScript types |
This site is built with Astro Starlight and
lives at apps/docs. See apps/docs/README.md for how to run and deploy it.