Clone any GitHub repo, edit it, build it, preview it, ship it — without installing anything.

Vertex is an open-source family of code-editing products. The browser workbench combines Git, a virtual filesystem, build, and a Node-compatible runtime client-side. The Tauri app adds installed-platform adapters, while the drop-in <vertex-editor> remains a focused editor with no IDE/runtime dependency.

🚀 Try it live · ⚡ Quick start · 🧩 Products · 🏗️ Architecture · 📦 Web component · 📚 Docs source · 🤝 Contributing

---

💡 The idea

Cloud IDEs put your code on someone else's machine. Local IDEs need an install, a runtime, a toolchain. Vertex takes the third path: the browser is the machine.

     paste a repo URL  →  git clone (in-browser)  →  edit  →  bundle  →  preview  →  deploy
                              isomorphic-git          CodeMirror 6   esbuild-wasm   WebContainers   Cloudflare

The hosted browser workbench does not require a Vertex application backend. It is static output on Cloudflare Pages; repositories are cloned into browser storage rather than uploaded to a Vertex server. Optional local sidecars exist for installed/native development workflows.

---

🧭 Product surfaces

Vertex is not one application stretched across every environment:

Surface	Job	Owns
apps/web	Complete browser workbench	OPFS, browser Git, build, WebContainer preview, deploy
apps/desktop	Installed Tauri workbench	Native filesystem/process/terminal adapters and lifecycle
<vertex-editor>	Editor embedded in another product	Editing API, language loading, themes, events
<vertex-editor-lite>	Read-only code display	Small native custom element and syntax highlighting

The custom elements do not include filesystems, Git, terminals, preview, or deployment. Preview is a workbench capability, not an editor capability.

---

✨ What you get

🌿 Real git, in the tab isomorphic-git over a virtual FS. Clone, stage, commit, branch — against any public repo.	💾 Storage that survives OPFS + IndexedDB via Lightning FS. Close the tab, come back, your working tree is still there.	⌨️ A real editor CodeMirror 6 with TS/JS, HTML, CSS, JSON, Markdown, Python and Rust modes, lint and autocomplete.
📟 Terminal xterm.js with a pluggable backend — WebContainers in the browser, node-pty on the desktop.	📦 Build & preview esbuild-wasm bundles in-browser; WebContainers boot a Node runtime and serve a live preview.	☁️ Ship from the IDE Cloudflare Pages and Workers adapters live inside @vertex/runtime — build, then publish.
🖥️ Desktop too The same Angular app inside Tauri 2, with a Rust bridge for native filesystem access.	🧩 21 IDE components @vertex/ide-ui — splitters, trees, tabs, toasts, virtual lists — headless logic, CSS-var theming.	⚡ Zoneless Angular 21 Signals everywhere, OnPush everywhere, no Zone.js, no Tailwind, no component framework.

---

🚀 Try it live

vertex.andersseen.dev — paste a repo URL, hit Clone & Edit.

1.  Open  https://vertex.andersseen.dev
2.  Paste https://github.com/andersseen/palette-forge   (or any public repo)
3.  Clone & Edit — the repo is cloned into your browser, not onto a server

---

⚡ Quick start

Requirements — Bun 1.3.11+, Node.js 22.12+, and a Rust toolchain (desktop only).

git clone https://github.com/Andersseen/vertex.git
cd vertex
bun install
bun web:dev            # → http://localhost:5173

All the commands you'll actually need

	Command	What it does
🌐	bun web:dev	Vite dev server for the web IDE → localhost:5173
🖥️	bun desktop:dev	Tauri desktop app (needs Rust)
🔗	bun dev:all	Web app + terminal sidecar + filesystem sidecar in parallel
🧱	bun run build	Full monorepo build through Turborepo
🧹	bun lint · bun lint:fix	ESLint across every workspace
🔍	bun check-types	tsc --noEmit across every workspace
🧪	bun test	Unit tests (Bun test runner)
🎭	bun test:e2e	Playwright end-to-end suite
📦	bun web-editor:build	Bundle the <vertex-editor> web component
🎬	bun web-editor-demo:start	Build the component and serve its demo app
📚	bun docs:dev · bun docs:build · bun docs:deploy	Develop, build, or publish the Starlight documentation
☁️	bun run deploy	Build + publish to Cloudflare Pages

---

🏗️ Architecture

flowchart TB
  subgraph SURFACES["🖼️ Products — shared editor, separate responsibilities"]
    direction LR
    W["🌐 apps/web<br/>Angular 21 · Analog.js"]
    D["🖥️ apps/desktop<br/>Tauri 2 · Rust"]
    E["🧩 @vertex/web-editor<br/>&lt;vertex-editor&gt; · editor only"]
  end

  EDITOR["@vertex/editor-core<br/>CodeMirror engine · language profiles"]

  subgraph ANGULAR["🅰️ Workbench layer"]
    direction LR
    UI["@vertex/ui<br/>layouts · editor · sidebar"]
    IDEUI["@vertex/ide-ui<br/>21 headless components"]
    CORE["@vertex/core<br/>services · Dexie · terminal DI"]
  end

  subgraph RUNTIME["⚙️ @vertex/runtime — browser-native, zero Angular"]
    direction LR
    FS["fs/<br/>OPFS · MemoryFS"] --> GIT["git/<br/>isomorphic-git"] --> BUILD["build/<br/>esbuild-wasm"] --> PREVIEW["preview/<br/>WebContainers"] --> DEPLOY["deploy/<br/>Cloudflare"]
  end

  W --> ANGULAR
  D --> ANGULAR
  E --> EDITOR
  UI --> EDITOR
  ANGULAR --> RUNTIME
  RUNTIME --> STORE[("💾 OPFS + IndexedDB<br/>your files never leave the browser")]

