sher — deploy to a live preview URL

sher is a CLI that builds your frontend project, uploads it, and returns a live preview URL.

Use it when the user wants to see a frontend project live.

Install

Global (recommended for agents):

npm i -g shersh

Or one-off with npx:

npx shersh link

Deploy

From the project root:

sher link

sher auto-detects the framework, runs the build, uploads the output, and returns a URL.

Options

Examples

sher link                  # standard deploy
sher link --no-build       # already built
sher link --dir ./dist     # specific output directory
sher link --ttl 2          # 2-hour link

Parsing the output

The CLI prints the live URL to stdout:

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

The URL matches https://[a-z0-9]{8}.sher.sh and is copied to the clipboard.

After deploying

Present the URL to the user:

> Your preview is live at https://a8xk2m1p.sher.sh

Mention expiry if --ttl was set, and share the password if --pass was used.

Supported frameworks

sher auto-detects and builds:

• Vite → dist/
• Next.js → static export to out/
• Astro → dist/
• Create React App → build/
• Any project with a build script producing dist/, build/, or out/
• Static HTML — use --dir . to upload directly

Agent-friendly

• Runs headless, with exit code 0 on success
• Works without an account (1 deploy, 10MB, 6h TTL)
• Authenticated: 25 deploys, 50MB, 24h TTL

Troubleshooting

If sher link fails:

1. Missing build script — add one to package.json, or use --dir
2. Build error — fix the error first, then retry
3. Size limit — 10MB anonymous, 50MB authenticated, 100MB Pro
4. Missing output directory — ensure the build produces dist/, build/, or out/, or use --dir