Skip to content

Contributing to oneRepo

Use the Bug Report issue template.

The template will guide you through asking for extra information. Fill out as much as possible to help maintainers help you faster.

Use the Feature Request issue template.

Ensure you have the following before beginning:

  • ✅ Using a supported version of Node.js (^18 || ^20).
  • ✅ Node.js’s corepack is enabled.
  • ✅ The oneRepo CLI is installed.
  • ✅ Forked and cloned the repository.
  1. Use the one command-line interface directly from the installed command.

    The CLI will properly pass-through and run the local source, so all of your changes will instantly be available for debugging.

  2. Make your code changes.

  3. Do your best to make changes easy to review:

    • ✅ Add and update tests
    • ✅ Adjust tsdoc comments
    • ✅ Add documentation
    • ✅ Ensure a pre-commit hooks run and pass
  4. Create your pull request against the oneRepo repository.

    Ensure that you check the box to “Allow edits and access to secrets by maintainers”. This will allow maintainers to help, collaborate, and move your changes through quicker with fewer back-and-forth requests.

  1. Run the documentation application:

    Terminal window
    one workspace docs start
  2. After tsdoc or other code changes, collect the content to see generated updates:

    Collect all content
    one workspace docs collect-content
    Update API reference
    one workspace docs typedoc

Always capitalize the following words unless referred to in a context outside of their meanings from the glossary:

  • Monorepo
  • Root
  • Workspace
  • Graph

When you submit code changes, your submissions are understood to be under the same MIT License that covers the project.