Loading

Monorepo layout

apps/
  web/                  🌐 Angular 21 + Analog.js + Vite — the main IDE
  desktop/              🖥️ Tauri 2 shell around the same app
  web-editor-demo/      🎬 Playground for the standalone web component
  docs/                 📚 Starlight documentation for every product surface
packages/
  frontend/
    core/               🧠 Angular services, Dexie DB, terminal adapter token
    editor-core/        ✏️ Framework-free CodeMirror engine and language profiles
    ide-ui/             🧩 @vertex/ide-ui — headless IDE components (CSS custom props)
    runtime/            ⚙️ VirtualFS · GitClient · Bundler · Preview · Deploy
    types/              📐 Shared TypeScript contracts
    ui/                 🎨 Layouts, CodeMirror editor, sidebar
    web-editor/         📦 Publishable <vertex-editor> Angular Element
  backend/
    sidecar/            🦀 Bun/Hono filesystem sidecar
    terminal/           📟 Node.js + node-pty terminal sidecar
    core/               🧪 Experimental shared terminal types
scripts/                🔧 Install & release helpers
docs/                   🧭 Repository architecture, deployment, and design notes

The products intentionally have different scopes. See docs/ARCHITECTURE.md for dependency rules and product boundaries, and docs/EDITOR_FOUNDATION.md for the stability checklist.

Where state lives

Layer	Stores	Why
localStorage	Splitter positions	Synchronous read, no layout flash on boot
sessionStorage	Open tabs (vertex:editor)	Intentionally volatile
Dexie v4 (vertex-ide)	Active session, preferences	Structured and extensible
OPFS + IndexedDB	Cloned repository files	Browser-native filesystem, survives reloads

---

📦 Embed the editor anywhere

Vertex ships its editor as a framework-agnostic custom element. Drop one script tag into any page — React, Vue, Rails, plain HTML — and you have a CodeMirror-powered editor.

curl -fsSL https://raw.githubusercontent.com/Andersseen/vertex/main/scripts/install.mjs | node - ./public

<script src="web-editor.min.js"></script>

<vertex-editor value="const x = 1;" language="typescript" theme="dark"></vertex-editor>

Bundle	Element	Size	Use case
web-editor.min.js	<vertex-editor>	~1.1 MB	Full editing, autocomplete, lint
web-editor-lite.min.js	<vertex-editor-lite>	~450 KB	Read-only syntax-highlighted display

📥 Always-fresh builds: web-editor-latest release · 📖 component docs

---

🗺️ Status

Vertex is in active development. The current target is a dependable editor and browser/tablet MVP, not VS Code feature parity.

Priority	Current state
Shared editor core, language profiles, package boundaries	✅ Established
Full and lite custom elements with enforced bundle budgets	✅ Established
Public docs and canonical custom-element API	🔄 In progress
Capability fallback, recovery UX, blocking persistence E2E	🧭 Next
Project search, command palette, Git status/diff	🧭 MVP
Physical tablet keyboard/touch/lifecycle validation	🧭 MVP
Broad VS Code extension compatibility	🔭 Later research

See the foundation checklist and the public roadmap source.

---

☁️ Deployment

One platform, one pipeline, one command. Cloudflare is the only deploy target — no Vercel, no Netlify, no split brain between local and CI.

flowchart LR
  A[push to main] --> B[quality<br/>lint · types · unit]
  B --> C[e2e · Playwright]
  B --> D[deploy<br/>Cloudflare Pages]
  D --> E[🌍 vertex.andersseen.dev]

Loading

bun run deploy    # identical to what CI runs

Full details — secrets, environments, headers, the Workers migration path — in 📄 docs/DEPLOYMENT.md.

---

🛠️ Under the hood

Area	Choice
Framework	Angular 21, zoneless (provideZonelessChangeDetection), signals-first, OnPush everywhere
Meta-framework	Analog.js — file-based routing in apps/web/src/app/routes/
Build	Vite 8 · Turborepo · Bun workspaces
Editor / terminal	CodeMirror 6 · xterm.js
In-browser runtime	Lightning FS (OPFS) · isomorphic-git · esbuild-wasm · WebContainers
Desktop	Tauri 2 + Rust sidecar
Styling	Pure CSS custom properties (--ide-*). No Tailwind, no PrimeNG, no CSS-in-JS
Headless logic	quartz-headless · @andersseen/headless-components

Conventions for contributors (and coding agents) live in AGENTS.md, with Angular and Analog specifics in ANGULAR_USAGE.md and ANALOGJS_USAGE.md.

---

📚 Documentation

Doc	About
AGENTS.md	Architecture, conventions, commands — the authoritative guide
apps/docs	Public Starlight documentation application
docs/ARCHITECTURE.md	Product ownership and package boundaries
docs/EDITOR_FOUNDATION.md	Stability checklist and MVP gaps
docs/DEPLOYMENT.md	Cloudflare pipeline, secrets, environments
apps/web/README.md	Web application
apps/desktop/README.md	Tauri desktop application
packages/frontend/runtime/README.md	Browser-native runtime
packages/frontend/web-editor/README.md	<vertex-editor> web component
docs/preview-wc/README.md	WebContainer preview design notes

---

🤝 Contributing

Issues, discussions and pull requests are welcome — especially around the browser runtime, the IDE component library, and language tooling.

Before opening a PR: bun lint && bun check-types && bun test.

---

⭐ If Vertex is useful to you, a star helps other people find it.

MIT licensed — see LICENSE · Built by Andrii Pap