mrkeyoor.com_
Sun 04 Oct 06:20 UTC
Dev Toolsevaluationupdated 04 Oct 2026

regen-icons review

Regen Icons is an MIT-licensed set of 225 outline icons drawn on a 24-pixel grid. You can copy its finished SVGs directly, or use the included JSON drawing format and generator to make icons that follow the same visual rules.

Verdict

Our run installed 0 packages in 6 seconds, then the build and tests both failed on a missing generator module, so Regen Icons is safer to adopt as an SVG source than as a turnkey authoring tool. Its 225-icon set and unusually exact drawing guide make sense for a team willing to own the visual review. Wait for a published package and a clean fresh-checkout path if you need routine dependency upgrades and automated releases.

We ran it

Lab card: what happened when we ran regen-iconsScreenshot of regen-icons (github.com/kazdenc/regen-icons)
Install✓ · 6s0 packages · 4 MB
Build✗ · 5s
Tests✗ · 7sran, no count parsed
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo634 files~1,114 lines of source · 0.6 MB · 1 CI workflows

Answers from our run

Does regen-icons build from source?

Dependencies installed in 6 seconds (0 packages), and the build failed. We cloned commit 64c0e16 into a clean Debian container with 3 CPUs and no project-specific setup.

Do regen-icons's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Does regen-icons have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use regen-icons?

Teams that require a published npm dependency: the README says the regen-icons package is prepared but not published.

What are the alternatives to regen-icons?

Lucide, Tabler Icons, Phosphor Icons. Our run installed 0 packages in 6 seconds, then the build and tests both failed on a missing generator module, so Regen Icons is safer to adopt as an SVG source than as a turnkey authoring tool.

Setup2/5SVGs are direct, but our 5-second build failed after install
Docs4/5Detailed geometry, preview, contribution, and agent instructions
Community2/5183 stars and two open issues or PRs, with no release yet
Maturity2/5225 usable icons, but no npm release and our checks failed

Who it’s for

Product teams that want a small, consistent SVG set they can copy into an interface.
React developers willing to use repository files while the npm package remains unpublished.
Designers and coding-agent users who want explicit geometry rules for adding icons.
Contributors prepared to inspect preview matrices at 16 pixels instead of trusting validation alone.

Who it’s NOT for

Teams that require a published npm dependency: the README says the regen-icons package is prepared but not published.
Developers expecting a fresh checkout to build after the detected install step: our run installed 0 packages, and both later commands stopped with MODULE_NOT_FOUND.
Projects needing broad subject coverage today: the set has 225 icons, and issue 2 shows that drawing a missing stethoscope still needs human visual judgment after an agent follows the documented workflow.
Contributors who cannot review generated artwork by eye: the drawing guide says passing validation does not establish that an icon belongs in the family.

Setup reality

Our sandbox installed commit 64c0e16 in 6 seconds, but it added 0 packages and used 4 MB. The build failed in 5 seconds, and the test command failed in 7 seconds. The log reported MODULE_NOT_FOUND from generator/.dev/scripts/fill.mjs and warned that the local node_modules directory was missing. Npm audit found 0 known vulnerabilities.

Using the existing artwork needs no service, secret, or account: copy a file from svg/outline or svg/filled. Authoring needs pnpm in the generator directory, plus the repository's React, TypeScript, Paper.js, and Playwright development dependencies.

The package is not on npm yet. Previewing can open a browser unless you pass the documented --html-only option, and final acceptance requires visual comparison at several sizes, weights, themes, and styles.

The 225 SVGs are useful before the generator is ready

Regen Icons gives you 225 finished outline icons on a 24-pixel grid, plus a separate authoring system. The files live in plainly named folders and can be copied into a project or dropped into a design tool. If your interface needs a calendar, route, terminal, accessibility mark, or common control, this path asks almost nothing of your build system.

The second product is an icon authoring system. Each canonical drawing is JSON rather than hand-edited SVG. A compiler turns that source into SVG files, React components, TypeScript types, a sprite, and a searchable catalog. That is the more interesting part of Regen: contributors work from shared geometry instead of tracing paths until an icon looks close enough. It is also the part our clean-container run could not build.

The drawing rules catch geometry, while people judge the picture

On its 24-pixel grid, the drawing guide limits points to a safe area from 2 to 22. Default strokes are 2 units with round caps. The compiler rejects off-grid points, unknown primitives, oversized radii, duplicate names, cycles, and several spacing errors. It also reports icons whose ink or center differs sharply from the set.

