node package manager


Static File Manager.

Build Status


Static File Manager


$ npm install node-istatic -g


Put a file named static.yaml (refer to the following Configuration) at the root of your project repository. And then, run:

$ istatic pull


You can specify any git hosting provider, such as:

  gitcafe: git://

Note: iStatic has been added github, bitbucket and local by default.

Specify the git repos info (including name, host, tag or commit) and the path of the files or directories you need. The default host is github, and the default commit (or tag) is origin/master. These two properties can be omitted. But you need to specify one file mapping (origin: target) at least. It sounds to be a little complicated, here's a example:

    host: code
      ./stylus: ./public/css/arkui/
      ./pics: ./public/pics/
    tag: 2.5.1
      ./oz.js: ./public/js/lib/
      ./eventMaster/eventmaster.js: ./public/js/lib/mod/event.js
    host: local
    commit: 7827c7c605
      ./define.js: ./public/js/lib/
      ./mod/touch.js: ./public/js/mod/

Grunt task

Grunt-istatic task now available.

Release History

  • 2013-02-22 - v0.3.1 - Support async callback for grunt-istatic.
  • 2013-02-07 - v0.2.7 - Support local git repos. Format logs. Add --version & clear options.
  • 2012-12-06 - v0.2.5 - Bugfix for pulldown && checking local files modification.


Copyright (c) 2013 mockee Licensed under the MIT license.