Documentation

Everything you need to publish and run projects on Surge—from your first deploy to full automation.

$ npm install --global surge$ surge

New to Surge? Get started—you’ll be live in about a minute.

CLI

The surge command line tool—publishing, previews, revisions, domains, teams, and analytics.

The surge-sdk Node.js library the CLI is built on—embed Surge publishing in your own tools.

The HTTP API the SDK interfaces with—authenticate, upload, and manage projects programmatically.

The hosted service—custom domains, SSL, clean URLs, client-side routing, redirects, and the CDN.