# surge

> Static Web Publishing

Latest version **0.44.4** (published 2026-09-25) · ISC license · 0 weekly downloads

## Install

```sh
npm install surge
pnpm add surge
yarn add surge
bun add surge
```

Provides the command `surge`.

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.44.4 |
| Published | 2026-09-25 |
| First published | 2014-07-18 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=18.13 |
| Dependencies | 17 |
| Unpacked size | 262.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3056 |
| Author | Brock Whitten |
| Maintainers | sintaxi |
| Keywords | surge, harp, static, deploy, publish, hosting, cdn, cli, web, jamstack, frontend, spa |

## Links

- npm: https://www.npmjs.com/package/surge
- Repository: https://github.com/sintaxi/surge
- Homepage: https://github.com/sintaxi/surge#readme
- Issues: https://github.com/sintaxi/surge/issues
- npm.io page: https://npm.io/package/surge

## Dependencies (17)

- [read](https://npm.io/package/read.md) 1.0.5
- [netrc](https://npm.io/package/netrc.md) 0.1.4
- [colors](https://npm.io/package/colors.md) 1.4.0
- [ignore](https://npm.io/package/ignore.md) 7.0.9
- [xbytes](https://npm.io/package/xbytes.md) 1.9.1
- [moniker](https://npm.io/package/moniker.md) 0.1.2
- [prompts](https://npm.io/package/prompts.md) 2.4.2
- [minimist](https://npm.io/package/minimist.md) 1.2.8
- [progress](https://npm.io/package/progress.md) 2.0.3
- [chartscii](https://npm.io/package/chartscii.md) 4.0.3
- [is-domain](https://npm.io/package/is-domain.md) 0.0.1
- [surge-sdk](https://npm.io/package/surge-sdk.md) 0.20.0
- [cli-table3](https://npm.io/package/cli-table3.md) 0.6.5
- [surge-ignore](https://npm.io/package/surge-ignore.md) 0.3.0
- [surge-stream](https://npm.io/package/surge-stream.md) 0.20.0
- [url-parse-as-address](https://npm.io/package/url-parse-as-address.md) 1.0.0
- [human-readable-numbers](https://npm.io/package/human-readable-numbers.md) 0.9.5

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 0.44.4 (latest) — 2026-09-25
- 0.44.3 — 2026-09-18
- 0.44.2 — 2026-09-18
- 0.44.1 — 2026-09-02
- 0.44.0 — 2026-08-28
- 0.43.1 — 2026-08-15
- 0.43.0 — 2026-08-13
- 0.42.1 — 2026-08-12
- 0.42.0 — 2026-08-12
- 0.41.3 — 2026-08-12
- 0.41.2 — 2026-07-31
- 0.41.1 — 2026-07-31
- 0.41.0 — 2026-07-31
- 0.40.2 — 2026-07-29
- 0.40.1 — 2026-07-29
- … 110 more at https://npm.io/package/surge/versions

## README

<h1 align="center"><code>surge</code> - static web publishing</h1>

### 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](https://github.com/user-attachments/assets/5b3e7e92-008e-48b6-9c61-dc4cbf1bf22c)

### 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>

<!-- steno:publish-pair svg -->
![surge ./dist lucid-example.surge.sh](./steno-publish-pair.svg)
<!-- /steno:publish-pair -->

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

![surge-publish-results](https://github.com/user-attachments/assets/9bf53934-de53-4307-98b3-b90ab07c167e)

### License

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

"Surge" is a trademark of Chloi Inc.

---
_Source: https://npm.io/package/surge · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
