slotted-ai

An AI-powered scheduling app that syncs with Google, Apple, and Outlook calendars to help busy young professionals actually see their friends.

Architecture

client/          React + TypeScript + Vite (Tailwind CSS)
functions/       Firebase Cloud Functions (Express API, TypeScript)
database/        Supabase PostgreSQL schema
docs/            Product & planning documents
build/           Firebase Hosting output (generated by Vite)

Tech Stack

Layer	Technology
Frontend	React 19, TypeScript, Tailwind CSS
Hosting	Firebase Hosting (SPA)
Backend	Firebase Cloud Functions (Express)
Database	Supabase PostgreSQL
Auth	Firebase Auth (Google OAuth)
Calendar	Google Calendar API (webhooks)

Getting Started

Prerequisites

• Node.js 20+
• Firebase CLI (npm install -g firebase-tools)
• Firebase project (slotted-ai) with Blaze plan

1. Client setup

cd client
cp .env.example .env          # fill in your Firebase config values
npm install
npm run dev                   # → http://localhost:5173

2. Cloud Functions (local)

cd functions
npm install
npm run build
firebase emulators:start --only functions

3. Database

1. Create a Supabase project
2. Run database/schema.sql in the Supabase SQL Editor
3. Copy the Supabase URL + anon key into your functions config

4. Deploy

# Build the client (outputs to /build)
cd client && npm run build

# Deploy everything
firebase deploy

Key Concepts

• Social Battery — 🟢 Open / 🟡 Ask Me / 🔴 Recharging — lets friends know your social energy level
• Travel Buffers — configurable padding around meetups so you're not rushing
• AI Scoring — rule-based engine (Phase A) that learns your preferences over time, with ML upgrade path (Phase B)

Project Documents

#	Document
01	Onboarding Survey Questions
02	Vibecoding Development Plan
03	PRD — MVP v1.1
04	Backlog — V2/V3
05	User Research Interview Guide
06	AI Scheduling Architecture
07	App Name Options

---

📅 Fund my next friend date