# Muslim Icons

> A free, open-source Muslim and Islamic SVG icon library for developers building digital products for Muslim communities.

The explorer contains 104 original SVG icons across 8 categories, synced from source commit 0339a71a083f7115a6932cd268bed1616ede3ec2. The published npm package @muslim-icons/react is v0.2.1 and contains 95 icon exports. The main repository can contain newer SVGs than the current npm release. Each catalog record includes availableInPackage so integrations can check actual release availability. Software is MIT licensed; intended CC0 artwork licensing remains subject to contributor rights confirmation.

## Documentation

- [Project overview and React usage](https://muslimicons.vercel.app/index.md): API examples, categories, release information and licensing.
- [Icon catalog](https://muslimicons.vercel.app/catalog.json): all icons, aliases, source mappings and npm export availability.
- [Complete reference](https://muslimicons.vercel.app/llms-full.txt): project overview and full inventory.
- [npm package](https://www.npmjs.com/package/@muslim-icons/react): published @muslim-icons/react package.

## Optional

- [Library repository](https://github.com/kolapoimam/muslim-icons): canonical SVG source and releases.
- [React documentation](https://github.com/kolapoimam/muslim-icons/blob/main/packages/react/README.md)
- [Contributing](https://github.com/kolapoimam/muslim-icons/blob/main/CONTRIBUTING.md)
- [Software licence](https://github.com/kolapoimam/muslim-icons/blob/main/LICENSE)
- [Artwork licensing notes](https://github.com/kolapoimam/muslim-icons/blob/main/packages/svg/LICENSE)