Flowo - AI Social Media Manager SaaS

Flowo is a complete production-ready AI-powered social media management SaaS. Launch your own social media tool and start charging subscription fees immediately. Built with Next.js 14, Supabase, OpenAI GPT-4o, and Stripe.

The app runs in demo mode out of the box with zero API keys required. Flip a single environment variable to activate each real integration. No code changes ever needed to go from development to production.

Every feature is built and working — AI content generation, auto-publishing cron jobs, OAuth connections to 6 social platforms, Stripe subscription billing with webhooks, team collaboration with role-based permissions, a 14-day trial system with middleware-level access gates, and a full admin health dashboard.

Features

• AI Content Generation — GPT-4o generates captions, hashtags and post ideas tuned to each brand voice
• Auto-Publish Scheduler — Supabase Edge Function cron runs every minute and auto-publishes scheduled posts
• 6 Platform OAuth — Full OAuth2 + PKCE for Instagram, LinkedIn, Twitter, Facebook, TikTok, Pinterest
• Simulated OAuth Dev Mode — Connect any platform instantly without API keys during development
• Multi-Brand Management — Manage multiple brands with global brand switcher and per-brand voice training
• Team Collaboration — Invite members with Admin, Editor or Viewer roles and per-permission control
• Stripe Subscription Billing — 3 plans, monthly and annual pricing, customer portal, webhook automation
• 14-Day Trial System — Middleware-level trial gate, dashboard locks after trial expires
• Analytics Sync — Cron fetches real engagement data every 6 hours from all connected platforms
• AI Weekly Insights — Weekly cron generates personalized GPT-4o performance insights per user
• AI Image Generation — DALL-E 3 image generator with usage tracking and post integration
• Comments Manager — View and reply to comments across platforms with AI-suggested replies
• Trends Page — Real trending topics via Tavily API with save-to-post flow
• Public REST API — Agency plan includes full public API with key management and rate limiting
• Admin Health Dashboard — Live status of all APIs, tables, cron jobs, and feature flags
• AES-256-GCM Token Encryption — All OAuth tokens encrypted before storing
• Mobile Responsive — Full responsive dashboard with hamburger menu and scroll tables
• Feature Flag Architecture — Demo mode to production with zero code changes, only env vars
• Complete Documentation — README, SUPABASE_SETUP, STRIPE_SETUP, API_CONNECT guides included

Built-in Plans:

• Starter $49/mo — 1 brand, 3 platforms, 100 posts/month
• Pro $99/mo — 3 brands, 6 platforms, 500 posts/month, team members, advanced analytics
• Agency $199/mo — Unlimited everything, public API, white label

Tech Stack: Next.js 14 App Router, TypeScript, Tailwind CSS, Supabase (PostgreSQL + Auth + Edge Functions), OpenAI GPT-4o, Stripe, Resend, Zustand, Recharts, Lucide React

Requirements

• Node.js 18 or higher
• Supabase account (free tier works for development and testing)
• Vercel account for deployment (free tier works)
• OpenAI API key (optional — app runs in demo mode without it)
• Stripe account (optional — billing works in demo mode without it)
• Social platform developer apps (optional — simulated OAuth works without real keys)

Instructions

Quick Start (5 minutes):

1. Unzip the downloaded file
2. Run npm install
3. Copy .env.example to .env.local
4. Add your Supabase URL and keys from supabase.com (free account)
5. Run the SQL from SUPABASE_SETUP.md in the Supabase SQL editor
6. Run npm run dev and open http://localhost:3000

The app runs fully in demo mode without any paid API keys. Add keys one by one to activate real features:

• Add OPENAI_API_KEY and set NEXT_PUBLIC_AI_ENABLED=true for real AI
• Add Stripe keys and set NEXT_PUBLIC_STRIPE_ENABLED=true for real billing
• Add social platform keys and set platform flags to true for real OAuth

Full step-by-step guides are included in:

• README.md — Project overview and quick start
• SUPABASE_SETUP.md — All SQL, tables, Edge Functions, cron jobs
• STRIPE_SETUP.md — Stripe products, webhooks, go-live checklist
• API_CONNECT.md — Social platform OAuth app creation guides