Chem IRL - Dating App
App-first dating platform that optimizes time-to-date
Quick Start
Mobile App
cd mobile
bun install
# Create .env file with Supabase credentials (see mobile/.env.example)
bun start
Website
cd web
bun install
bun run build
What is Chem IRL?
Chem IRL is a dating app designed to get people meeting face-to-face faster by eliminating endless texting. The core mechanic requires users to propose exactly 2-3 specific times within 7 days, with proposals expiring after 72 hours.
Key Features
- OTP Code Authentication - Passwordless email OTP login
- Discovery Feed - Swipe-based matching with scoring
- Structured Proposals - 2-3 time windows within 7 days
- 72-Hour Expiry - Proposals expire automatically
- Real-time Chat - Unlocked after confirmation
- Scoring System - Action Speed, Profile Quality, Reliability
Architecture
- Mobile App: React Native (Expo SDK 54) with direct Supabase connection
- Website: Static Next.js site (marketing only)
- Backend: Supabase (Postgres + Auth + RLS + Realtime + Storage + Edge Functions)
Documentation
Project Structure
chem-irl/
├── mobile/ # React Native app (primary product)
├── web/ # Static marketing site (Vercel)
├── supabase/ # Migrations (source of truth), edge functions, config
├── db/ # Reference SQL files (schema, RLS, RPCs, scoring)
├── docs/ # Product, architecture, and implementation docs
├── agent_docs/ # Task-specific agent instructions
└── scripts/ # Root-level utility scripts
Tech Stack
Mobile
- React Native (Expo SDK 54)
- TypeScript
- React Navigation v7
- Supabase Client
Website
- Next.js 16 (Static Export)
- TypeScript
- Tailwind CSS
Backend
- Supabase (PostgreSQL + Auth + RLS + Realtime + Storage)
- Edge Functions (push, IAP validation, Iris AI concierge, photo moderation, waitlist + support)
- pg_cron (scheduled scoring)
Quality Gates
# Mobile (run from mobile/)
bun run lint -- --max-warnings 0 # ESLint
bun run type-check # TypeScript strict
bun run test:unit # Unit tests
bun run format:check # Prettier
# Documentation links
bun run docs:check
Deployment
Mobile App
- Build with EAS Build
- Submit to App Store / Play Store
Website
- Deploy to Vercel (static export)
Contributing
See CONTRIBUTING.md for the development workflow — worktree-first git, quality gates, and where the docs live. CLAUDE.md is the detailed source of truth.
License
Private - All rights reserved
Status: Beta build-out — Dublin launch prep
Last Updated: 2026-07-09
