# IconMuse

> IconMuse by ChordMuse is a library of 199 hand-drawn music icons (24×24 grid, 1.5px round stroke, currentColor). It's distributed as an npm package (`iconmuse`, with a React component and an <icon-muse> Web Component), a Swift Package (`IconMuse`), a Flutter package (`iconmuse`), an Android library (`app.chordmuse:iconmuse`), raw SVG and JSON.

- Icon names are kebab-case (`guitar-electric`), camelCase in Swift, Dart and Kotlin (`guitarElectric`), and `ic_iconmuse_<snake_case>` for Android resources.
- Categories: Notation, Playback, Volume & Sound, Strings, Keys, Winds & Brass, Percussion, Devices & Gear, Studio & Production, Library & Social.
- Some registry packages may not be published yet. Each guide states the current install status.
- One-command install for any app (no registry needed): `curl -fsSL https://icons.chordmuse.app/iconmuse.mjs -o iconmuse.mjs && node iconmuse.mjs generate` detects the project's tech stack and writes a native icon pack. Add `--icons a,b` for a subset and `--json` for machine-readable output.
- The same script powers the IconMuse skill for coding agents. See the AI agents guide.

## Docs

- [IconMuse on any website](https://icons.chordmuse.app/docs/web.md): Use IconMuse music icons in plain HTML, WordPress, PHP, Rails, Django or any framework, with no build step.
- [IconMuse for React and Next.js](https://icons.chordmuse.app/docs/react.md): Use IconMuse music icons in React or Next.js, either as the iconmuse npm package or as a component generated into your project.
- [IconMuse for Vue, Nuxt, Svelte, Angular, Solid and Astro](https://icons.chordmuse.app/docs/frameworks.md): Add IconMuse music icons to Vue, Nuxt, Svelte, Angular, Solid or Astro with one command that writes a native component.
- [IconMuse for iOS, macOS and SwiftUI](https://icons.chordmuse.app/docs/ios.md): Add IconMuse music icons to an iOS or macOS app with one command, then use them in SwiftUI or UIKit like SF Symbols.
- [IconMuse for Flutter](https://icons.chordmuse.app/docs/flutter.md): Add IconMuse music icons to a Flutter app with one command, then use IconMuse(IconMuseIcons.play) like Flutter's own Icon widget.
- [IconMuse for Android and Jetpack Compose](https://icons.chordmuse.app/docs/android.md): Add IconMuse music icons to an Android app with one command, then use them in Jetpack Compose or Android Views.
- [IconMuse data format](https://icons.chordmuse.app/docs/other-languages.md): Read IconMuse icons as JSON path data from Python, Go, Rust, C#, game engines and design tools.
- [IconMuse for AI agents](https://icons.chordmuse.app/docs/ai-agents.md): The IconMuse skill detects a project's tech stack and installs or generates a native music-icon pack. Also covers llms.txt and Markdown pages for agents.

## Icons

- [All icons by category](https://icons.chordmuse.app/index.md): every icon name with tags, linking to per-icon pages
- [Icon geometry (JSON)](https://icons.chordmuse.app/dist/icons.json): path data for every icon
- [Agent skill](https://icons.chordmuse.app/skills/iconmuse/SKILL.md): instructions for coding agents

## Optional

- [Full text](https://icons.chordmuse.app/llms-full.txt): all guides plus the complete icon list in one file
- [Gallery](https://icons.chordmuse.app/): interactive website for people