Matters AI Documentation

Welcome to the single source of truth for the Matters AI engineering organisation. This site documents everything about the website (matters.ai), the internal workspace (workspace.matters.ai), the shared monorepo packages, and the operational practices that hold them together.

What lives here#

Section	What you'll find
Introduction	A 10-minute walkthrough of the system: what we ship, where it runs, and how the apps fit together.
Monorepo	The pnpm + Turborepo workspace layout, package boundaries, and the slice-by-slice migration history that got us here.
Public Website	matters.ai — pages, content pipeline (WordPress), lead capture, SEO, redirects.
Workspace App	workspace.matters.ai — auth model, RBAC, module-by-module reference (analytics, careers, content studio, …), CRUD patterns.
API Reference	Every workspace + webhook endpoint with parameters, permissions, and error responses.
Operations	Environment variables, Vercel deployment, observability, runbooks.
Security	The authorization model, secrets handling, audit logging, vulnerability response.
Contributing	Code style, PR process, branching, review expectations.

Quick links#

New here? Start at Getting Started.
Looking for the deploy checklist? Operations → Deployment.
Wondering who can do what? Workspace → RBAC.
Bug, question, or doc gap? File an issue or open a PR — instructions in Contributing → Pull Requests.

House rules#

This site is the source of truth. If a README, Slack message, or tribal-knowledge fact conflicts with what's here, fix the docs (or the code) — never let two stories coexist.
No copy-paste. If something is documented in two places, one is a stale lie waiting to happen. Link from the second to the first.
Examples are runnable. Every code block in here should compile or execute as-is.
Diagrams reflect reality. When you change the architecture, update the diagram in the same PR.

Loading…

What lives here#

Section	What you'll find
Introduction	A 10-minute walkthrough of the system: what we ship, where it runs, and how the apps fit together.
Monorepo	The pnpm + Turborepo workspace layout, package boundaries, and the slice-by-slice migration history that got us here.
Public Website	matters.ai — pages, content pipeline (WordPress), lead capture, SEO, redirects.
Workspace App	workspace.matters.ai — auth model, RBAC, module-by-module reference (analytics, careers, content studio, …), CRUD patterns.
API Reference	Every workspace + webhook endpoint with parameters, permissions, and error responses.
Operations	Environment variables, Vercel deployment, observability, runbooks.
Security	The authorization model, secrets handling, audit logging, vulnerability response.
Contributing	Code style, PR process, branching, review expectations.

House rules#

This site is the source of truth. If a README, Slack message, or tribal-knowledge fact conflicts with what's here, fix the docs (or the code) — never let two stories coexist.

No copy-paste. If something is documented in two places, one is a stale lie waiting to happen. Link from the second to the first.

Examples are runnable. Every code block in here should compile or execute as-is.

Diagrams reflect reality. When you change the architecture, update the diagram in the same PR.