surge
Instant static website publishing platform
TLDR
Deploy current directory
SYNOPSIS
surge [directory] [domain]
DESCRIPTION
surge is a static website publishing platform that deploys web projects with a single command. Point it at a directory containing HTML, CSS, JavaScript, and other static assets, and it instantly publishes to a *.surge.sh subdomain or a custom domain.
All deployments include free SSL certificates for HTTPS. Custom domains are supported at no additional cost, requiring only a DNS CNAME record. The platform is designed for front-end developers who need fast, simple hosting without server configuration.
Authentication tokens enable automated deployments in CI/CD pipelines. The list command shows all deployed projects, and teardown removes a deployment. Surge is particularly popular for publishing documentation sites, single-page applications, and project demos.
PARAMETERS
directory
Path to deploy.domain
Custom domain.list
Show projects.teardown DOMAIN
Remove project.login
Authenticate.logout
Log out.whoami
Show user.token
Get auth token.
CAVEATS
Static sites only. No server-side code. Free tier has limitations.
HISTORY
Surge was created for simple static site hosting. It provides instant deployment for front-end developers.
