Installation

Install the CLI, choose a local-first or hosted lane, and aim for one working capture before you wire anything into CI.

Prerequisites

  • Node.js 18 or higher
  • Chrome browser installed
  • A terminal on macOS, Linux, or Windows with WSL

Install the CLI

Terminal
npm install -g @reshotdev/screenshot

Or with pnpm:

Terminal
pnpm add -g @reshotdev/screenshot

Or with yarn:

Terminal
yarn global add @reshotdev/screenshot

Verify installation

Terminal
reshot --version

This is the default self-serve flow:

Terminal
reshot setup
reshot run
reshot publish
  • reshot setup creates reshot.config.json and picks the right lane
  • reshot run proves the scenario locally
  • reshot publish unlocks hosted review and permanent URLs

Setup

Terminal
reshot setup

reshot setup:

  1. Creates reshot.config.json if it does not exist yet
  2. Lets you choose a local-first or cloud-connected lane
  3. Prints the launch-supported local server command when the target needs one

Launch-supported runtime

For launch-grade captures, run your app with a production-like local server before reshot run. For most Next.js apps that means next build && next start, not next dev.

Read Supported Environments before you wire Reshot into CI or promise production reliability to your team.

Manual initialization

If you prefer to initialize the project manually:

Terminal
reshot init

Authentication

Authentication is optional until you want hosted publish, permanent URLs, or review workflows.

Terminal
reshot auth

Credentials are stored securely in .reshot/settings.json.

Next step

Continue to the Quick Start guide for the full first-value flow.

Installation | Reshot Docs