Documentation

Documentation

⚡ DevEx – The Open Cloud IDE Platform

Run full-featured, containerized dev environments in the cloud — with AI assistance and secure sandboxing.
Scalable REPL sessions powered by Kubernetes, WebSockets, and GoLang.
Cloud Dev IDE Banner

DevEx is an open-source platform to spin up cloud-based development environments (REPLs) that work like your local setup — but in the browser, anywhere, anytime.
Built for flexibility, you can code in your preferred stack, connect over SSH, or run sessions with AI agents via our MCP server. We also support sandboxing AI-generated code securely, letting you test real changes in isolated environments.
Unlike Gitpod or E2B, DevEx is lightweight, self-hostable, and production-grade out of the box — with a developer-first CLI, seamless AI integration, and Kubernetes-native design for infinite scale.
📣 Want to add your own REPL template? It's easy! 👉 Read the Contributing Guide to get started.

🚀 MCP Server is now live at glama.ai – enabling AI agents to interact directly with your REPLs!

✨ 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

apps/web/Frontend

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

apps/core/Backend API

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

apps/runner/REPL Runtime Container

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

infra/k8s/Kubernetes Bootstrap & TLS

  • Contains:
    • Ingress-NGINX setup
    • cert-manager + Let’s Encrypt for auto TLS
  • 📄 See infra/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. apps/core/ copies a template into username/repl-id/ on S3
  3. apps/core/ deploys a pod, service, ingress in Kubernetes
  4. apps/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