Modern

A desktop coding environment with a built-in AI agent, file editor, diff review, and terminal.
Built with Tauri 2, React, and Bun.

---

Quick Start

Prerequisites

• Bun v1.3.0+
• Rust (for Tauri)

Setup

git clone https://github.com/philipp-spiess/modern.git
cd modern
bun install

# Build the server sidecar (required once, and after server changes)
bun run --cwd packages/server build

# Start the app
bun dev

Project Structure

packages/
├── client/    — React frontend (Vite)
│   └── src/
│       ├── components/   — Shell UI (sidebar, tabs, command palette)
│       └── extensions/   — Panel views (agent, files, review, terminal)
├── server/    — Bun backend (oRPC over WebSocket)
│   └── src/
│       ├── extensions/   — Extension logic (agent, files, review, terminal)
│       └── extension.ts  — Extension runtime API
src-tauri/     — Tauri shell (Rust)

Development

# Start dev (Tauri + Vite + Bun server)
bun dev

# Optional: pin the dev web port (default auto-picks from 1420+)
MODERN_DEV_PORT=1500 bun dev

# Type check, lint, format
bun run check

# Format code
bun run format

Tech Stack

• Desktop: Tauri 2
• Frontend: React 19 + Vite + Tailwind CSS 4
• Backend: Bun + oRPC
• AI: Pi coding agent
• Editor: CodeMirror + Shiki
• Quality: oxlint + oxfmt + tsgo