Skip to main content

What is Sher?

Sher is a CLI tool that builds your frontend project and gives you a live preview URL in seconds. Instead of pushing to a branch and waiting for CI/CD or setting up a Vercel project, you can share your work instantly with a single command.
sher link
That’s it. Sher builds your project, uploads it, and returns a shareable URL that expires after 24 hours by default.

The Problem Sher Solves

Sharing work in progress is harder than it should be:
  • Git commits for every demo - You don’t want to commit half-finished work just to show someone
  • Complex CI/CD setup - Preview deployments require branch protection, webhooks, and configuration
  • Slow feedback loops - Waiting for builds to run before sharing a link wastes time
  • Overhead for quick tests - Sometimes you just want to see if something works on mobile or share a quick prototype
Sher removes all of this friction. Build locally, get a link, share it.

Key Features

Framework Auto-Detection

Automatically detects Vite, Next.js, Astro, Create React App, and custom build setups

Package Manager Support

Works with npm, yarn, pnpm, and bun - no configuration needed

Static Export Handling

Next.js projects are automatically configured for static export

Password Protection

Protect your previews with passwords (Pro tier)

Ephemeral URLs

Links expire automatically (6 hours to 7 days depending on tier)

Deployment Management

List and delete your active deployments

Use Cases

Quick Client Previews

Show clients work in progress without deploying to production or creating a staging branch:
sher link --ttl 48
Send the link, get feedback, iterate.

Testing on Real Devices

Quickly test your local build on mobile devices without ngrok or network configuration:
sher link --no-build
Open the URL on your phone and test immediately.

AI Coding Agents

Sher is designed to work with AI agents that need to deploy what they build. Install the agent skill:
px skills add sherdotsh/sher
Agents can use sher link to deploy their work and return a live URL.

Team Collaboration

Share prototypes and experiments with teammates without cluttering your Git history:
sher link --pass
The link is password-protected and expires automatically.

How It Works

1

Build Detection

Sher detects your framework (Vite, Next.js, Astro, etc.) and package manager (npm, yarn, pnpm, bun) automatically.
2

Build Execution

Runs your build script (typically npm run build) to generate static output.
3

File Collection

Collects all files from your output directory (dist/, build/, or out/).
4

Upload & Deploy

Uploads files to Cloudflare R2 and returns a public URL hosted on Cloudflare Workers.
Sher runs entirely on Cloudflare infrastructure (Workers + R2) and can be self-hosted if needed.

Pricing Tiers

Sher offers three tiers to fit different use cases:
FeatureFreeStarterPro
Price$0$0 (GitHub login)$8/mo
Links per day125200
Max TTL6 hours24 hours7 days
Max upload size10 MB50 MB100 MB
Password protection--
List & delete links-
Run sher login to authenticate with GitHub and unlock the Starter tier (free). Run sher upgrade to subscribe to Pro.

Next Steps

Installation

Install Sher globally with npm, yarn, pnpm, or bun

Quickstart

Deploy your first project in under 60 seconds

Build docs developers (and LLMs) love