logodevX

Documentation

README
.github
BUG_TEMPLATEFEATURE_TEMPLATEPULL_REQUEST_TEMPLATE
workflows
README
CONTRIBUTING
core
DEPLOYMENTREADME
k8s
README
runner
pkg
ws
README
README
templates
README
web
README

Documentation

🧑‍💻 DevEx Cloud Development IDE - REPL as a Service

A production-grade REPL-as-a-Service Cloud IDE platform
Built with Kubernetes, WebSockets, S3, and GoLang magic.
Cloud Dev IDE Banner
Think Replit but open-source, custom-built, and containerized! This monorepo powers an on-demand cloud development environment, where users can spin up live REPLs, write code, use terminals, and persist their work — all through a browser.
📣 Want to add your own REPL template? It's easy! 👉 Read the Contributing Guide to get started.

✨ Features

  • •🔐 GitHub OAuth authentication
  • •🪄 Create, Start, Stop, Delete REPLs via Core API
  • •💾 S3-backed file persistence
  • •📦 Kubernetes Deployments per REPL (Dynamic)
  • •📡 WebSocket-based Editor & Terminal
  • •🧹 Ephemeral containers for cleanup and sync
  • •🔒 HTTPS & TLS via Let's Encrypt & Cert Manager
  • •🎨 Beautiful Next.js + Tailwind frontend

⚙️ How It Works

Loading diagram...

🌀 Session Lifecycle

Loading diagram...

🔩 Key Components

web/ – Frontend

  • •Built with Next.js + Tailwind CSS
  • •GitHub OAuth login
  • •GUI for File Tree, Editor, Terminal
  • •WebSocket hooks to interact with Runner

core/ – Backend API

  • •Written in Go
  • •Handles user auth, S3 ops, Kubernetes deployments, cleanup
  • •Redis for REPL session state
  • •📄 See core/README.md for detailed architecture & deployment steps

runner/ – REPL Runtime Container

  • •
    Lightweight Go server
  • •
    WebSocket API for:
    • •File tree and file content access
    • •Terminal (PTY) sessions
  • •
    📄 See runner/README.md for event list and package internals

k8s/ – Kubernetes Bootstrap & TLS

  • •
    Contains:
    • •Ingress-NGINX setup
    • •cert-manager + Let’s Encrypt for auto TLS
  • •
    📄 See k8s/README.md for full setup instructions

templates/

  • •Base folders (e.g. Node.js, Python) copied on REPL creation
  • •Language-specific dockerized scaffolds
  • •📦 Want to add your own template? See the Contribution Guide

🧱 Infrastructure

  • •☸️ Kubernetes cluster for REPL pods
  • •🔒 Cert Manager + Let’s Encrypt for TLS
  • •🗃️ S3-compatible storage for persistence
  • •🐳 Docker images for runtime environments
  • •⚙️ Redis for in-memory session tracking

📦 Deployment Flow

  1. •
    User logs in and creates a REPL
  2. •
    core/ copies a template into username/repl-id/ on S3
  3. •
    core/ deploys a pod, service, ingress in Kubernetes
  4. •
    runner/ connects via WebSocket and serves FS + Terminal
  5. •
    On session end:
    • •Ephemeral container uploads updated files to S3
    • •All K8s resources are cleaned up

💻 Tech Stack

LayerStack
FrontendNext.js, Tailwind, WebSockets
BackendGoLang (Echo/Fiber), Redis, S3 SDK
RunnerGoLang + PTY + WebSocket
OrchestrationKubernetes, Docker, Docker Swarm
NetworkingIngress NGINX + cert-manager
AuthGitHub OAuth

📄 Per-Component Docs

📚 For deeper implementation details:

🧠 Why I Built This

“This project is my deep dive into Cloud Infrastructure, DevOps, and FullStack Engineering — wrapped in a real-world application.” — Parth Kapoor

🌐 Demo & Links

🤝 Contributing

This project is under active development. Want to contribute a template, fix, or feature? Start here 👉 CONTRIBUTING.md
Pull requests, suggestions, and feedback are always welcome!

📜 License

Licensed under the MIT License