About this project
Unified Social Intelligence Platform – HK-First MVP (v1.0)
Project Name
SocialListen.hk – Real-time social listening dashboard for Hong Kong brands
Tech Stack (Auto-Detect & Use)
Frontend: React + Tailwind CSS + ShadCN UI (dark mode default)
Backend: Supabase (PostgreSQL + Auth + Realtime)
Auth: Firebase Auth (Google, Apple, Email)
APIs: X API (Basic), Meta Graph API, TikTok Research API, YouTube Data API v3, Reddit Data API, Pinterest v5 API
AI: Hugging Face Inference (sentiment), Google Gemini (summaries/forecasts)
Glue: Zapier (free tier connectors)
Hosting: Vercel (auto-deploy)
Domain: listen.hk (placeholder, add config)
Core User Journey (Build in Order)
1. Landing + Onboarding (2 mins)
Clean hero: “Listen to Hong Kong conversations in real time”
CTA: “Start Free Trial” → Modal with Google/Apple/Email login
Post-login: AI prompt → “Tell me your brand in 1 sentence” → extract keywords (e.g., “Hong Kong skincare”)
One-click OAuth buttons: X, Instagram, TikTok, YouTube, Reddit, Pinterest
Auto-save to Supabase user_profiles + connected_platforms
2. Dashboard – Real-Time Pulse
Layout: Responsive grid (mobile-first, <2s load)
Live Mention Feed (infinite scroll, realtime via Supabase)
Columns: Platform icon | Text | Sentiment badge (Positive/Neutral/Negative) | Time ago | Source link
Sentiment Meter (circular progress, color-coded)
Top 5 Keywords (tag cloud, clickable → filter feed)
Crisis Alert Banner (red, dismissible): “12 negative mentions in 1h”
Platform Breakdown (pie chart, Recharts)
AI Tip Card: “You’re trending on TikTok — consider a reply?”
3. Query Builder (Natural Language → API)
Input: “XX cream OR 面霜 lang:zh near:"Hong Kong"”
AI converts → API calls via Zapier → results in feed
Button: “Save as Topic” → stored in topics table, auto-monitor daily
4. Unified Engagement Inbox
Tabs: All | Unread | Negative | Assigned to Me
Each item: Platform | Message | AI Reply Suggestions (2 options, EN/ZH toggle)
Actions: Reply (opens modal → post via Zapier) | Assign (@user) | Snooze
Audit log in Supabase
5. Weekly Insights Report
Auto-generated every Monday 9 AM HKT
PDF: Brand health, competitor SOV, trend forecast, export buttons
Email via Resend (free tier)
6. Collaboration & Settings
Team roles: Admin, Editor, Viewer
Approval flow: Draft → @legal → Approve → Post
Settings: Data retention (30 days), Delete All Data, Re-auth APIs, Upgrade ($29/mo placeholder)
Data Model (Supabase)
users (id, email, name, locale: en/zh)
connected_platforms (user_id, platform, access_token, expires_at)
mentions (id, platform, text, sentiment, url, timestamp, topic_id)
topics (id, user_id, query, name, last_run)
reports (id, user_id, pdf_url, sent_at)