Quick Start

After installing Hatch and running hatch init + hatch up, you’re ready to add your first project.

Add a project

There are two ways to register a project with Hatch.

hatch add myapp --proxy http://localhost:3000

This creates a project called myapp accessible at https://myapp.test, proxying to your local dev server on port 3000.

Create a hatch.yml in your project directory:

domain: myapp.test
services:
  web:
    proxy: http://localhost:3000

Then link it:

cd ~/projects/myapp
hatch link

See Per-Project Config for when to use each approach.

Open your project in the browser:

hatch open myapp

Or navigate directly to https://myapp.test. You should see a green lock with no certificate warnings.

hatch status

This shows the daemon state and all configured projects with their health status.