overview

Getting Started — Overview

Flow is an AI-powered event discovery platform that helps people find local events matching their interests and social graph.

Repositories

Repo	Description
flow-platform	Admin portal Next.js 16 + Supabase code (migrations, Edge Functions)
flow-mobile	Flutter app — iOS + Android
flow-docs	This Obsidian vault (published via Quartz)

System Overview

┌─────────────────────────┐   ┌─────────────────────────────┐
│  Mobile App (Flutter)   │   │  Admin Portal (Next.js 16)  │
│  iOS + Android          │   │                             │
└────────────┬────────────┘   └──────────────┬──────────────┘
             │                               │
             └───────────────┬───────────────┘
                             │
                    ┌────────▼────────┐
                    │    Supabase     │
                    │  (single backend│
                    └────────┬────────┘
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                    │
┌───────▼────────┐  ┌────────▼────────┐  ┌────────▼────────┐
│  PostgreSQL    │  │  Edge Functions │  │    Realtime     │
│  + RLS         │  │  (Deno/TS)      │  │  + Storage      │
│  + PostGIS     │  │                 │  │                 │
│  + pg_trgm     │  │  7 functions    │  │  Push via FCM   │
└────────────────┘  └─────────────────┘  └─────────────────┘

One backend, three core technologies: Postgres, Edge Functions, Realtime. Clients talk directly to Supabase — no intermediate gateway, no custom microservices.

See: Architecture Overview

Next Steps

1. Local setup — .env file, web dev server, Flutter app startup → Local Setup
2. Explore the schema — Postgres tables + RLS policies → Database Schema
3. Understand the brand — vision, palette, mark, voice → brand-identity