@researchgate/node-package-blueprint

Blueprint for scaffolding new node packages

Usage no npm install needed!

<script type="module">
  import researchgateNodePackageBlueprint from 'https://cdn.skypack.dev/@researchgate/node-package-blueprint';
</script>

README

Node Blueprint

Build Status Codecov Dependency Status NPM version

Simplify the creation and open sourcing of front-end projects:

  • 👩‍💻  Start From CLI: generate the perfect starting blueprint for your new project
  • 📐  Project Layout: follow a clear and pre-defined project structure to ease the way to open sourcing
  • 🔧  Integrated Tooling: conciously chosen set of tools, configured and accessible via npm/yarn scripts
  • 🎡  Automated tasks: from commit message checking to changelog generation for releases

We want to make the process of open source projects at ResearchGate simple, and conventional.

When we create a new project, there are a lot of open questions around on how to best structure, document, and which tools to use.

This project provides the guidelines that clarify and facilitate this process.

Getting started

Install Node Package Blueprint as a global npm package:

npm install -g @researchgate/node-package-blueprint

Now create a new project with the CLI tool:

node-package-blueprint my-project
cd my-project/

🏁  Your project is ready! Take a look at the folder contents and when ready, install the dependencies:

yarn install

Once you're ready to release a new version use:

yarn release

This script will calculate the version number based on your commit history – make sure to follow the conventional commits guidelines. The CHANGELOG.md file is automatically updated with the relevant changes.

If it's your first release, you probably do not want to bump a new version into the history.

In such cases, use the --first-release flag:

yarn release -- --first-release

Documentation

Our documentation is structured in sections directly available under the docs folder:

Contributing

We'd love your help on creating Node Package Blueprint!

Before you do, please read our Code of Conduct so you know what we expect when you contribute to our projects.

Our Contributing Guide tells you about our development process and what we're looking for, gives you instructions on how to issue bugs and suggest features, and explains how you can build and test your changes.

Haven't contributed to an open source project before? No problem! Contributing Guide has you covered as well.