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
| Flag | Description |
|---|---|
--dir <path> |
Upload a specific directory (skips framework detection) |
--ttl <hours> |
Set link expiry in hours (default: 24) |
--no-build |
Skip the build step (use if already built) |
--pass [password] |
Password-protect the preview (Pro only) |
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/, orout/ - 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:
- Missing build script — add one to
package.json, or use--dir - Build error — fix the error first, then retry
- Size limit — 10MB anonymous, 50MB authenticated, 100MB Pro
- Missing output directory — ensure the build produces
dist/,build/, orout/, or use--dir