Quick Start

Build and run a native desktop app in three steps.

1. Create a Project

morph new my-app
cd my-app

This scaffolds a project with src/App.mx, style.css, morph.config.json, and TypeScript declarations.

Skip the wizard with flags:

morph new my-app --width 1024 --height 768 --title "My App" --ext mx -y

Use morph new . to scaffold into the current directory.

2. Start Development

morph dev

A native window opens. Edit src/App.mx — the window updates instantly without restarting. On every save, Morph re-runs the pipeline, recompiles your JS logic to a shared library, and pushes the updated IR to the running window.

3. Ship

morph run

Builds an optimized native binary and runs it. morph run compiles first, then launches the binary. Press Ctrl+C to stop.

You can also build without running:

morph build          # compile only
morph build --static # single self-contained binary (bundles GLFW/FreeType)

What Just Happened?

src/App.mx  ──morphc──►  native binary (OpenGL + GLFW)

Morph compiles your .mx file (JSX + CSS + TypeScript) directly to C++ via Oxc + lightningcss, then compiles that to a native binary with g++/clang++. There is no browser, no Node.js, and no interpreter in the final output.

Next Steps

• Project Structure — Understand what morph new generated
• Configuration — All morph.config.json options
• CSS Properties — What CSS you can use
• State & Effects — Reactivity with morphState