Skip to content

hellokit3y/CreatorOs

 
 

Repository files navigation



Stop juggling 10 tools. Start owning your creator empire — from one dashboard.


 ██████╗██████╗ ███████╗ █████╗ ████████╗███████╗██████╗  ██████╗ ███████╗
██╔════╝██╔══██╗██╔════╝██╔══██╗╚══██╔══╝██╔════╝██╔══██╗██╔═══██╗██╔════╝
██║     ██████╔╝█████╗  ███████║   ██║   █████╗  ██████╔╝██║   ██║███████╗
██║     ██╔══██╗██╔══╝  ██╔══██║   ██║   ██╔══╝  ██╔══██╗██║   ██║╚════██║
╚██████╗██║  ██║███████╗██║  ██║   ██║   ███████╗██║  ██║╚██████╔╝███████║
 ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝

Shopify + Notion + Zapier — built for creators.


🚀 Get Early Access📖 Documentation🐛 Report Bug💡 Request Feature💬 Join Discord


🔥 The Problem

Every creator knows this chaos:

Tool What You Use It For
Linktree / Beacons Bio links
ManyChat DM automation
Notion / Notes Content ideas
Sheets / Notion Brand deal tracking
Later / Buffer Scheduling
Native dashboards Analytics

That's 6+ apps, 6+ subscriptions, 6+ logins — just to run your creator business.

CreatorOs ends this. One platform. Everything connected. Zero context-switching.


✨ What CreatorOs Does

🔗 Smart Bio System

Your link-in-bio, evolved.

  • Advanced, fully branded bio pages
  • Product showcase with buy buttons
  • Per-link redirect tracking
  • Custom domain support
  • Mobile-first, blazing fast

🤖 DM Automation

Turn every comment & DM into a conversion.

  • Keyword-triggered auto-replies
  • Instant free resource delivery
  • Funnel followers → products & newsletters
  • Instagram Graph API powered
  • No-code setup

🤝 Creator CRM

Your brand deals, professionally managed.

  • Full collaboration pipeline
  • Payment tracking & invoicing
  • Sponsor contact database
  • Campaign status board
  • Deliverable reminders

📊 Analytics Dashboard

Know exactly what's working.

  • Instagram engagement insights
  • Link click heatmaps
  • Follower growth curves
  • Conversion tracking
  • Cross-platform metrics (coming soon)

🧠 Content OS

Never stare at a blank screen again.

  • Idea bank with tagging & search
  • Script & caption storage
  • Visual post scheduler
  • AI content suggestions powered by GPT-4
  • Batch-write & auto-schedule

🛠️ Tech Stack

Layer Technology
Frontend Next.js React TailwindCSS
Backend Node.js Express
Database PostgreSQL MongoDB
Auth Clerk Firebase
Automation Instagram
AI OpenAI OpenRouter
Hosting Vercel Railway Supabase

🚀 Getting Started

Prerequisites

node >= 18.0.0
npm >= 9.0.0

Installation

# Clone the repository
git clone https://github.com/yourusername/CreatorOs.git

# Navigate into the project
cd CreatorOs

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env.local

Environment Setup

Important

The following variables are required for the application to function correctly:

  1. MONGODB_URI → Required for persistent database storage
  2. JWT_SECRET → Required for authentication and session security
  3. CLERK_SECRET_KEY → Required for Clerk authentication
  4. DATABASE_URL → Required for database connectivity

Missing these variables may cause authentication failures, API errors, or application crashes.

Create a .env.local file in the project root:

# -------------------------------------------------------
# Clerk Authentication
# dashboard.clerk.com → API Keys

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key

# -------------------------------------------------------
# Database Configuration

# Primary SQL database connection string
# Example providers:
# - Neon
# - PostgreSQL
# - Supabase

DATABASE_URL=your_database_connection_url

# MongoDB Atlas connection string
# mongodb.com/cloud/atlas

MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/database_name

# -------------------------------------------------------
# Instagram Graph API
# developers.facebook.com → My Apps → Instagram Graph API

INSTAGRAM_APP_ID=your_instagram_app_id
INSTAGRAM_APP_SECRET=your_instagram_app_secret

# -------------------------------------------------------
# AI Providers

# platform.openai.com → API Keys

OPENAI_API_KEY=sk-...

# openrouter.ai → Keys

OPENROUTER_API_KEY=sk-or-...

# -------------------------------------------------------
# Application URL

# Base URL where the app is running

NEXT_PUBLIC_APP_URL=http://localhost:3000

# -------------------------------------------------------
# Email Configuration

# Supported values may include:
# smtp, gmail, resend, sendgrid, etc.

EMAIL_SERVICE=smtp

# Sender email credentials

EMAIL_USER=your_email_address
EMAIL_PASSWORD=your_email_password

# Default sender information

