ClipSphere is a premium, high-performance video social platform designed for creators and viewers. It features AI-powered recommendations, seamless video streaming, and a robust micro-tipping economy.
- 🎥 Video Management: Seamless MP4/HLS streaming with high-quality playback.
- 🧠 AI Recommendations: Semantic search and content discovery powered by Google Gemini AI and MongoDB Vector Search.
- 💸 Monetization: Direct creator support through a secure Stripe-integrated tipping system.
- 🔔 Real-time Social: Instant notifications, likes, follows, and engagement tracking.
- 🛠️ Developer Experience: Fully containerized environment with Docker for easy deployment.
- Frontend: Next.js 15 (App Router), TypeScript, Tailwind CSS, Lucide Icons.
- Backend: Node.js, Express.js, BullMQ (Async processing).
- Database: MongoDB (Primary & Vector Store), Redis (Job Queue & Cache).
- Storage: MinIO (S3-Compatible Object Storage).
- AI/ML: Google Gemini (Vertex AI) for Vector Embeddings.
- DevOps: Nginx, Docker Compose.
ClipSphere follows a modern microservices-lite architecture:
graph TD
User([User Browser]) <--> Nginx[Nginx Proxy]
Nginx <--> Frontend[Next.js]
Nginx <--> Backend[Express API]
Backend <--> MongoDB[(MongoDB)]
Backend <--> MinIO[MinIO Storage]
Backend <--> Redis[Redis Queue]
Redis <--> Worker[BullMQ Worker]
Worker <--> Gemini[Gemini AI]
- Docker & Docker Compose
- Bun (optional, for local development)
- Clone the repository.
- Create a
.envfile in the root (refer toserver/.envfor required keys). - Run the following command:
docker compose up --build
- Access the app at
https://clipsphere.8bitsolutions.net(or your local host configuration).
Detailed guides and project specifications:
- 🎨 Design: Figma Project
- 🗺️ Roadmap: Project Plan
- 📋 Specs: Functional Requirements
- 🤝 Contributing: Contribution Guidelines
Created with sleepless nights and a lot of coffee by very tired developers :)