Contributing

Contribution Workflow

1. Fork the project
2. Set up your development environment
3. Make your feature addition or bug fix
4. Ensure all quality checks pass
5. Submit a pull request

Development Setup

• Install Node.js 22 or later
• Install pnpm
• Install Docker (for CLI and extension development)

# Clone your fork
git clone https://github.com/mburumaxwell/paklo.git
cd paklo

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

Quality Checks

Before submitting a pull request, ensure these checks pass:

Linting

pnpm lint

Tests

pnpm test

Formatting

pnpm format:check        # check for formatting issues
pnpm format              # fix formatting issues

Spelling

pip install codespell
codespell                   # check for misspellings
codespell --write-changes   # fix misspellings

Submitting Changes

1. Fork the repository and create your branch from main
2. Make your changes and ensure all quality checks pass
3. Write clear, descriptive commit messages
4. Open a pull request with a clear description of your changes