# Contributing

Contributions are welcome through issues and pull requests.

## Report bugs

When reporting a bug, include:

- your operating system,
- your terminal emulator,
- clear reproduction steps,
- any relevant error output or screenshots.

## Suggest enhancements

If you want to propose a feature or UX improvement, open an issue first so the approach can be discussed before implementation.

## Pull request flow

1. Fork the repository.
2. Create a feature branch.
3. Make the change and add tests when appropriate.
4. Run the local checks.
5. Open a pull request.

## Design expectations

The project favors:

- responsive terminal interactions,
- cross-platform behavior,
- polished TUI details such as search, previews, and feedback states.

For broader contribution guidance, see the repository root `CONTRIBUTING.md`.