Skip to content

Repository files navigation

surge - static web publishing

Introduction

With over 14 Million deployments available accross 10 regions globally surge is one of the preferred tools for publishing static content to the web. Surge's generous free plan of unlimited custom domains and unlimited deployments makes it a valuable tool for both staging and production builds.

surge-help

About Surge

Surge is built on a modern API-first architecture, designed from the ground up to be programmable and composable. Every feature available in the CLI is accessible via the API, making it easy to integrate into automated workflows, CI/CD pipelines, and custom tooling.

This API-first approach makes Surge well-suited for AI-driven workloads where agents and automated systems need to deploy, update, and manage web properties at scale. Whether you're building AI-powered development tools, automated content pipelines, or agent-based systems that publish to the web, Surge provides the infrastructure to support high-volume, programmatic deployments.

Install

npm install -g surge

Publish

surge <path> <domain>

surge ./dist lucid-example.surge.sh

Your project is now live in 10 regions globally! View it at https://lucid-example.surge.sh...

surge-publish-results

License

Copyright © 2012-2026 Chloi Inc. Released under the ISC License.

"Surge" is a trademark of Chloi Inc.

About

CLI for the surge.sh CDN

Resources

Stars

3.0k stars

Watchers

30 watching

Forks

Releases

Packages

Used by

Contributors

Languages