Documentation

Everything you need to install, build, and contribute to Land.

Get Started in Minutes

The README walks you through installation, first build, and the fifteen-element architecture. No prior Rust or Tauri knowledge required.

Report a Bug or Request a Feature

Open an issue on GitHub. The team monitors daily and labels good-first-issue tasks for new contributors.

Rust API Reference

Browse generated rustdoc output for Mountain, Echo, Air, and 11 more Rust crates.

Start

Introduction

What Editor.Land is, how it is built, and what it can do today.

Getting Started

How to build and run Editor.Land from source on macOS or Windows.

Installation

Build requirements and source installation steps for macOS and Windows.

Quickstart

What you can do after a successful source build on macOS or Windows.

Architecture

Architecture Overview

How Editor.Land's elements fit together: two processes, two IPC channels, one extension API.

Local-First Protocol

Air Daemon protocol design: discovery, sync, and conflict resolution.

Usage

Configuration

Settings, keybindings, themes, and language configuration in Editor.Land.

Development

Extension Development

Build and test extensions for Editor.Land using the VS Code extension toolchain.

API Reference

VS Code extension API coverage in Editor.Land: what works, what no-ops, and what is not yet implemented.

Community

Contributing

How to contribute code, documentation, or translations to Editor.Land.

Support

Troubleshooting

Common issues and their solutions when running Editor.Land on macOS or Windows.

Element

Mountain

The Rust + Tauri native kernel that replaces Electron in Editor.Land. Runs on macOS and Windows today, with Linux in progress.

Cocoon

The Node.js extension host that runs VS Code extensions via an Effect-TS fiber runtime, communicating with Mountain over a bidirectional gRPC channel.

Wind

The Effect-TS service layer that provides typed workbench interfaces to Sky.

Sky

The Astro workbench UI that renders the editor interface inside WKWebView (macOS) or WebView2 (Windows).

Air

The Rust background daemon responsible for updates, downloads, release signing, and platform-native service lifecycle management.

Echo

The work-stealing task scheduler embedded inside Mountain's Rust binary.

Vine

The protobuf schema and bidirectional gRPC transport layer connecting Mountain and Cocoon.

Grove

The WASMtime and Rhai extension sandbox — capability-based security for Editor.Land extensions.

Common

The abstract foundation that makes every element testable in isolation.

Mist

The DNS sandbox that resolves *.editor.land locally, eliminating public DNS dependency.

Rest

The OXC-powered TypeScript compiler for Editor.Land's build pipeline.

Output

The VS Code build transformation pipeline that adapts VS Code's compiled output for Editor.Land's native stack.

SideCar

Cross-platform Node.js binary distribution compiled per target triple.

Worker

The Service Worker that serves VS Code application assets inside WKWebView and WebView2.

Maintain

The build orchestrator with Rhai scripting and deterministic output.

Technology

Why Rust

Memory safety without garbage collection, native speed, and fearless concurrency.

Why Tauri

The OS's own renderer instead of a bundled Chromium: 60-80% less RAM.

Why Effect-TS

Typed errors, structured concurrency, and dependency injection for TypeScript.

Why gRPC

Typed contracts at the wire: change a field, break every consumer at compile time.

Why WebAssembly

Capability-based extension isolation enforced by the runtime.

License

Why CC0

Public domain dedication: fork it, ship it, sell it, no restrictions.

How Land Replaces VS Code's Electron Stack

VS Code runs on Electron: a Chromium browser, a Node.js runtime, and a single-threaded extension host. Land replaces each piece with an independent element that preserves the VS Code extension API while eliminating the architectural constraints. Browse individual elements in the Element section above, or explore all fifteen repositories on GitHub.

Mountain Cocoon Wind Sky Air Echo Common Vine Mist Rest Output Grove Worker SideCar Maintain

View all repositories ↗

Backend Services

Four Cloudflare Workers power the Land backend infrastructure:

Auth↗ - OAuth 2.0, JWT session tokens, and Auth0 integration
Download↗ - Binary distribution, release metadata, and update checks
Status↗ - Health checks and uptime monitoring
Analytics↗ - Privacy-first usage telemetry routed through Cloudflare Analytics Engine