CONTRIBUTING.md

Contributing

Please read in detail about how to contribute documentation and code on the Mermaid documentation site.

---

Mermaid contribution cheat-sheet

Requirements

• volta to manage node versions.
• Node.js. volta install node
• pnpm package manager. volta install pnpm

Development Installation

If you don't have direct access to push to mermaid repositories, make a fork first. Then clone. Or clone directly from mermaid-js:

git clone git@github.com:mermaid-js/mermaid.git
cd mermaid

Install required packages:

# npx is required for first install as volta support for pnpm is not added yet.
npx pnpm install
pnpm test

Docker

If you are using docker and docker-compose, you have self-documented run bash script, which is a convenient alias for docker-compose commands:

./run install # npx pnpm install
./run test # pnpm test

Testing

# Run unit test
pnpm test
# Run unit test in watch mode
pnpm test:watch
# Run E2E test
pnpm e2e
# Debug E2E tests
pnpm dev
pnpm cypress:open # in another terminal

Branch name format:

   [feature | bug | chore | docs]/[issue number]_[short description using dashes ('-') or underscores ('_') instead of spaces]

eg: feature/2945_state-diagram-new-arrow-florbs, bug/1123_fix_random_ugly_red_text

Documentation

Documentation is necessary for all non bugfix/refactoring changes.

Only make changes to files that are in /packages/mermaid/src/docs

DO NOT CHANGE FILES IN /docs

Join our slack community if you want closer contact!