index

Flow — Knowledge Base

Central documentation vault for the Flow event discovery platform.

Architecture note (2026-03-29): All backend runs on Supabase-only — Postgres + RLS + Edge Functions + Realtime + Storage. The legacy Node.js / MongoDB / Redis services in the old backend/ repo are archived and not in use. See Supabase Migration Design.

---

Repositories

Repo	Stack
flow-platform	Next.js · Supabase (Postgres, RLS, Edge Functions, Realtime)
flow-mobile	Flutter (iOS, Android) · Riverpod · Supabase Flutter SDK
flow-docs	This vault

---

Map of Content

🚀 Getting Started

• Overview
• Local Setup
• Environment Variables

🏗️ Architecture

• Overview
• Technical Architecture
• Services
• Improvements
• Architecture Issues

🖥️ Backend

• API Reference
• API Documentation
• Database Schema
• Database Audit (2026-03-24)

📱 Mobile

• Setup
• UX Polish Audit (2026-04-20)
• Localization

Auth

• Registration Wizard V2

Events

• Event Details V2
• Live Discovery

Social

• Crew Chat
• Friend Request Flow

Infrastructure

• Unified Error Handling
• Global Observability
• Crash Reporting

UI / Design System

• UI Redesign Pass 1
• UI Redesign Pass 2
• UI Redesign Pass 3
• Theme Tokens Refactor
• Feed Widgets Design System

🌐 Web

• Overview (if present)

🗺️ Roadmap

• Pre-v1 Plans Index
• Supabase Migration Design
• Global Restyling Design

⚠️ Issues (Infra)

• 1 — Event Bus
• Socket.IO
• 5 — AI Read Replica
• 9 — Contract & E2E Testing

📋 Project

• Brand Identity
• Roadmap
• Open Questions
• Feature Tracker
• Gamification Design

🤝 Contributing

• Branch Strategy
• Commit Conventions

🚀 Deployment

• Deployment Guide

🔧 Development

• Development Guide

---

Vault managed as an Obsidian wiki. See CLAUDE.md for writing conventions.