Create your first hosted review environment in under a minute.

Prerequisites

Before you begin, make sure you have:

Step 1: Set Your API Key

Export your API key as an environment variable:

export PREV_API_KEY="your-api-key-here"

You can find your API key in the Dashboard under API Keys.

Step 2: Create Your Review Environment

Navigate to your project directory and run:

prev create . --feedback

That's it! The CLI will automatically detect your project type, package your source code, deploy it, and enable the browser review workflow.

After a few seconds, you'll receive a URL like:

https://k7f2m9xq.prev.sh

The URL contains the unique review environment subdomain. Share it with QA, clients, stakeholders, or demo viewers so feedback stays connected to the running app.

Common Deployment Examples

Deploy with a Custom Subdomain

prev create . --feedback --subdomain my-demo

Your review environment will be available at https://my-demo.prev.sh.

Deploy with a Longer TTL

prev create . --feedback --ttl 7d

The review environment will stay active for 7 days instead of the default 24 hours.

Deploy a Docker Image

prev create --image nginx:latest --port 80

Deploy from a GitHub Repository

prev create --source github.com/user/repo

Deploy with Password Protection

prev create . --feedback --credentials admin:mysecretpass

What Happens Behind the Scenes

  • The CLI packages your project into an archive
  • Your code is sent to the prev API
  • A Docker image is built based on your project type
  • The image is deployed to our infrastructure
  • A unique URL is generated and returned to you
  • The feedback workflow is attached when you use --feedback

    • Next Steps