websuite
v1.0.3
Published
Headless CMS platform based on RSS (Substack, YouTube, Podcasts, Meetup) - Built on Edge with Bun
Maintainers
Readme
🚀 WebSuite Platform
The Complete Web Development Platform - CMS, AI Agents, MCP Workers, IDE, and 30+ Integrations
Built on Edge with Bun. Deploy anywhere in minutes.
✨ What is WebSuite?
WebSuite is a complete web development platform that combines:
- 🎯 Headless CMS - Multi-source content aggregation (RSS, YouTube, Podcasts, Events)
- 🤖 AI Agents - Intelligent MCP Workers powered by Gemini, ChatGPT, Mistral AI, DeepSeek
- 💻 Built-in IDE - Monaco Editor for code editing and deployment
- 🔌 30+ Integrations - GitHub, Gmail, Slack, Stripe, WhatsApp, Zoom, Supabase, and more
- ⚡ Edge Runtime - Built on Bun.js for maximum performance
- 🎨 Modern UI - Beautiful admin dashboard with dark mode
- 🔐 Enterprise Security - Authentication, environment variables, encrypted secrets
🚀 Quick Start
WebSuite Platform offre deux modes d'installation :
Option 1 : Installation Automatique (Recommandé pour utilisateurs)
Installation en quelques clics depuis GitHub Pages - Zero-Ops :
- Clonez le repo statique et déployez sur GitHub Pages
- Ouvrez votre site → Le formulaire d'installation s'affiche
- Remplissez le formulaire → Installation automatique en ~30 secondes
- C'est prêt ! 🎉
Voir le Guide d'Installation Automatique pour les détails.
Option 2 : Installation Locale (Pour développeurs)
Installation locale pour le développement :
# With Bun (recommended)
bun install @websuite-cc/platform
cd node_modules/@websuite-cc/platform
# Or with NPM
npm install @websuite-cc/platform
cd node_modules/@websuite-cc/platformConfiguration :
# Copy environment variables template
cp .dev.vars.example .dev.vars
# Edit .dev.vars with your API keys and configuration
nano .dev.varsRun Locally :
# With Bun
bun server.js
# Or with Node.js
node server.jsYour platform will be available at http://localhost:8000
💡 Note : Si
index.htmlexiste à la racine, il sera servi directement (formulaire d'installation). Sinon, le serveur utilisefrontend/index.htmlpour le SSR.
🎯 Core Features
📊 Content Management System
- Multi-source aggregation from RSS feeds
- YouTube integration for video content
- Podcast support (Anchor.fm, Spotify, Apple Podcasts)
- Event management (Meetup, Eventbrite)
- Real-time content sync with intelligent caching
🤖 AI Agents & MCP Workers
- Intelligent agents that understand context and make decisions
- Multiple AI models: Gemini, ChatGPT, Mistral AI, DeepSeek
- Code generation and deployment automation
- MCP (Model Context Protocol) support
- Agent execution logs and monitoring
💻 Built-in IDE
- Monaco Editor - VS Code-like experience in the browser
- Live preview of your code
- One-click deployment to GitHub
- Template management for frontend pages
- Syntax highlighting for multiple languages
🔌 30+ Service Integrations
Connect to all your favorite services:
Communication:
- Gmail, WhatsApp Business, Twilio SMS, Slack
AI & Machine Learning:
- Google Gemini, OpenAI ChatGPT, Mistral AI, DeepSeek, DeepL
Development:
- GitHub, GitLab, Supabase
Productivity:
- Google Workspace (Drive, Docs, Sheets, Calendar, Meet, Forms)
- Airtable, Trello, Notion
E-commerce & Payments:
- Stripe, PayPal, Shopify
Media & Content:
- YouTube, Spotify, Pexels, WordPress
Business:
- Zoom, Google Ads, Google Analytics, Meta (Facebook)
🎨 Admin Dashboard
- Modern UI with TailwindCSS
- Dark mode support
- Real-time analytics and monitoring
- API Explorer for testing endpoints
- Service status indicators
- Content management interface
📦 Deployment Options
Option 1: Docker (Recommended for Production)
# Build the image
docker build -t websuite-platform .
# Run with Docker Compose
docker-compose up -d
# Or run directly
docker run -d \
-p 8000:8000 \
--env-file .env \
--name websuite \
--restart unless-stopped \
websuite-platformOption 2: Cloudflare Pages (Managed Platform)
One-click deployment on Cloudflare's edge network:
- Connect your GitHub repository
- Configure environment variables
- Deploy automatically on every push
See Deployment Guide for details.
Option 3: Self-Hosted
Deploy on your own infrastructure:
- VPS/Cloud Server - Run with Docker or directly with Bun
- Kubernetes - Use the Docker image in your cluster
- Any Node.js/Bun compatible platform
🏗️ Architecture
┌─────────────────────────────────────────────────┐
│ WebSuite Platform │
├─────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ Frontend │ │ Admin Panel │ │
│ │ (Static) │ │ (Dashboard) │ │
│ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │
│ └────────┬────────┘ │
│ │ │
│ ┌────────▼────────┐ │
│ │ Edge Runtime │ │
│ │ (Bun.js) │ │
│ └────────┬────────┘ │
│ │ │
│ ┌───────────────┼───────────────┐ │
│ │ │ │ │
│ ┌───────┐ ┌────▼────┐ ┌───────┐ │
│ │ CMS │ │ AI │ │ API │ │
│ │ RSS │ │ Agents │ │ REST │ │
│ └───────┘ └─────────┘ └───────┘ │
│ │
│ ┌──────────────────────────────────────────┐ │
│ │ 30+ Service Integrations │ │
│ │ GitHub, Gmail, Slack, Stripe, etc. │ │
│ └──────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘🛠️ Technology Stack
- Runtime: Bun.js (compatible with Node.js 18+)
- Frontend: HTML, CSS (TailwindCSS), JavaScript (Vanilla)
- Backend: Edge Functions with Bun runtime
- Rendering: HTMX for dynamic SSR
- Editor: Monaco Editor (VS Code engine)
- AI: Multiple models (Gemini, ChatGPT, Mistral AI, DeepSeek)
- Cache: Intelligent edge caching
- Deployment: Docker, Cloudflare Pages, or self-hosted
📚 Documentation
Getting Started
- Installation Guide - Complete setup instructions
- Quick Start - Get up and running in 5 minutes
- Development Guide - Local development setup
Core Features
- AI Agents - Build and deploy intelligent agents
- Content Management - Manage your content sources
- Service Integrations - Connect external services
- API Documentation - Complete API reference
Deployment
- Docker Deployment - Production deployment with Docker
- Cloudflare Pages - Managed platform deployment
- Environment Variables - Configuration guide
Advanced
- Server Architecture - How the platform works
- Security - Best practices
- Customization - Extend the platform
🔑 Environment Variables
Key environment variables you'll need:
# Admin
[email protected]
ADMIN_PASSWORD=your_secure_password
# Content Sources
BLOG_FEED_URL=https://yoursubstack.substack.com/feed
YOUTUBE_FEED_URL=https://www.youtube.com/feeds/videos.xml?channel_id=YOUR_ID
PODCAST_FEED_URL=https://anchor.fm/s/YOUR_ID/podcast/rss
EVENTS_FEED_URL=https://www.meetup.com/your-group/events/rss
# AI Services
GOOGLE_AI_KEY=your_gemini_api_key
OPENAI_API_KEY=your_chatgpt_api_key
MISTRAL_AI_API_KEY=your_mistral_api_key
DEEPSEEK_API_KEY=your_deepseek_api_key
# Integrations (optional)
GITHUB_TOKEN=your_github_token
SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_supabase_key
# ... and 25+ more servicesSee .dev.vars.example for the complete list.
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
📝 License
MIT License - See LICENSE for details.
📞 Support
- 📧 Email: [email protected]
- 📖 Documentation: https://docs.websuite.cc
- 🐛 Issues: GitHub Issues
- 💬 Community: Join our Discord
🌟 Why WebSuite?
- ✅ All-in-One Platform - CMS, AI, IDE, and integrations in one place
- ✅ Edge Performance - Built on Bun.js for maximum speed
- ✅ 30+ Integrations - Connect to all your favorite services
- ✅ AI-Powered - Intelligent agents that automate your workflows
- ✅ Developer-Friendly - Built-in IDE and comprehensive API
- ✅ Production-Ready - Docker support and managed deployment options
- ✅ Open Source - MIT License, fully customizable
