Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including micro-list with all npm packages installed. Try it out:

micro-list lists no main file and has no index.js, so it can't be directly required. If this is a mistake, please let us know. It may however contain internal files that you can require manually:

// require("micro-list/[??]")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

micro-list v0.8.0

Single-command HTTP directory listing and file serving


Build Status XO code style Slack Channel

Ever wanted to share a certain directory on your network by running just a command? Then this module is exactly what you're looking for: It provides a neat interface for listing the directory's contents and switching into sub folders.

In addition, it's also awesome when it comes to serving static sites. If a directory contains an index.html, micro-list will automatically render it instead of serving the file's content as plaintext.

Powers now-serve.


Install it (needs at least node v6)

$ npm install -g micro-list

Run it

$ list [options] <path>

You can find a list of all options below.


UsageDescriptionDefault value
-h, --helpOutput all available options-
-v, --versionThe version tag of the micro-list instance on your device-
-p, --port [port]A custom port on which the app will be running3000
-c, --cache [seconds]How long static files should be cached in the browser3600
-s, --singleServe single page apps with only one index.html in the root directory-
-u, --unzippedDisable gzip compressionfalse


  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 -g micro-list
  3. Link it to the global module directory: npm link
  4. Transpile the source code and watch for changes: npm start

Yey! Now can use the list command everywhere.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free