Trystpilot Documentation

Trystpilot Documentation

Anonymous Romantic Relationship Reviews — developer and contributor reference.

---

Site Boundaries

• Docs Site (docs.trystpilot.xyz): operational runbooks, implementation guides, changelog, security/devops documentation.
• Design Site (design.trystpilot.xyz): architecture diagrams, UI/UX flows, component system references, governance visuals.

For separation details, see DOCS_DESIGN_SEPARATION_PLAN.md.

---

Contents

Document	Description
CHANGELOG	Version history and release notes
PRODUCTION_VERSION_GAP_REPORT_2026-04-06	Production version vs documented changes gap analysis
DOCS_DESIGN_SEPARATION_PLAN	Ownership and flow between docs site and design site
EXECUTION_THREADS_2026-04-06	Prioritized top 3 workstreams, blockers, and parallel directives
ARCHITECTURE	System architecture — frontend, backend, DB, auth, caching, observability
DEVOPS	DevOps governance — branching, CI/CD, secrets, migrations, monitoring
SECURITY	Risk, liability, compliance — pre-launch gates, PII, CCPA/GDPR, incident response
SEO Strategy	SEO keyword research, content calendar, backlink strategy, technical checklist
README	Project overview and quick-start
ROADMAP	Phased build-out plan, milestones, monetization

Design Site Index (design.trystpilot.xyz)

Design Asset	Link
Architecture overview	https://design.trystpilot.xyz/architecture/backend
UI/UX user flows	https://design.trystpilot.xyz/product/user-flows
Roles and permissions	https://design.trystpilot.xyz/product/roles-permissions
Monetization strategy maps	https://design.trystpilot.xyz/product/monetization
Governance + moderation diagrams	https://design.trystpilot.xyz/governance/moderation
CI/CD design maps	https://design.trystpilot.xyz/devops/cicd

---

Architecture Overview

trystpilot/
├── app/              # Next.js App Router pages and API routes
├── components/       # Shared React components
├── lib/              # Server-side utilities (db, moderation, reputation)
├── middleware.ts     # Edge middleware (rate limiting, moderation)
├── public/           # Static assets
├── docs/             # Operational and engineering docs
└── design/           # Design-system, architecture, and UX assets