Contributing

We're really glad you're reading this, because we need volunteers to help this project.

Prerequisites

You will need node installed on your computer to run the code. And git to download it:

• node
• git

Download the code

To download the code, use git:

git clone https://github.com/tonaljs/tonal
npm install
npm run build

Development

Modules are written in Typescript and live inside packages/ folder.

If you are adding new functionality or fixing a bug, please add a test for it.

Run test and build the library before submitting a pull request :pray:

npm run test:all

How to add a new module

To create a new module:

• Add a new folder inside packages: packages/my-module
• Add a new package.json inside the folder (see any of them as an example)
• Add required dependencies to "dependencies" inside package.json. Ensure correct dependency versions. For example, if your module needs to use tonal/core look at core's package.json to see what version to use
• Add your functionality and tests
• Ensure everything works: run npm run test:all at root folder
• Create a pull request

Release

Releases are built using changesets: https://turbo.build/repo/docs/handbook/publishing-packages/versioning-and-publishing:

# Create a new branch
git co -b release-4.7.4

# Create a changeset and update versions

npx changeset # Select packages and which version (major, minor, bump)
# (Optional: edit changeset. The header contains the affected packages.)
npx changeset version # Updates version and CHANGELOG of each package

# Create commit and PR
git add .
git commit -m "chore: bump version"

# Build browser
npm run build
git add .
git commit -m "chore: browser build"

# Create PR
git push

# Publish all changed packages to npm
npx changeset publish