Pier
Docs

Documentation

Setup

Install Pier, load the extension, and validate your first run.

Install (Published Package)

npm install -g portless @malviyahimanshu/pier

Initialize Pier

pier setup

pier setup creates ~/.pier/config.json if missing, starts the local bridge server, and prints the WebSocket URL and token for the extension.

Load the Chrome/Chromium Extension

  1. Run pier extension path
  2. Open chrome://extensions
  3. Enable Developer mode
  4. Click Load unpacked and select the printed directory

Configure Extension Settings

Open Pier Settings and paste the WebSocket URL and access token from setup. Use Test Bridge before opening localhost pages.

First-run Validation

  1. Verify pier bridge status reports running
  2. Start an app with pier myapp pnpm dev
  3. Open your localhost URL and press Ctrl+` on macOS or Ctrl+` on Windows/Linux
  4. Confirm terminal opens in the mapped project directory