# Muslim Icons

> Icons for the Ummah. A free, open-source Muslim and Islamic SVG icon library for developers building apps, websites and design systems for Muslim communities.

Canonical site: https://muslimicons.vercel.app/
Library repository: https://github.com/kolapoimam/muslim-icons
Npm package: https://www.npmjs.com/package/@muslim-icons/react

## Collection

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.

- Mosque & Architecture: 10 icons
- Worship & Prayer: 18 icons
- Quran & Knowledge: 14 icons
- Ramadan & Eid: 12 icons
- Hajj & Umrah: 12 icons
- Muslim Lifestyle: 16 icons
- Community & Services: 12 icons
- Islamic Concepts: 10 icons

## React usage

Install with npm install @muslim-icons/react. The package supports React 18 and 19, TypeScript declarations, size, color, strokeWidth, absoluteStrokeWidth and standard React SVG attributes. Default viewBox: 24×24. Color: currentColor.

```tsx
import { Mosque, OpenQuran, PrayerMat } from "@muslim-icons/react";
<Mosque size={24} />
<OpenQuran size={32} color="#28604c" />
<PrayerMat aria-label="Prayer mat" />
```

For icons available in the published package, the explorer provides canonical React imports and JSX. Other source-library icons provide SVG markup and downloads. All SVG downloads use the original source artwork.

## Search

Search names, descriptions, categories, tags and aliases. Salah finds prayer icons; tasbih finds prayer beads; fanous finds Ramadan Lantern. Categories combine with search.

## Questions

### What is Muslim Icons?

Muslim Icons is a free, open-source icon library for developers and designers building products for Muslim communities. Its Islamic icon collection covers mosques, prayer, Quran study, Ramadan, Eid, Hajj, Umrah and everyday Muslim life.

### Can I download Islamic icons as SVG files?

Yes. Open an icon in the explorer, choose its size and color, and download its SVG. All 104 icons are synced from the original Muslim Icons source library, using a consistent 24×24 outline style.

### How do I use Muslim Icons with React?

Install @muslim-icons/react from npm, then import components such as Mosque, Quran, OpenQuran, PrayerMat and Kaaba. Components accept size, color and standard SVG props. The current npm release is v0.2.1 with 95 icon exports. The full SVG collection tracks the main repository, which can include newer icons.

### Are Muslim Icons free for commercial projects?

The software is MIT licensed. The source repository describes intended CC0 1.0 artwork licensing, subject to contributor rights confirmation. Review the repository's artwork licensing notes before using the SVGs in a commercial or production project.

## Licensing

Software: MIT. Artwork: intended CC0 subject to rights confirmation. Review https://github.com/kolapoimam/muslim-icons/blob/main/packages/svg/LICENSE.

## Project links

- [npm package](https://www.npmjs.com/package/@muslim-icons/react)
- [Library repository](https://github.com/kolapoimam/muslim-icons)
- [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)
- [Ihsan Labs](https://hdfund.org): website attribution.