# Contributing to spotatui

Thanks for your interest in spotatui! 💚 We welcome all kinds of contributions, not just code.

## Ways to Contribute

### 🐛 Report Bugs
Found something broken? [Open an issue](https://github.com/LargeModGames/spotatui/issues/new) with:
- What you expected vs what happened
- Steps to reproduce
- Your OS and spotatui version

### 💡 Suggest Features
Have an idea? Start a [Discussion](https://github.com/LargeModGames/spotatui/discussions) or open an issue. We love hearing what would make spotatui better for you.

### 📖 Improve Documentation
- Fix typos or unclear instructions
- Add examples or clarify setup steps
- Translate docs (we'd love to support more languages!)

The wiki is included as a submodule in `spotatui.wiki/`. To contribute:
```bash
git clone --recurse-submodules https://github.com/LargeModGames/spotatui.git
# Make your changes in spotatui.wiki/
# Then commit and open a PR
```

### 🎨 Create Themes
Love customization? Add a new theme preset! Check out `src/user_config/theme.rs` for examples.

### 🧪 Test on Your Setup
- Try pre-releases and report issues
- Test on unusual setups (BSD, WSL, specific distros)
- Verify audio works with different backends

### ⭐ Spread the Word
- Star the repo
- Share spotatui with music lovers
- Write about your experience

---

## Code Contributions

### Ground Rules
- Be kind and follow our [Code of Conduct](CODE_OF_CONDUCT.md)
- Open an issue first for new features or larger refactors
- Keep PRs focused and scoped for easier review

### Getting Set Up

1. Install a recent stable Rust toolchain (`rustup` recommended)
2. Install platform dependencies from [Development](README.md#development):
   - OpenSSL
   - `xorg-dev` (Linux; clipboard support)
   - PipeWire dev libraries (Linux; audio visualization)
   - `portaudio` via Homebrew (macOS)
3. Clone your fork and create a topic branch from `main`

Run locally:
```bash
cargo run
```

Slim build (no audio/streaming):
```bash
cargo run --no-default-features --features telemetry
```

### Before Opening a PR

Run these checks (same as CI):
```bash
cargo fmt --all
cargo clippy --no-default-features --features telemetry -- -D warnings
cargo test --no-default-features --features telemetry
```

### PR Tips
- Add/adjust tests when changing behavior
- Update `README.md` and `CHANGELOG.md` for user-facing changes
- Include screenshots for UI changes
- Keep commits logical; squashing welcome but not required

---

## Recognition

We use [all-contributors](https://allcontributors.org/) to recognize everyone who helps—code or not! After your contribution is merged, the maintainer will add you to the contributors list.

## Questions?

Start a [Discussion](https://github.com/LargeModGames/spotatui/discussions) or ping us in an issue. We're happy to help!