What is OutreachOS?

OutreachOS is a B2B lead management platform for cold outreach. ChatGPT agents collect business data from Google Maps and submit it through a secure API. The system deduplicates leads, stores them in Supabase, and provides a real-time dashboard for filtering, searching, and CSV export.

Stack: Next.js 16 · React 19 · Supabase PostgreSQL · Tailwind CSS · shadcn/ui · Vercel

Development Timeline

Phase 0 — Foundation ✅
Bootstrapped the Next.js project, testing toolchain (Jest + Playwright), Cursor rules, and phase-based workflow.
Phase 1 — Database & Agent API ✅
Built the leads schema with maps_url deduplication, pg_trgm fuzzy search, and the first /api/agent/leads endpoint with X-Agent-Secret auth.
Phase 2 — Dashboard UI ✅
Shipped the dashboard: filter toolbar, prospect matrix table, metrics panel, pagination, and Stitch-aligned design components.
Phase 3 — Data Management✅
Connected the UI to live data — debounced search, multi-filter state, CSV export, URL-synced filters. Hit 85%+ test coverage.
Phase 4 — API Integration & ChatGPT Setup ✅
Multi-strategy auth (agent secret + Bearer API keys)
Tiered rate limiting, structured logging, Prometheus metrics
/api/health and /api/metrics endpoints
OpenAPI spec + ChatGPT Custom GPT documentation
190 tests passing · repo published publicly on GitHub
Links:-
Repo: https://github.com/its-techxtreme/OutreachOS
README: https://github.com/its-techxtreme/OutreachOS/blob/develop/README.md
Devlog file: https://github.com/its-techxtreme/OutreachOS/blob/develop/docs/DEVLOG.md