Generate a neat and informative README using customizable components
Report Bug
·
Request Feature
readme-components is a lightweight, easy-to-use tool for generating beautiful, concise and informative README's within seconds. The tool allows you to create templates which can be reused across many projects and makes README writing 100x easier and hassle-free. It requires little knowledge to use and you can get started right away with the following steps.
$ npm install readme-components
import README from "readme-components";
let template = new README();
template.use_component("./templates/header.md", {
name: "My AMAZING README!",
description: "Customizable and reusable!",
});
template.use_component("./templates/license.md", {
author: "John Doe",
email: "john@doe.com",
license: "MIT",
});
template.make_readme();
readme-components
has some premade components
that can be used in your own READMEs.
Simply use .use_premade(template)
in order to make use of them!
import README from "readme-components";
template = new README();
template.use_premade("header", {
name: "my-awesome-readme",
description: "made using a premade header!"
});
template.make_readme();
Making components is just the same as normal markdown. However, anything that needs to be replaced during build needs to be wrapped round with curly brackets and an identifer.
## My {descriptive_word} component
Such a descriptive word.
import README from "readme-components";
template = new README();
template.use_component("./template.md", {
descriptive_word: "incomprehensible",
});
template.make_readme();
Copyright © 2022 Sanjay Sunil (sanjaysunil@protonmail.com)
Distributed under the MIT License. See LICENSE
for more information.