Those checks do not decide whether a symbol reads correctly. The guide tells contributors to inspect 16, 20, 24, and 32-pixel renderings across weights, themes, outline forms, and tonal forms. Its own examples explain why: an early globe carried too much detail, while a route needed curves instead of hard elbows. This is a sensible admission. A valid stethoscope can still look like unrelated tubing.

Open issue 2 makes that boundary visible. A contributor followed the Claude Code instructions, generated a stethoscope twice, and still asked whether the process was wrong. There was no maintainer reply when we checked. The issue does not prove that agents cannot extend the set. It does show that the agent guide, schema, and validator do not replace someone looking at the 16-pixel result and deciding whether it communicates.

What happened when we ran it

Our sandbox cloned commit 64c0e16 into a fresh Debian container with 3 CPUs and 8 GB of RAM, then completed the detected install step in 6 seconds. It installed 0 packages and occupied 4 MB on disk. The build then failed in 5 seconds. The log ended with MODULE_NOT_FOUND inside generator/.dev/scripts/fill.mjs and a warning that a local package.json existed while node_modules was missing.

The test command failed in 7 seconds at the same module-loading point. It did not reach a test result, so there is no passing or failing test count to report. Npm audit found 0 known vulnerabilities. The checkout itself had 634 files, about 1,114 lines of source, and measured 0.6 MB. We saw one CI workflow, no Dockerfile, and no tests directory.

The log supports a narrow conclusion: dependencies needed by the generator were not present after the install step our sandbox ran. It does not name an operating-system package problem or prove a defect in the drawing compiler, so we will not assign either cause. For a buyer, the practical result is enough. The ready-made SVGs work as files, but commit 64c0e16 did not produce a buildable authoring environment through our fresh run.

The documented setup starts inside generator

The documented authoring setup pins pnpm 10.33.0 and starts inside generator. The README's gallery command is pnpm install --dir generator, followed by pnpm preview; the contribution guide instead tells you to enter that directory before installing. Its package declares React 19, TypeScript 5.9, Paper.js, and Playwright as development dependencies. No credentials or hosted services are required.

Once dependencies are present, a contributor edits one generator/src/<name>.icon.json file, validates it, compares it with neighboring icons, and runs the full test command. Generated SVGs are committed, while dist stays out of pull requests. Previewing without a browser is possible through --html-only, a useful option for remote machines and agents. The workflow is well explained. Our result says its clean-install assumptions still deserve verification on your own CI.

There is no npm release to pin

The README says the publishable regen-icons package has been prepared but has not been published. GitHub also returned no latest release. Until that changes, consumers choose between copying individual SVGs, vendoring part of the repository, or pinning a Git commit. None gives a package manager the ordinary job of tracking a numbered release and its upgrade notes.

GitHub showed 183 stars and 2 combined open issues and pull requests. The last code push was September 13, 2026, while issue activity continued on September 22. That is recent work, but the repository has no release history to demonstrate upgrade discipline. Teams can still use the MIT-licensed files today. They should treat the generator and future package as young tooling, especially after our 5-second build failure.

Regen Icons earns attention for turning visual consistency into inspectable source rules. The 225 existing icons are the low-risk adoption path. The compiler becomes attractive when your team needs symbols the catalog lacks and has a designer or careful frontend engineer available for the final call. If you only want a wide library with published framework packages, Lucide, Tabler, or Phosphor asks less of you.

Alternatives

ProjectWhat it isPick it when
Lucide gh↗A mature community icon toolkit with framework packages and a large catalog.pick this instead when published packages and wider icon coverage matter more than Regen's JSON drawing language.
Tabler Icons gh↗An MIT-licensed SVG collection with more than 6,200 icons.pick this instead when you need a much broader ready-made set and do not plan to author icons through Regen's compiler.
Phosphor IconsA multi-weight icon family distributed from a shared core repository.pick this instead when several established visual weights and existing package integrations are the priority.

What people are saying

  1. [velocity-scout] kazdenc/regen-icons

Sources

  1. Regen Icons README
  2. Regen Icons drawing guide
  3. Regen Icons contribution guide
  4. Issue 2: Wasn't able to create a stethoscope

More dev tools reviews

github-stars-history · BrokenPipe · FGOAC-scooby · plexo · window-sweaters · qingjian · the whole board →