Have a nice time documenting components.

Create a beautiful documentation for your components writing dead simple files.

Live Demo

Features

  • Lightning Setup

    No rules. No loaders. No regex. Ship your docs with a couple of super simple declarations.

  • Wide Support

    Support for legacy and modern frameworks. Perfect for companies migrating from AngularJS to Vue or React.

  • Playground

    Prototype and share component compositions with your workmates.

  • Analytics Integration

    Find out which components people are most interested in.

  • Fully Customizable

    Use your own logo, favicon, window title and everything else you want.

  • Open Source

    Forever free and lovely crafted.

Basics

  • Install

    Pitsby is available via npm.

    npm install -g @glorious/pitsby
  • Setup

    Pitsby is based on two types of file. Choose a technology to see how simple they are.

    Pitsby configuration should be created in the root directory of the project which you want the website will be created for. It’s responsible to tell Pitsby where *.doc.js files are, among other things.

    You should create one *.doc.js file per component per engine. If your project makes components available for more than one technology, each of them needs to have its own *doc.js file.

  • Build

    Once you have set up a configuration file and, at least, one documentation file, you can easily generate the website running:

    pitsby build

    You can see the result serving it with http-server or any other lib that you prefer:

    http-server ./pitsby
  • Watch

    To keep Pitsby watching the changes that you make on any file listed on on the configuration file, run:

    pitsby build --watch

    The website will be running on http://localhost:7000.

Recommendations

Seamless. Beautiful. Declarative.