Park a directory, get .test domains with HTTPS — automatically. No config files, no Docker, no port juggling.

nalet park ~/Sites
nalet start
# https://my-app.test is live

Install

# Homebrew (recommended)
brew install mohmmedashraf/nalet

# Desktop app (via Homebrew)
brew install --cask mohmmedashraf/nalet

# npm
npm install -g nalet

Quick Start

# One-time setup — installs dnsmasq, Caddy, and generates a local CA certificate
nalet install

# Park a directory — auto-detects all Node.js projects inside
nalet park ~/Sites

# Start all dev servers
nalet start

# Open in your browser
open https://my-app.test

Supported Frameworks

| Framework | Detected By | |-----------|-------------| | Next.js | next.config.{js,mjs,ts,mts} | | Nuxt | nuxt.config.{js,ts} | | Remix | remix.config.{js,ts} | | Astro | astro.config.{mjs,js,ts} | | SvelteKit | svelte.config.{js,ts} | | Gatsby | gatsby-config.{js,ts,mjs} | | Eleventy | .eleventy.js, eleventy.config.{js,cjs,mjs} | | Vite | vite.config.{js,ts,mjs} |

How It Works

Browser → *.test DNS (dnsmasq) → Caddy reverse proxy → nalet-managed dev server

1. dnsmasq resolves all *.test domains to 127.0.0.1
2. Caddy reverse-proxies each domain to the correct port with auto-HTTPS
3. Nalet manages dev server processes, assigns stable ports, and generates TLS certificates signed by a local CA

CLI

nalet install           Set up dnsmasq, Caddy, and CA cert
nalet uninstall         Remove all nalet system config

nalet park [dir]        Park a directory (default: cwd)
nalet unpark [dir]      Stop watching a parked directory
nalet link [dir]        Link a single project
nalet unlink <name>     Remove a linked site

nalet start             Start all dev servers + proxy
nalet stop              Stop everything
nalet restart [name]    Restart a site or all sites

nalet list              Show all sites with status
nalet logs <name>       Tail logs for a site
nalet open <name>       Open site in browser

nalet secure <name>     Enable HTTPS for a site
nalet unsecure <name>   Disable HTTPS for a site

nalet gui               Launch the desktop app

Desktop App

Nalet ships with a Tauri v2 desktop app for managing everything from your menu bar.

• Site dashboard with start/stop controls
• Log viewer per site
• Settings panel
• System tray with quick access

Note: If macOS shows "unidentified developer" on first launch, right-click the app and select Open. If you downloaded the .dmg manually and macOS says it's "damaged", run:

xattr -cr /Applications/nalet.app

Requirements

• macOS 12+ (Monterey or later)
• Node.js 18+
• Caddy and dnsmasq (installed automatically via nalet install)

Contributing

See CONTRIBUTING.md for setup instructions and guidelines.

License

MIT