## Contributing & Community

I built **ImgCompress** to end the "software loop" of cloud-based converters. While I started this as a solo project, I welcome fellow developers to help expand our 70+ format support and improve our offline AI models!

<img src="./images/logo_transparent.png" alt="ImgCompress Web UI" width="auto" height="300px" />

> [!TIP]
> **New to the project?** Start with the **[Installation & Setup Guide](https://imgcompress.karimzouine.com/docs/installation/)** to see the tool in action before diving into the code.

### 🛠 Developer Resources
If you want to see how "imgcompress" works or help build the next feature:
* **Zero-Config Dev**: I provide a **Dev Container** setup for VS Code. It comes pre-configured with all 70+ image libraries and the AI environment so you can start coding in seconds.
* **Pro-Grade Testing**: Stability is my priority. Every change is verified by a strict suite of **[Playwright E2E tests](https://imgcompress.karimzouine.com/docs/e2e)** to ensure offline privacy stays intact.
* **Architecture**: [docs/architecture.md](docs/architecture.md) shows how a conversion runs, with diagrams.
* **Join the Roadmap**: Check the [Issue Tracker](https://github.com/karimz1/imgcompress/issues) for `good-first-issue` labels or to suggest a new feature.

### 📖 Official Documentation
I maintain the full technical documentation on my main site to ensure it is always the "Source of Truth":

* **[Contributing Guide →](https://imgcompress.karimzouine.com/docs/contributing)**: My standards for Pull Requests, bug reporting, and feature requests.
* **[Technical Developer Guide→](https://imgcompress.karimzouine.com/docs/developers)**: A deep dive into the internal project structure and local environment setup.
* **[E2E Testing with Playwright →](https://imgcompress.karimzouine.com/docs/e2e)**: How we verify 100% offline stability across all 70+ formats. This guide covers interactive UI debugging, step-by-step trace viewing, and simulating the full CI pipeline to ensure your changes are production-ready.

---
**Love the tool?** [Give it a star on GitHub](https://github.com/karimz1/imgcompress)! It’s the best way to support independent, open-source development. If it saved you real time, you can also [buy me a coffee](https://buymeacoffee.com/karimz1).