1.0.2 • Public • Published

Welcome to contributing-gen

A generator - A guideline to communicate how people should contribute to your project.

Generate it directly in your browser with the web frontend (contributing-gen-web). 🎉

The generated artifacts should serve as basis, adviser and inspiration. We do not guarantee completeness, but a good starting point for a well-structured guide.

Getting Started

  • Clone this repository
  • Open the terminal, cd to the project folder and run npm install
  • Open the generate.js file and update it with your project information
  • Run npm run gen to generate new files

The files have now been generated and you can copy them into your project repository. And don't forget to mention them in your readme.

In the following listing you see the specification, which you have to fill with your information:

const specs = {
  project: {
    name: "XYZ",
    defaultBranch: "main",
    repoUrl: "",
    docsUrl: "",
  contributing: {
    generate: true,
    emailSensitiveBugs: "",
  codeOfConduct: {
    generate: true,
    // enforcement email must not be omitted if 'generate' is true
    enforcementEmail: "",
    // additional info about how the code of conduct will be enforced
    enforcementGuidelines: false,


Although this project should serve as a good example, we don't have an extra guideline for contributions, since the project has a small scope without any programming. Nevertheless, anyone who wants to participate, in whatever form, must follow our Code of Conduct.

Everyone who has ideas and suggestions for improvement is encouraged to contribute. Be it with a simple issue or a pull request. Our goal is to create the best template for contribution guidelines, which helps every open source developer to create an individual guide. It should be made clear to project owners how comprehensible and simple guidelines are structured and how to encourage the community to participate in the project. And don't hesitate, even if it is just a small typo you have spotted.

The community looks forward to your contributions. 🤩


contributing-gen is released under the MIT License.


For the templates we have looked at several open source projects:

Package Sidebar


Weekly Downloads






Unpacked Size

39.2 kB

Total Files


Last publish


  • bttger