Need help with napa?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

412 Stars 32 Forks MIT License 124 Commits 20 Opened issues


:wine_glass: A helper for installing stuff without a package.json with npm.

Services available


Need anything else?

Contributors list

napa Build Status AppVeyor Code Climate David js-standard-style

A helper for installing repos without a

with npm.



Install with

npm install napa --save-dev
then setup your local
scripts as such:
  "scripts": {
    "install": "napa username/repo"

Now when you run

npm install
it will
git clone git:// node_modules/repo

Want to name the package something else?

  "scripts": {
    "install": "napa username/repo:adifferentname"

Now it will install to


Want to install a package not on github?

  "scripts": {
    "install": "napa git://"

Multiple packages?

  "scripts": {
    "install": "napa user/repo1:dude user/repo2:rad user/repo3:cool"

Prefer a more structured approach?

  "scripts": {
    "install": "napa"
  "napa": {
    "foo": "username/repo",
    "bar": "[email protected]:user/repo"

Looking to just download a tagged release/a branch/a specific commit on github or just a zip or tar.gz url?

  "scripts": {
    "install": "napa"
  "napa": {
    "foo": "username/repo#v1.2.3",
    "bar": "username/bar#some-branch",
    "baz": "username/baz#347259472813400c7a982690acaa516292a8be40",
    "qoo": "",
    "fuz": "git+",
    "goo": "git+ssh://"

Additional configuration

The application currently supports the following configuration options under a

property in

Option name

Default value Desctiption

| Set to
to completely disable package caching
| Override default path to a specific location
(relative to the current working directory)
| Set the log level:
  "napa-config": {
    "cache": false,
    "cache-path": "../.napa-cache",
    "log-level": "error"

Using Node.js < 4?

Please use

npm install [email protected]
and upgrade your Node.js.

Release History

Please view for history.

  • 2.0.1
    - Fix path must be a string error (@caseyWebb).
  • 2.0.0
    - Better detection for GitHub repos, fixes when creating a
    , cached git
    urls now get updated properly (@tomekwi). Add config options for disabling cache or setting cache path (@bbsbb). Fix for npm 3 erroring when
    folder present (@caseyWebb). Updating dependencies.
  • 1.2.0
    - Callback optional with CLI and do not ignore
    files when unpacking (@dai-shi).
  • 1.1.0
    - Upgrade download for better downloads behind proxies (@msieurtoph).
  • 1.0.2
    - Fix references to git specifiers. Thanks @jsdevel!
  • 1.0.1
    - Fix path to CLI.
  • 1.0.0
    - Avoids duplicate installs and will install from cache.
  • 0.4.1
    - Fix git reporting non-errors on stderr by running in quiet mode.
  • 0.4.0
    - Add
    strip: 1
    when downloading to avoid untarring within a sub-directory. Thanks @seei!
  • 0.3.0
    - Ability to download packages using any URL
  • 0.2.0
    - Ability to set packages using napa key in
  • 0.1.1
    --depth 1
    for faster cloning
  • 0.1.0
    - initial release


Copyright (c) 2017 Kyle Robinson Young Licensed under the MIT license.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.