Iconjar

Promptfree, for everyone, and the only version there is

Copy the prompt for Claude CodeCopy the prompt for CodexCopy the prompt for Cursor

Copy

Build me an icon library that replaces Iconjar — and note it is bought once for the price of a lunch, so build this because you want the library to be files rather than to save money.

STACK
- Node 20+ with Fastify, server-rendered HTML, or a small local tool with no server at all
- SQLite through better-sqlite3 with FTS5
- Caddy in front only if it is shared

THE PRINCIPLE
- **The library is a directory of SVG files.** The database is an index over it, rebuildable at any time. If this tool disappears the icons are still there, still usable, still named — and that property is worth more than any feature
- Write the rebuild command first and test it

THE DATA MODEL
- sets: id, name, licence, licence_url, source, version, imported_at
- icons: id, set_id, name, path, sha256, tags_json, categories_json, viewbox, has_currentcolor, stroke_width, style — outline, solid, duotone
- usages: id, icon_id, where, at — where each one is actually used in your projects
- FTS5 over name, tags and category

IMPORTING
- A directory of SVGs, a zip, or the packaged formats sets ship in
- Normalise on import: a consistent viewBox, `currentColor` on strokes and fills where the set allows it, and the XML tidied. An icon that cannot inherit its colour is an icon you will fight with every time
- **Record the licence per set, with its URL and the date you obtained it.** Icon sets have real licence terms — some require attribution, some forbid redistribution, some forbid use in a product you sell. A library with no licence record is a library you cannot safely ship from
- Deduplicate by content hash across sets, because the same icon appears in several

SEARCH, WHICH IS THE POINT
- FTS5 over names and tags, instant, with the icon rendered in the results
- Synonyms matter more here than anywhere: somebody types 'bin' and the set calls it 'trash', or 'cog' and it is 'settings'. Keep a small synonym table and grow it from your own failed searches
- Filter by set, style and stroke weight, so a page ends up visually consistent rather than mixing three families

GETTING ONE OUT
- Copy as SVG, as a JSX component, as a data URI, or as a sprite reference
- Export a selection as a sprite sheet with a symbol per icon, which is the format that actually belongs in a web page
- Export a subset as an icon font only if you must — a font is worse for accessibility and for colour, and this is the moment to stop using one
- Optimise on export, and check that optimisation has not broken an animation

THE PART THAT PAYS FOR ITSELF
- **A usage report.** Scan your own repositories for which icons are referenced, and list the ones in the library that nothing uses. That is how a sprite stops growing, and it is a grep

OPERATIONS
- .env: DATABASE_PATH, LIBRARY_PATH, BASE_URL
- Migrations on boot, each once; the library directory is what gets backed up

WHAT MATTERS MOST
Files on disk and the licence record. The first means the library outlives the tool; the second means you can answer the question if anybody ever asks whether you were allowed to ship that icon.