SocialListen HK

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)