Skip to content

brettjohnson.xyz Docs

Engineering blueprint, architecture, and operational runbooks for the Brett Johnson brand platform.

What’s in here

Architecture

Frontend, backend, infrastructure, and database design for the full platform. Explore →

Governance

Branching strategy, versioning policy, and the end-to-end release process. Explore →

Product

User personas, user flows, and feature flag management. Explore →

Runbooks

Step-by-step deployment procedures and incident response playbooks. Explore →

Env Registry

Every environment variable documented — names, descriptions, and per-environment matrix. Explore →

Roadmap

Milestone tracker: M1 through M8, task-by-task progress toward v1.0.0-mvp. Explore →

Tech Stack at a Glance

LayerTechnology
FrameworkNext.js 15 (App Router)
StylingTailwind CSS + Framer Motion
CMSContentful (headless)
HostingVercel (edge)
CDN / SecurityCloudflare WAF + R2
DatabaseSupabase (PostgreSQL)
EmailResend + React Email
CRMHubSpot
AnalyticsPlausible (privacy-first)
DocsAstro Starlight (this site)

Project Status

Current version: v0.1.0-dev — pre-launch development

Live tracker: api.brettjohnson.xyz/api/status