Package Exports

surge
surge/lib/cli

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (surge) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

surge(.sh)

Publish web apps to a CDN with a single command and no setup required.

surge is a Command Line Interface that runs on the nodejs runtime (surge's only external dependency). Surge can be installed using npm (via sudo npm install -g surge). Once installed, surge is available from within your terminal. The following command will deploy the current working directory to the surge servers where the application will be available at sintaxi.com.

$ surge ./ sintaxi.com

Run surge --help to see the following overview of the surge command...

  Usage:
    surge [options]

  Options:
    -p, --project       path to projects asset directory (./)
    -d, --domain        domain of your project (<random>.surge.sh)
    -e, --endpoint      domain of API server (surge.sh)
    -v, --verbose       verbose output
    -V, --version       show the version number
    -h, --help          show this help message

  Shorthand usage:
    surge [project] [domain]

CDN Features

Custom CNAME & custom SSL
Fallback 404.html pages
HTML5 mode 200.html pages
stays out of gits way
supports clean URLs && trailing slashes /
Implicit signup
supports CNAME files

If you’re using tools like Grunt, Gulp, or a static site generator like Jekyll, your files are output into a compile directory like _site/, build/, or www/. From the root of your project, pass Surge the path to this directory to upload your compiled assets.

surge www

You may also add this directory to your .gitignore to keep your compiled assets out of your Git history.