Thank you for your interest in contributing!

Quick Start

# Fork and clone
git clone https://github.com/YOUR_USERNAME/natilius.git
cd natilius

# Setup
make dev-setup

# Create branch
git checkout -b feature/your-feature

# Make changes, test
make test && make lint

# Submit PR
git push origin feature/your-feature

Ways to Contribute

• Report Bugs — GitHub Issues
• Suggest Features — GitHub Discussions
• Improve Docs — Documentation PRs welcome
• Add Modules — See Creating Modules

Guidelines

Code Standards

• Bash 3.2+ (macOS compatibility)
• Pass ShellCheck: make lint
• Pass tests: make test
• Quote variables: "$variable"

Commit Messages

Use Conventional Commits:

feat(python): add Python 3.12 support
fix(homebrew): handle missing taps
docs(readme): update installation

Pull Requests

• One feature per PR
• Include tests
• Update docs if needed
• Reference related issues

Code of Conduct

Be respectful. See CODE_OF_CONDUCT.md.