Pier
Docs

Documentation

Usage

Run apps with host mapping, bridge commands, and diagnostics.

Start an App with Portless + Pier Mapping

From the project directory you want the terminal to use:

pier myapp pnpm dev

This will:

  • register myapp.localhost to current working directory
  • ensure the Pier bridge is running
  • run portless with your dev command

Multiple Apps in Parallel

pier web pnpm dev
pier api pnpm dev
pier admin pnpm dev

Each app gets:

  • its own hostname under *.localhost
  • separate browser storage isolation via portless
  • a Pier terminal rooted in the mapped repo directory

Mapping Commands

pier map list
pier map add docs.localhost /path/to/docs-repo
pier map remove docs.localhost
pier map where docs.localhost

Bridge Commands

pier bridge start
pier bridge start --foreground
pier bridge stop
pier bridge status
pier bridge logs

Diagnostics

pier doctor

pier doctor prints bridge state, config paths, and extension connection values.