Create a Pull Request

Learn how to contribute your changes back to the project through a well-crafted pull request.

Getting Started

๐Ÿ“ฆ

Prerequisites

1. Fork the project repository

2. Clone your fork locally

3. Setup with npx setup:project

๐Ÿš€

Your First PR

  • 1. Create a feature branch
  • 2. Make your changes (code, docs, tests)
  • 3. Submit a draft pull request

Contribution Workflow

1 Create Feature Branch

$ git checkout -b feature/my-changes

2 Make Changes

Implement your feature, fix bug, or enhance documentation

โ€ข Write new tests, if applicable

โ€ข Update documentation in the appropriate sections

3 Test Your Changes

$ npm run test
$ npm run lint

4 Commit Changes

Use semantic commits (conventional commits)

$ git commit -m "feat: added new component"

See convention guide.

5 Push Branch

$ git push origin feature/my-changes

6 Create PR

Go to GitHub and create a PR from your branch to upstream/main

Include:

  • โ€ข Clear title and description
  • โ€ข Reference any related issues
  • โ€ข Mention if this needs testing

Best Practices

๐Ÿ”ง

Atomic Commits

Break changes into small, logical commits with clear messages.

๐Ÿ“š

Documentation

Update documentation to match changes (add tests, code comments, user guides).

๐Ÿงช

Testing

Include test coverage for all new features and ensure existing tests pass.

๐Ÿค

Responsiveness

Be ready to address feedback promptly for faster review and merge.

Ready to Submit?

When your PR is ready, submit it and we'll review it as quickly as possible. Join our Discord for real-time help.

Open on GitHub