# Contributing

Thanks for your interest in contributing! 🎉

## Code of Conduct

This project follows the [Contributor Covenant](CODE_OF_CONDUCT.md).
By participating, you agree to uphold its standards.

## How to Contribute

### 🐛 Report Bugs

Open a [Bug Report](https://github.com/klimadev/vendas_oficina/issues/new?template=bug_report.md)
with:
- Clear title and description
- Steps to reproduce
- Expected vs actual behavior
- Logs or screenshots if applicable

### ✨ Suggest Features

Open a [Feature Request](https://github.com/klimadev/vendas_oficina/issues/new?template=feature_request.md)
explaining what you want, why, and any alternatives considered.

### 🧑‍💻 Code

1. Fork the repo
2. Create a branch: `git checkout -b feat/my-feature`
3. Make your changes
4. Run `npm install` and test your changes
5. Commit using [Conventional Commits](https://www.conventionalcommits.org/)
6. Push and open a Pull Request

### ✅ PR Checklist

- [ ] Code follows existing style
- [ ] Dependencies are necessary (no speculative additions)
- [ ] PR description explains _what_ and _why_
- [ ] Related issues are linked

## Development Setup

```bash
npm install
cp .env.example .env   # fill in your keys
npm run dev
```

## Style

- ES modules (`import` / `export`)
- JSDoc types on exported functions
- No unnecessary abstractions (YAGNI)
- Errors are caught and logged, never silently swallowed

## Questions?

Open a [Discussion](https://github.com/klimadev/vendas_oficina/discussions).