OpenCodeABsUI/UX

Enterprise-grade OpenCode ecosystem plugin and hybrid infrastructure manager

📖 README • 🛡️ MIT License • 📁 Project Structure • 📋 Security

Version: 1.0.0-EA | License: MIT | Live: pocwu.pages.dev | PRD: OpenCodeWEBsPRD/PRD.md

OpenCodeABsUI/UX bridges local developer environments with a 24/7 serverless cloud runtime via a decentralized, peer-to-peer data synchronization layer powered by GunDB. It provides a SaaS-style Web UI featuring multi-agent company orchestration (/o/), isolated sandboxes (/s/), multi-device remote management (/u/), GitHub-based verification, a Universal Coding Language Support Engine for 200+ programming languages, and a 3D interactive global metrics dashboard — all underpinned by a real-time, offline-first GunDB graph network.

• GitHub OAuth verification with automated follow-to-verify human status
• Org namespace control — server-side role validation via GitHub API
• Token lifecycle — key-based URLs valid for 99 minutes, OAuth sessions persist indefinitely

• Creation wizard with company name, logo, goals, and resource caps
• Public showcase pages with verified badges, workforce metrics, and token throughput gauges
• 33+ multi-agent role tracking with live AI power meters

• Strict multi-tenant isolation between company sessions
• Auto-backup workflow with preview mode and one-click publish
• Scope escalation guardrails for filesystem access

• Smart-ranked hub directory with immutable Root Hub (#1) anchored at /C/ABsUPs/CommunityHub
• Dynamic routing: /C/{username} and /C/{username}/{project} for scoped discussions
• Header-as-Button: Click the 💬 Community Hub header to natively render GitHub Discussions — no external redirect
• Real-time search by username, org, or project name
• Sort options: System Smart Rank, Most Active Members, Top Stars & Forks, Recently Created
• Tag filters: Templates, Features, Showcase, Bug Reports
• Automated forking — first-time users auto-fork the root hub to create their personal space
• GunDB P2P Sync: Posts and comments sync instantly across the peer-to-peer mesh
• Create/Edit/Delete posts with inline Markdown, comments, and category tagging

• 100% language inclusivity — write, parse, compile, execute, and debug code in any programming language
• 5-tier classification — Mainstream (TS/JS/Python/Rust), Enterprise Legacy (COBOL/Fortran), Functional (Haskell/Elixir), HDL (Verilog/VHDL), Esoteric (Brainfuck/APL)
• Tree-sitter WASM parsing — dynamic grammar loading for 200+ languages without bundle inflation
• Polyglot AST mapping — unified JSON-serializable AST nodes across all paradigms
• Cross-language transpilation — translate between any languages (e.g., COBOL → Rust)
• WASM micro-runtime for lightweight scripts, Docker sandbox for heavy/legacy runtimes
• Resource hardening — 512MB RAM limit, 30-second execution timeout
• Full spec: OpenCodeWEBsPRD/universal-engine.md

• Public server directory with live health status (🟢 Healthy, 🟡 Degraded, 🔴 Offline)
• Server registration with metadata (type, location, capabilities)
• Last-seen tracking and status badges
• API-driven server management with KV persistence

• Community user directory with GitHub-verified profiles
• Avatar, bio, location, and follower/following metrics
• User search and sorted listings
• Links to personal community hubs

• Comprehensive project overview with feature cards and architecture diagram
• Tech stack breakdown and collapsible security notice
• Repository statistics and navigation links

• Active device selector with WebSocket-based telemetry streaming
• Offline snapshot fallback via private GitHub forks
• Read-only dashboard from fork when all devices are offline

• Public repository for sharing multi-agent templates and OpenCode setups

• Local host — heavy compute, code generation, refactoring, security checks
• Serverless cloud — 24/7 API runtime on Cloudflare Workers
• Multi-account fallback rotation for zero-cost uptime
• Bi-directional database syncing (D1 / KV / GitHub Fork)
• Zero-cost Gemini web automation via browser sessions

• Real-time, offline-first peer-to-peer data sync across all nodes
• CRDT-based conflict resolution with automatic merge on reconnect
• SEA end-to-end encryption bound to GitHub OAuth identity
• IndexedDB persistence for instant cold-start loading
• GitHub Private Fork snapshots as offline fallback

• 24/7 persistence via systemd (Linux), launchd (macOS), Task Scheduler/PM2 (Windows), Termux (Android), Docker

• Dynamic plugin loading/unloading with RAM optimization
• Concurrent dual-stream pipeline: verification + optimization
• Merge to master only when both streams pass validation

• Local-only PRD isolation — all documents stored in OpenCodeWEBsPRD/ with .gitignore enforcement
• 6-step startup pipeline: path resolution → directory creation → privacy guardrail → auto-sweep → subject routing → isolated write
• Subject-based modular files — master PRD.md + indexes for ToDo, Logic, Design, Community, and Security
• Cross-platform — Windows, macOS, Linux, Termux

• Node.js 18+
• npm (or yarn/pnpm)

git clone https://github.com/OpenCodeWEB/UI.git
cd UI
npm install

npm run dev

Opens at http://localhost:5173.

npm run build

Output is written to dist/.

npm run preview

npm run check

npm run lint

1. Install Wrangler CLI (if not already installed):

   npm install -g wrangler

2. Authenticate with Cloudflare:

   wrangler login

3. Deploy via Wrangler:

   npx wrangler pages deploy dist

4. Or connect your GitHub repo in the Cloudflare Pages dashboard for automatic deployments:

   • Build command: npm run build
   • Build output directory: dist

Your site will be live at https://pocwu.pages.dev.

Required Cloudflare KV namespaces: DEVICES_KV, SESSIONS_KV — bind them in the Pages dashboard or wrangler.toml.

Living document: PROJECT_STRUCTURE.md — actively maintained, updated with every structural change.

The project is organized into four main layers:

Note: This README shows the high-level structure only. See PROJECT_STRUCTURE.md for the full tree with file-level annotations, API route details, and architectural relationship diagrams.

• Core Maintainer: @ABsUP
• Organization: @ABsUPs
• Repository: OpenCodeWEB/UI
• PRD Documents: OpenCodeWEBsPRD/ (strictly local, gitignored)

MIT

🗄️⚡💝 ~ OpenCodeWEB/UI