surge
Instant static website publishing platform
TLDR
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 for CI/CD use.--project path
Specify project directory.--domain domain
Specify target domain.--token token
Provide auth token (for CI/CD).
CAVEATS
Static sites only; no server-side code. Free tier has limitations. Custom domains require a DNS CNAME record pointing to na-east1.surge.sh.
