Documentation

The platform, fully accounted for

Generated from the same registry that powers the live self-check — pages, actions and workflows can't drift from these docs because they ARE these docs.

Architecture in one paragraph

Supreme Suite is one engine + 13 system packs. A pack is pure configuration (pipeline stages, fields, KPIs, website copy, seed data) — the engine renders whatever the active pack declares: dashboard, kanban records, calendar, bookings inbox, customers, messages, inventory, invoices, loyalty, reports, AI chatbot, voice agent, website manager and settings. Branding is runtime CSS variables (--brand*) applied by BrandProvider, so a tenant's logo/colors re-skin the app, website, chat widget, favicon and installed PWA icon instantly. Trials run 100% client-side (localStorage repo with a table-shaped API); production swaps that one file for Supabase. Every mutation flows through lib/ops.ts — the same functions the /status portal executes to prove the platform works.

29 registered pages

Every page & link

Catalog

PathPageHealth markersTry it
/Home"Supreme Suite", "free trial"open
/systemsSystems catalog"Pick your industry"open
/systems/:slugSystem detail"3-day free trial"open
/pricingPricing"Simple pricing"open
/faqFAQ"Questions"open
/contactContact / custom builds"custom"open
/startOnboarding wizard"Launch your workspace"open

Platform

PathPageHealth markersTry it
/statusSelf-check portal"System check"open
/docsDocumentation"Documentation"open

Auth

PathPageHealth markersTry it
/app/loginTenant login"Sign in", "Supreme Suite"open

App

PathPageHealth markersTry it
/app/:tenantDashboard"Dashboard"open
/app/:tenant/recordsRecords & pipeline"Pipeline"open
/app/:tenant/calendarCalendar"Calendar"open
/app/:tenant/bookingsBookings inbox"Bookings"open
/app/:tenant/customersCustomers"Customers"open
/app/:tenant/messagesMessages"Messages"open
/app/:tenant/inventoryInventory"Inventory"open
/app/:tenant/invoicesInvoices"Invoices"open
/app/:tenant/loyaltyLoyalty"Loyalty"open
/app/:tenant/reportsReports"Reports"open
/app/:tenant/chatbotAI chatbot"Chatbot"open
/app/:tenant/voiceAI voice agent"Voice"open
/app/:tenant/websiteWebsite manager"Website"open
/app/:tenant/settingsSettings & branding"Settings"open
/app/:tenant/continuePlans / continue after trial"Continue"open

Site

PathPageHealth markersTry it
/site/:tenantTenant public website"Powered by"open

API

PathPageHealth markersTry it
/api/healthHealth JSON (+CORS, ?deep=1)""ok""open
/api/registryRoutes/actions registry JSON""routes""open
/api/manifest/:tenantPer-tenant PWA manifest""start_url""open

24 action contracts

Every action & its promise

Each interactive feature declares a contract. The /status portal executes them; this table documents them.

Onboarding

Create workspace from wizard tenant-create

Completing /start creates a tenant with brand config, seeds demo data, starts the 3-day trial and lands on the dashboard.

Branding

Apply brand color/logo/style brand-apply

Saving brand settings updates CSS variables (--brand*) and the logo everywhere (app shell, site, widget) without reload.

Upload company logo logo-upload

An uploaded image persists as a data URL and renders in the app sidebar, public site nav and browser favicon.

Records

Create record record-create

New record appears in table and pipeline with auto reference, default stage, and updated KPI counts.

Move record across pipeline record-stage

Dragging (or arrow controls) updates status, column totals and dashboard funnel instantly.

Edit/delete record record-edit

Field edits persist; delete removes from all views.

Bookings

Public site booking → inbox booking-submit

Submitting the website booking form creates a 'new' booking visible in the app inbox with all form fields.

Convert booking booking-convert

Convert creates a record (and customer if new), marks booking converted, links the customer.

Customers

Add/edit customer customer-create

Customer persists with tags; profile shows linked records, invoices, messages and loyalty points.

Messages

Send message / template message-send

Outbound message appends to the thread with channel + timestamp; unread counts update.

Invoices

Build invoice invoice-create

Line items auto-total; invoice persists with status; mark-paid updates revenue KPIs.

Print/PDF invoice invoice-print

Print view renders a branded invoice via the browser print dialog.

Inventory

Adjust stock inventory-adjust

Qty steppers persist; low-stock badge appears when qty ≤ reorder point.

Loyalty

Add/redeem points loyalty-points

Point changes persist on the customer and move tier progress; punch card fills visually.

Calendar

Add calendar event calendar-add

