shersh

sher

Instant preview links for your projects.

Website · Why? · Pricing · Blog · Report Bug

Sharing your work in progress shouldn't require setting up a Vercel project or pushing to a branch for a preview deploy. sher is a CLI that builds your frontend project and gives you a live preview URL in seconds, so you can just send a link instead. It works with Vite, Next.js, Astro, and anything else that produces static output. It's also a great fit for AI coding agents that need to deploy what they build and hand you a live URL. Install the agent skill with npx skills add sherdotsh/sher.

$ sher link

  sher — share your work

  framework  Vite
  building   npm run build

  files      12 files (194KB)
  uploading  ⠋

  https://a8xk2m1p.sher.sh  (copied)
  expires 2/19/2026, 11:00 AM

Install

npm i -g shersh

Usage

sher link                  # Build and share
sher link --no-build       # Skip build step
sher link --dir ./my-build # Share a specific directory
sher link --ttl 4          # Set link expiry in hours
sher link --pass           # Password-protect (Pro)
sher link --pass mysecret  # Password-protect with specific password (Pro)

Commands

sher link       # Build project and get a preview link
sher list       # Show your active deployments
sher delete <id># Delete a deployment
sher login      # Authenticate with GitHub
sher logout     # Remove stored credentials
sher whoami     # Show login status and tier
sher upgrade    # Upgrade to Pro ($8/mo)

Tiers

	Free	Starter	Pro
Price	$0	$0 (GitHub login)	$8/mo
Links per day	1	25	200
Max TTL	6 hours	24 hours	7 days
Max upload size	10 MB	50 MB	100 MB
Password-protected links	—	—	✓
List & delete links	—	✓	✓

Supported frameworks

sher auto-detects your project and runs the right build command.

• Vite (React, Vue, Svelte, etc.)
• Next.js (static export, auto-configured)
• Astro
• Create React App
• Any project with a build script and a dist/, build/, or out/ directory

Package managers are also auto-detected (npm, yarn, pnpm, bun).

Self-hosting

sher runs on Cloudflare Workers + R2.

1. Deploy the worker

cd worker
npm install
npx wrangler login
npx wrangler r2 bucket create sher-uploads
npx wrangler kv namespace create KV
# Update the KV namespace ID in wrangler.toml
npx wrangler deploy

2. Set up GitHub OAuth

Create an OAuth App at github.com/settings/developers with callback URL https://your-domain/auth/callback, then:

npx wrangler secret put GITHUB_CLIENT_ID
npx wrangler secret put GITHUB_CLIENT_SECRET

3. Set up billing (optional)

If you want to enable Pro subscriptions via Polar:

npx wrangler secret put POLAR_WEBHOOK_SECRET
npx wrangler secret put POLAR_ACCESS_TOKEN
npx wrangler secret put POLAR_PRO_PRODUCT_ID

4. Point the CLI at your instance

export SHER_API_URL=https://your-worker.workers.dev
sher link

License

AGPLv3