EMAIL_FROM="CreatorOS <no-reply@creatoros.com>"
EMAIL_FROM_NAME=CreatorOS

# Support / reply-to address

EMAIL_REPLY_TO=support@creatoros.com

# SMTP Configuration

EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_SECURE=false

# -------------------------------------------------------
# JWT Configuration

# Generate with: openssl rand -base64 32

JWT_SECRET=your_jwt_secret

# -------------------------------------------------------
# Application Configuration

# Backend application URL

APP_URL=http://localhost:3000

# Development server port

PORT=3000

# Environment mode
# Supported values:
# development, production, test

NODE_ENV=development

# Enable verbose debugging logs

DEBUG=false

Copy Environment File

cp .env.example .env.local

Run Locally

npm run dev

Then open:

http://localhost:3000

📁 Project Structure

CreatorOs/
├── 📂 app/                    # Next.js App Router
│   ├── 📂 (auth)/             # Auth pages (login, signup)
│   ├── 📂 (dashboard)/        # Main dashboard routes
│   │   ├── 📂 bio/            # Smart Bio System
│   │   ├── 📂 automation/     # DM Automation
│   │   ├── 📂 crm/            # Creator CRM
│   │   ├── 📂 analytics/      # Analytics Dashboard
│   │   └── 📂 content/        # Content OS
│   └── 📂 api/                # API Routes
├── 📂 components/             # Reusable UI components
├── 📂 lib/                    # Utility functions & configs
├── 📂 hooks/                  # Custom React hooks
├── 📂 prisma/                 # DB schema & migrations
└── 📂 public/                 # Static assets

🎯 Who Is This For?

📸 Instagram Influencers 🎬 YouTubers 🎓 Coaches & Solopreneurs
📦 Digital Product Sellers ✍️ Indie Creators 🏷️ Brand Deal Hunters

If you're building an audience and monetizing your knowledge — CreatorOs is your control center.


💰 Pricing Model

┌─────────────────┬──────────────────┬─────────────────────┐
│   FREE           │   PRO             │   SCALE              │
│                  │                  │                      │
│ ✓ Bio page       │ ✓ Everything Free │ ✓ Everything Pro     │
│ ✓ Basic analytics│ ✓ DM Automation  │ ✓ Commission sales   │
│ ✓ 1 CRM pipeline │ ✓ Full CRM       │ ✓ Priority AI        │
│ ✓ Idea bank      │ ✓ AI suggestions │ ✓ White-label bio    │
│                  │ ✓ Post scheduler │ ✓ Team seats         │
│ $0/mo            │ $X/mo            │ $XX/mo               │
└─────────────────┴──────────────────┴─────────────────────┘

🗺️ Roadmap

  • Project architecture & planning
  • 🔗 Smart Bio System v1
  • 📊 Analytics Dashboard v1
  • 🤖 DM Automation (Instagram Graph API)
  • 🤝 Creator CRM v1
  • 🧠 Content OS + AI suggestions
  • 💳 Payments & subscriptions (Stripe)
  • 📱 Mobile app (React Native)
  • 🌐 Multi-platform support (YouTube, TikTok)
  • 🔌 Public API for integrations

🤝 Contributing

Contributions are what make the open-source community amazing. Any contributions you make are greatly appreciated.

# 1. Fork the project
# 2. Create your feature branch
git checkout -b feature/AmazingFeature

# 3. Commit your changes
git commit -m 'feat: add AmazingFeature'

# 4. Push to the branch
git push origin feature/AmazingFeature

# 5. Open a Pull Request

Please read CONTRIBUTING.md for our code of conduct and contribution guidelines.


📄 License

Distributed under the MIT License. See LICENSE for more information.


🌟 Our Contributors

We're proud to be part of GSSoC 2026 🚀. This project is built by our amazing community of contributors who share the vision of empowering creators worldwide.

Meet Our Community

Contributors
View Contributors

Want to Join Our Community?

Every contribution, no matter how small, helps us build something amazing for creators. Here's how you can get involved:

  1. Pick an Issue - Browse our open issues and find something that interests you
  2. Fork & Create Branch - Fork the repo and create a feature branch
  3. Make Your Changes - Implement your feature or fix
  4. Submit PR - Open a pull request with a clear description
  5. Get Recognized - Your contribution will be visible on this README! 🎉

💡 First time contributing? Start with issues labeled good first issue or help-wanted. We're here to help!

Special Recognition: This project is part of GSSoC (Girl Script Summer of Code) 2026 — helping beginners and experienced developers contribute to open source.


📬 Connect

Built with 🖤 for creators, by creators.

Twitter Instagram Discord LinkedIn


If CreatorOs saves you time, give it a ⭐ — it means the world.

About

Creator-OS

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • EJS 78.0%
  • JavaScript 20.4%
  • HTML 1.6%