Event appears on the month grid and upcoming list.

Reports

Export CSV report-export

Export downloads a CSV containing current records with headers.

AI

Chatbot answers & books chatbot-reply

Widget answers price/hours intents and completes a slot-filled booking that lands in the inbox.

Voice agent conversation voice-call

Mic captures speech (where supported), agent replies aloud and logs the call to Messages; text fallback always works.

Website

Edit website content site-edit

Hero/services edits save and the public site reflects them on reload of the preview.

Platform

Install desktop app pwa-install

Install button triggers the browser PWA prompt (per-tenant name/color via dynamic manifest); hides when already installed.

Deterministic demo seeding demo-seed

demo-* workspaces self-create with stable, realistic data per system.

Billing

3-day trial gate trial-gate

Trial countdown shows in shell; after expiry the app locks behind /continue where choosing a plan unlocks (sandbox checkout).

Data

Export/import workspace data-export

JSON export downloads the full workspace; import restores it (data freedom).

Catalog

Contact / custom CRM request lead-capture

Contact form persists a platform lead and shows confirmation.

7 verified workflows

End-to-end journeys

Launch a branded workspace checked live

  1. Pick a system in the catalog
  2. Enter business name + contact
  3. Upload logo, choose colors & style
  4. Workspace created, seeded, trial starts
  5. Dashboard renders with brand applied

Lead → booking → job → invoice → paid checked live

  1. Visitor books on the public site
  2. Booking appears in inbox
  3. Convert to record + customer
  4. Advance through pipeline to done
  5. Invoice raised and marked paid
  6. Revenue KPI updates

AI front desk captures a booking checked live

  1. Customer chats with the widget
  2. Bot answers prices/hours
  3. Bot slot-fills name → phone → service → date
  4. Confirmed booking lands in inbox

Repeat-customer loyalty loop checked live

  1. Customer completes a job
  2. Points added on profile
  3. Punch card fills toward reward
  4. Outbound message sent from template

Make it feel like mine checked live

  1. Change brand color → whole app re-skins live
  2. Upload logo → shell, site & favicon update
  3. Edit website hero/services → public site updates
  4. Install as desktop app

Trial → paid continuation checked live

  1. Trial banner counts down 3 days
  2. On expiry the workspace locks
  3. Choose a plan on /continue
  4. Sandbox checkout unlocks the workspace

Data in / data out checked live

  1. Export workspace JSON
  2. Export records CSV
  3. Import restores a workspace

13 system packs

The catalog, technically

SystemSlugCategoryPipeline stagesModulesDemo
Courier & Delivery CRMcourieroperationsRequested → Pickup scheduled → In transit → Out for delivery → Delivered → Failed / returned14/app/demo-courier
Movers & Storage CRMmoversoperationsQuote requested → Survey → Quoted → Scheduled → In progress → Completed → In storage15/app/demo-movers
Warehouse & Inventory (WMS)warehouseoperationsReceived → Picking → Packing → Ready to ship → Shipped → Returned13/app/demo-warehouse
Property Management CRMpropertyoperationsReported → Triaged → Vendor assigned → In repair → Resolved → Closed13/app/demo-property
Restaurant & ReservationsrestaurantoperationsPlaced → Preparing → Ready → Served → Delivered → Cancelled15/app/demo-restaurant
Beauty & Salon Booking CRMsalonbookingRequested → Deposit paid → Confirmed → Done & gorgeous → No-show14/app/demo-salon
Universal Appointment CRMappointmentsbookingRequested → Confirmed → Reminded → Completed → No-show → Cancelled14/app/demo-appointments
Tours & Experiences CRMtoursbookingInquiry → Quoted → Deposit paid → Confirmed → Completed → Cancelled14/app/demo-tours
School & Academy ManagementschooleducationApplied → Assessed → Enrolled → Active → Graduated → Withdrawn12/app/demo-school
Loyalty & Rewards PlatformloyaltygrowthReward earned → Member notified → Redeemed → Expired10/app/demo-loyalty
Analytics DashboardsdashboardsintelligenceDraft → Data connected → In review → Published → Archived9/app/demo-dashboards
AI Chatbot BuilderchatbotintelligenceOpen → Handled by bot → Handed to human → Resolved → Missed10/app/demo-chatbot
AI Voice AgentvoiceintelligenceIncoming → Agent answered → Booked / handled → Message taken → Missed11/app/demo-voice

Deeper docs live in the repo: DOCS/ARCHITECTURE.md · DOCS/GO-LIVE.md · DOCS/HEALTH-REPORT.md (generated by npm run smoke)