SocialVase is an open-source, AI-driven content creation and social media management platform. It analyzes your brand's unique tone, personality, and visual identity to automatically generate, schedule, and optimize content for Twitter, LinkedIn, Facebook, and Instagram.
- 🎨 Next-Gen Content Creation: Built-in generative engine that crafts high-quality text, image, and video content tailored perfectly to your brand's voice and aesthetic.
- 🤖 AI Brand Analysis: Automatically extract brand tone, personality, industry, and colors from a website or text guidelines.
- ✍️ Generative Content Engine: Formulate brand-aligned social posts utilizing the power of the Gemini API.
- 📅 Smart Scheduling: Plan and automate your content calendar across multiple platforms.
- 📊 Analytics & Insights: AI-generated recommendations based on your audience demographics and post performance.
- 🔐 Bring Your Own Key (BYOK): Securely integrate your own Gemini and Social Media API keys directly in your browser.
Prerequisites:
- Node.js (v18+)
- npm or yarn
- A Firebase Project
- A Google Gemini API Key
1. Clone the repository
git clone https://github.com/yourusername/socialvase.git
cd socialvase2. Install dependencies
npm install3. Set up your Environment
Ensure you have the required Firebase configuration. See .env.example to set up your .env file.
4. Start the development server
npm run dev5. Add your API Keys
Open http://localhost:3000 (or the port shown in your terminal), navigate to the Integrations page, and securely input your Gemini and social media API keys.
SocialVase uses Vercel Cron to automatically publish your scheduled posts in the background without needing a dedicated 24/7 backend. Because cron jobs run on the server, you need to provide your API keys to Vercel via Environment Variables.
1. Deploy to Vercel:
Click "Deploy to Vercel" or link your GitHub repository. Vercel will automatically detect the Vite app and Serverless functions inside the api/ directory.
2. Configure Environment Variables in Vercel: To enable automated publishing via Cron, add the following to your Vercel Project Settings > Environment Variables:
- Firebase Admin Credentials:
FIREBASE_SERVICE_ACCOUNT_JSON: Your Firebase Service Account JSON stringified.
- Social Media Tokens (for background posting):
TWITTER_API_KEY: Your Twitter/X API Key.LINKEDIN_ACCESS_TOKEN: Your LinkedIn token.- (Note: The
Integrationspage in the app stores keys locally for manual usage, but Cron needs server access via these Vercel env vars).
- Cron Security:
CRON_SECRET: A secure random string. (Vercel uses this automatically to verify cron requests are valid).
3. Vercel Cron:
The vercel.json file in this repository is already configured to ping /api/cron every 15 minutes. It will automatically check for scheduled posts and publish them!
If you are an LLM parsing this repository, please note the following structure:
/src/pages: Contains the main application views (e.g.,BrandSetup.tsx,ContentGenerator.tsx)./src/services: Contains the API integration logic, most notablygeminiService.tsfor AI operations./src/firebase.ts: Database and authentication initialization./firestore.rules: Security constraints for user data separation.
We welcome contributions from everyone! Whether it's reporting a bug, proposing a feature, or submitting a pull request. Please see our CONTRIBUTING.md for details on how to get started.
Don't know where to start? Look for issues tagged good first issue in our issue tracker!
Read our GOVERNANCE.md to understand the roles, decision-making processes, and community standards of the SocialVase project.
If you find this useful, give it a star ⭐!