docs.plus is a free, real-time collaboration tool built on open-source technologies. It empowers communities to share and organize information logically and hierarchically, making teamwork and knowledge sharing straightforward and effective.

Monorepo Structure:

• 🌐 packages/webapp - Next.js frontend with TipTap editor
• ⚡ packages/hocuspocus.server - REST API, WebSocket server, and background workers
• 🗄️ packages/supabase - Database migrations and Supabase configuration
• 🔌 packages/extension-* - TipTap extensions (hyperlink, multimedia, indent, inline-code)

Tech Stack:

• Runtime: 🚀 Bun 1.3.2+
• Frontend: ⚛️ Next.js 15, React, TipTap, Tailwind CSS
• Backend: 🔧 Hono, Hocuspocus (Y.js), Prisma ORM
• Database: 🐘 PostgreSQL 17, 🔴 Redis
• Infrastructure: 🐳 Docker Compose, Supabase
• Real-time: 🔌 WebSocket (Hocuspocus), Supabase Realtime

• 🐳 Docker & Docker Compose v2+ - Install
• 🚀 Bun >=1.3.2 - Install
• 🗄️ Supabase CLI - Install

git clone https://github.com/docs-plus/docs.plus.git
cd docs.plus
bun install

cp .env.example .env.development

Update .env.development with your configuration. See .env.example for all available variables.

make supabase-start

make up-dev

Services: 🎯

• 🌐 Webapp: http://localhost:3000
• 🔌 REST API: http://localhost:4000
• ⚡ WebSocket: ws://localhost:4001
• 👷 Worker: http://localhost:4002
• 🐘 PostgreSQL: localhost:5432
• 🔴 Redis: localhost:6379
• 🗄️ Supabase Studio: http://127.0.0.1:54323

Production-ready setup for mid-level scale deployments (small-medium teams, moderate traffic).

Architecture: 🏗️

• 📈 Horizontal scaling: REST API (2), WebSocket (3), Worker (2), Webapp (2)
• 🔀 Nginx reverse proxy with load balancing
• ⚡ Resource limits and health checks
• 📊 Production-optimized logging and connection pooling

1. ⚙️ Configure Environment

   cp .env.example .env.production

   Update: database credentials, JWT secret, Supabase URLs, storage credentials, CORS origins.

2. 🔨 Build & Deploy

   make build
   make up-prod

3. 📈 Scaling Adjust replicas in .env.production:

   REST_REPLICAS=2
   WS_REPLICAS=3
   WORKER_REPLICAS=2
   WEBAPP_REPLICAS=2

Production Recommendations: 💡

• 🗄️ Use managed database (AWS RDS, DigitalOcean, Supabase Cloud)
• 🔒 Configure SSL/TLS certificates
• 📊 Set up monitoring (Prometheus, Grafana)
• 💾 Implement database backups
• 🔐 Secure all secrets and credentials

# Building
make build             # Production build
make build-dev         # Development build

# Running
make up-prod           # Start production
make up-dev            # Start development

# Management
make down              # Stop services (auto-detects env)
make restart           # Restart services (auto-detects env)
make logs              # All logs
make logs-webapp       # Webapp logs
make logs-backend      # Backend logs
make ps                # Container status
make stats             # Resource usage
make clean             # Cleanup (auto-detects env)

# Scaling (production)
make scale-webapp      # Scale webapp to 3 replicas
make scale-hocuspocus  # Scale backend services

# Supabase
make supabase-start    # Start local Supabase
make supabase-stop     # Stop local Supabase
make supabase-status   # Show Supabase status

Run make help for complete command list.

docs.plus/
├── packages/
│   ├── webapp/              # 🌐 Next.js frontend
│   ├── hocuspocus.server/   # ⚡ REST API, WebSocket, Workers
│   ├── supabase/            # 🗄️ Database migrations
│   └── extension-*/         # 🔌 TipTap extensions
├── docker-compose.dev.yml   # 🐳 Development orchestration
├── docker-compose.prod.yml  # 🚀 Production orchestration
├── Makefile                 # 🛠️ Build & deployment commands
└── .env.example             # ⚙️ Environment template

PRs welcome! See contributing guidelines for details.

Apache License 2.0 - See LICENSE.md

• 💬 Discord: Join our server
• 🐦 Twitter: @docsdotplus
• 🐙 GitHub: docs.plus
• 📧 Email: contact@newspeak.house