arredemo

arre demo!

Véxase arre. Interxección:

1 Voz para facer andar as cabalarías.

Arre, faco!

Véxase demo. Substantivo masculino:

1 Ser imaxinario que representa o mal na tradición popular.

O demo anda sempre tentando a xente.

Intro

arredemo will instantly build a static site for your package, containing:

• Docs page, made from your repo's README.md
• Demo page, made from your demo component (who hasn't a /demo folder, huh?)

For example, arredemo site itself has been built with arredemo.

Install

It's maybe better to install arredemo globally:

npm i -g arredemo

Build your site

This single command will do the magic:

npx arredemo build [init params]

The first time you launch it, the arredemo.json file will be created. You can then tweak it manually for further builds. An arredemo folder will be made, containing the static site. You may want:

• your web server to point to arredemo/index.html
• to add arredemo to your .gitignore file

Site content

Docs page

The docs page will be made from your repo's README.md file. Notice you can include several versions of your package to be documented, not just the current one. arredemo will read them from npm registry.

Demo page

Optionally, you can add to your site a demo page. It's made from a React component. Check demo_entry.

Configuration options

The arredemo.json file will contain arredemo's configuration. It is created he first time you run the build.

UI options

theme

Right now, just default theme is available. Other themes will be (hopefully) added in the future!

favicon

Path to your FavIcon file.

logo

Path to your logo file. It'll be shown in the site's header.

url, company and company_url

Shown in the site's Footer.

Docs

doc_versions

Optional array of values of the versions of your package you want to show Docs for.

Current version (repo time, not necessarily published yet) will be taken by default. For other versions, arredemo will read their README.md from npm registry.

md.strip_details_tag and md.keep_summary_content

Sometimes, for the shake of a better visualization in your repo's GitHub page, you will make use of this HTML tags:

  <details>
  <summary>
    Some title for a toggler
  </summary>

  A lot of lines
  Which are toggled off
  So my GitHub's page is not giant
  But at the same time my sensible content remains there

  </details>

If md.strip_details_tag is true (the default), arredemo will strip out this HTML tags, leaving the inner text.

But, depending on how your use it, you may want to keep the content inside \<summary\>\<\/summary\> or not. Use md.keep_summary_content: true in order to do it (it defaults to false).

Demo

demo_entry

Path to your demo index file.

This file will make a export default of your React component.

Yes: in the future this will be done better and non-React stuff will be compatible too.

If demo_entry: null, no Demo page will be built.

Other commands

Init

npx arredemo init [params]

This will generate a arredemo.json file with default values.

Help

npx arredemo help

Version

npx arredemo version

Changelog

See changelog here