Nexus AI - Social Media Automation SaaS

Nexus AI is a full-stack Social Media Automation platform powered by AI. It helps creators and marketers generate content, schedule posts, analyze performance, and collaborate with specialized AI agents.

Features

• AI Content Generator: Instantly generate post ideas, engaging captions, and trending hashtags using Google's Gemini 2.5 Flash model.
• AI Agents: Chat with specialized AI personas (Content Creator, Marketing Strategist, Growth Analyst) to brainstorm and delegate tasks.
• Content Planner: A visual calendar to schedule and manage your social media posts.
• Analytics Engine: Track engagement and follower growth with interactive charts, and get AI-generated actionable insights.
• Social Media Integration: Connect your LinkedIn, Twitter/X, Instagram, and TikTok accounts securely via OAuth.
• Automated Publishing: A background scheduler automatically publishes your posts at the scheduled time.
• Secure Authentication: User accounts and data are secured using Firebase Authentication and Firestore Security Rules.

Tech Stack

• Frontend: React 18, Vite, Tailwind CSS, React Router, Recharts, Lucide React, React Markdown.
• Backend: Node.js, Express, Google GenAI SDK (@google/genai), Node-Cron.
• Database & Auth: Firebase (Firestore, Firebase Auth).
• Language: TypeScript across the entire stack.

Getting Started

1. Install dependencies:

   npm install

2. Set up environment variables: Create a .env file based on .env.example and add your GEMINI_API_KEY.

3. Set up Firebase: Ensure you have a firebase-applet-config.json file with your Firebase project configuration.

4. Run the development server:

   npm run dev

5. Build for production:

   npm run build

Project Structure

• /src: Frontend React application code.
• /server: Backend Express application code.
• /docs: Detailed documentation for each phase of the development process.
• firebase-blueprint.json: Firestore data schema definition.
• firestore.rules: Firestore security rules.