FLOWT — AI-powered multi-platform social publishing

Create once → Understand the source → Generate → Customize per platform → Review → Publish or schedule → Track results.

FLOWT is a SaaS workspace where creators, student communities, founders, freelancers, marketing teams and agencies can turn an idea or an uploaded document (certificate, internship letter, event poster, competition result, project summary…) into accurate, natural posts, then adapt, preview, publish and schedule them to 15 platforms (LinkedIn, Instagram, X, Facebook Pages, Threads, YouTube, TikTok, Pinterest, Reddit, Bluesky, Mastodon, Telegram, Discord, WordPress and any custom website) through official APIs. Every comment and mention then lands in one inbox, where you reply by hand or let Autopilot answer in your voice.

It is built as a real product, not a UI demo: PostgreSQL persistence, server-side sessions, encrypted OAuth credentials, Groq + Gemini AI adapters, document extraction with human review, a durable Redis/BullMQ publishing engine with idempotency and partial-success handling, honest analytics, quotas, audit logs and deployment docs.

---

Table of contents

1. Feature overview
2. Architecture
3. Tech stack
4. Repository layout
5. Quick start (local development)
6. Environment variables
7. Scripts
8. Platform setup (LinkedIn, Instagram, X)
9. AI providers (Groq, Gemini)
10. Publishing engine guarantees
11. Security & privacy
12. Testing
13. Deployment
14. Build stages & status
15. Known limitations

Detailed docs live in docs/, including Engagement: Stage 0 audit · Platform API notes · Architecture · Setup · Platforms · Deployment · Security · API · Release checklist

---

Feature overview

The app sidebar is organised around the work: Create (Dashboard, Create post, Apps ▾ with one page per connected app), Engage (Inbox with Comments + Autopilot), Publish (Calendar, Queue, History, Analytics) and Workspace (Accounts, Brand voice, Settings, Help).

This is the beginning of the README. Read the rest at the original. Read the full README ↗