Skip to content

sherdotsh/sher

Repository files navigation

sher

sher

Instant preview links for your projects.

npm version License Issues Beta


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

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages