Initial commit: CodeSync collaborative coding platform

README.md

@@ -1,26 +1,97 @@
+# 🚀 CodeSync — Real-Time Collaborative Coding Platform
+
+<div align="center">
+
+![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)
+![Next.js](https://img.shields.io/badge/Next.js-000000?style=for-the-badge&logo=next.js&logoColor=white)
+![Socket.io](https://img.shields.io/badge/Socket.io-010101?style=for-the-badge&logo=socket.io&logoColor=white)
+![Redis](https://img.shields.io/badge/Redis-DC382D?style=for-the-badge&logo=redis&logoColor=white)
+![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
+![WebRTC](https://img.shields.io/badge/WebRTC-333333?style=for-the-badge&logo=webrtc&logoColor=white)
+
+**A production-grade multiplayer code editor with AI assistance, video collaboration, and sandboxed execution.**
+
+</div>
+
 ---
-tags:
-- ml-intern
----
 
-# myagent10101/codesync-collaborative-platform
+## ✨ Features
+
+- 🔄 **Real-Time Collaboration** — CRDT-based sync (Yjs) with cursor presence
+- 📝 **Monaco Editor** — VS Code-grade editing experience
+- 🏠 **Rooms System** — Create/join rooms with role-based access control
+- 💬 **Real-Time Chat** — Room messaging with typing indicators
+- ⚡ **Code Execution** — Docker sandbox isolation (JS, Python, C++, Java)
+- 📹 **Video/Audio Calls** — WebRTC peer-to-peer with screen sharing
+- 🤖 **AI Assistant** — OpenRouter-powered debugging and optimization
+- 🔐 **JWT Authentication** — Secure auth with Google OAuth
+
+## 🏗️ Architecture
 
-<!-- ml-intern-provenance -->
-## Generated by ML Intern
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Client (Next.js 14)                        │
+│  Monaco Editor │ Socket.io │ WebRTC │ Zustand │ Tailwind    │
+└───────────────────────────┬─────────────────────────────────┘
+                            │ WebSocket + REST
+┌───────────────────────────┴─────────────────────────────────┐
+│                Backend (Express + Socket.io)                   │
+│  REST API │ CRDT Engine │ WebRTC Signaling │ Execution Queue │
+└─────┬──────────────┬────────────────────────────┬───────────┘
+      │              │                            │
+┌─────┴─────┐ ┌─────┴─────┐            ┌────────┴────────┐
+│ PostgreSQL │ │  Upstash  │            │ Docker Sandboxes │
+│ (Supabase) │ │  Redis    │            │ (Isolated)       │
+└───────────┘ └───────────┘            └─────────────────┘
+```
 
-This model repository was generated by [ML Intern](https://github.com/huggingface/ml-intern), an agent for machine learning research and development on the Hugging Face Hub.
+## 🛠️ Tech Stack
 
-- Try ML Intern: https://smolagents-ml-intern.hf.space
-- Source code: https://github.com/huggingface/ml-intern
+| Layer | Technology |
+|-------|-----------|
+| Frontend | Next.js 14, TypeScript, Tailwind CSS, Monaco Editor |
+| State | Zustand |
+| Real-time | Socket.io, Yjs (CRDT) |
+| Video | WebRTC |
+| Backend | Node.js, Express |
+| Database | PostgreSQL (Prisma ORM) |
+| Cache | Upstash Redis |
+| Execution | Docker containers |
+| AI | OpenRouter (multi-model) |
+| Auth | JWT + Google OAuth |
+| Deploy | Vercel + Railway |
 
-## Usage
+## 🚀 Quick Start
+
+```bash
+pnpm install
+cp apps/server/.env.example apps/server/.env
+docker compose -f docker/docker-compose.yml up postgres redis -d
+cd apps/server && npx prisma migrate dev
+cd ../.. && pnpm dev
+```
 
-```python
-from transformers import AutoModelForCausalLM, AutoTokenizer
+## 📁 Project Structure
 
-model_id = "myagent10101/codesync-collaborative-platform"
-tokenizer = AutoTokenizer.from_pretrained(model_id)
-model = AutoModelForCausalLM.from_pretrained(model_id)
 ```
+codesync/
+├── apps/
+│   ├── web/              # Next.js 14 frontend
+│   └── server/           # Express + Socket.io backend
+├── packages/shared/      # Shared types & constants
+├── docker/               # Docker configs + sandboxes
+└── docs/                 # Architecture & deployment docs
+```
+
+## Key Design Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| Yjs (CRDT) over OT | No central authority needed; guaranteed convergence |
+| Redis Pub/Sub | Enables horizontal scaling without sticky sessions |
+| Zustand over Redux | Less boilerplate, better TS support |
+| Docker Isolation | Security-first execution with resource limits |
+
+## 📄 License
 
-For non-causal architectures, replace `AutoModelForCausalLM` with the appropriate `AutoModel` class.
+MIT