@chisel/fluorite

An easy-to-use API documentation generator.

Usage no npm install needed!

<script type="module">
  import chiselFluorite from 'https://cdn.skypack.dev/@chisel/fluorite';
</script>

README

Fluorite Logo

Fluorite

Fluorite is an easy-to-use API documentation generator, built to allow rapid development of API documentations (RESTful and other types of APIs) while being flexible in design.

Fluorite

Fluorite encourages modular structures, therefore, the documentation is made of different files grouped together as sections through a JSON configuration file named flconfig.json. Files are either JSON files (for documenting RESTful APIs) or pure Markdown (for other documentations,) all loaded into one or more HTML pages to form the documentation.

Fluorite is also flexible in design through themes. Each theme decides on the documentation layout and can even define extra features using the provided utility libraries, independent of any pre-defined mechanism. You can easily make your own themes using the Handlebars templating language and have your documentations look exactly the same as your website/web app.

Installation

  • Make sure you have Node.js and NPM installed
  • Install Fluorite globally: npm install @chisel/fluorite -g

Quick Start

  • Create a new project: fl new <name> (example fl new docs)
  • Inside the project directory run fl serve to build and serve
  • Visit http://localhost:6001

Full Documentation

Fluorite is heavily documented using Fluorite! We strongly recommend you to read the official documentation after playing around with Fluorite to fully benefit from its features.