now-serve travis-ci npm

Single-command static hosting

3 years after


Build Status XO code style Slack Channel

This packages makes it very easy to share directories using now!

How it works

When running the ns command, a temporary directory gets created. Within that directory, now-serve will insert a brand new package.json that conforms to now's requirements and therefore contains a start script that runs a new instance of list when being executed on our servers.

All of this happens completely automatically. So after running the command, the only thing you need to do is wait a few seconds until your files have been deployed and share the link! :boom:


Install it (needs at least node v6)

$ npm install now-serve -g

Run it

$ ns <file | dir> [options] 

You can find a list of all options below.


Usage Description
-h, --help Output all available options
-V, --version The version tag of the now-serve instance on your device
‑c, ‑‑cmd [command] The command that should be run when starting
-n, --name [name] The name for your deployment
‑p, ‑‑packages <names> Custom packages to add to dependencies: "gulp, koa"
-a, --arguments A string containing arguments that will be passed on to now: "force, debug" (basically the names of the flags but without dashes)
-s, --single Serve single page apps with only one index.html in the root directory


  1. Fork this repository to your own GitHub account and then clone it to your local device
  2. Uninstall now-serve if it's already installed: npm uninstall now-serve -g
  3. Link it to the global module directory: npm link
  4. Transpile the source code and watch for changes: npm start

Yeeha! Now can use the ns command everywhere.

Related Repositories



JavaScript, SCSS, Sass, Less, and Stylus helpers for rendering high-resolution i ...



Build a Jekyll blog in minutes, without touching the command line. ...



Single-command HTTP directory listing and file serving ...



Instantly deploy your Meteor apps with `meteor-now` ...



Hello, create-react-app, meet Zeit's awesome service. ...

Top Contributors

leo greenkeeperio-bot rauchg samjbmason OlliV timolins vinnymac wesbos


-   0.5.1 zip tar
-   0.5.0 zip tar
-   0.4.0 zip tar
-   0.3.1 zip tar
-   0.3.0 zip tar
-   0.2.0 zip tar
-   0.1.0 zip tar