Contribute Icons

Aria Icons is open source — every icon set here was contributed or curated by the community. Adding your own set takes about ten minutes.

1. 1

   Fork and clone the repo

   Fork LeulAria/Aria-Icons on GitHub, then clone your fork and install dependencies.

   git clone https://github.com/<your-username>/Aria-Icons.git
   cd Aria-Icons
   bun install

2. 2

   Add your icons

   Drop your SVG files into a new folder under apps/web/icons/<your-set-name>/, then run bun run pack:icons -- --delete to collapse them into icons/vendored/<your-set-name>.json. Use lowercase, hyphenated file names (e.g. shopping-cart.svg) — the file name becomes the icon name.

   apps/web/icons/
   └── my-icon-set/
       ├── shopping-cart.svg
       ├── arrow-right.svg
       └── user-circle.svg

3. 3

   Register the icon set

   Add an entry to ICON_SETS in apps/web/src/lib/icon-sets.ts so the app knows where to find your SVGs and how to group them (line or solid).

   {
     id: "my-icon-set",
     label: "My Icon Set",
     homepage: "https://example.com",
     styles: [
       { id: "line", label: "Line", group: "line", roots: ["./"] },
     ],
   }

4. 4

   Rebuild the icon catalog

   Regenerate the search metadata so your icons show up in the browser, search, and the MCP server.

   cd apps/web
   bun run generate-icons

5. 5

   Preview locally

   Start the dev server and check that your set appears in the sidebar, renders correctly in the grid, and is searchable.

   bun run dev
   # open http://localhost:3001

6. 6

   Open a pull request

   Commit your changes, push to your fork, and open a PR against LeulAria/Aria-Icons. Mention the icon count, license, and source of the icons in the description.

   git checkout -b add-my-icon-set
   git add .
   git commit -m "Add my-icon-set (24 icons, MIT)"
   git push -u origin add-my-icon-set

Only submit icons you have the right to share. Include the license in your PR — MIT, CC0, or similarly permissive licenses are preferred.