Skip to content

MatejBransky/monorepo

Repository files navigation

monorepo-template

A basic Lerna monorepo with Yarn Workspaces, Conventional Commits and GitHub Actions workflow configuration to achieve fully automated package publishing to the NPM registry. As a bonus Renovate bot keeps dependencies up to date.

Create a new repository from this template

Click the Use this template button and provide the new repository details.

Getting Started

Let's start by setting up the new repository:

  1. To perform authenticated operations against the npm registry in your workflow, you'll need to store your npm authentication token as a secret NPM_TOKEN. For more information, see "Creating and using encrypted secrets." (source)

  2. Update the root package.json with your repository name and url.

  3. Modify the sample packages as needed and remember to update their package.json.

  4. Run yarn to bootstrap the packages. This will install all of their dependencies and links any cross-dependencies.

How it works

Each push to main branch will generate a version number, git tag, Conventional Changelog, release commit, pushing changes to the origin and publish to the NPM registry.