Skip to content
Projects

rocketclimb/rocketicons has 72 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 07:59 UTC. Last push 2026-11-12.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

React and React Native icons powered by Tailwind

Web & Apps

README.md

Original
Rocketicons

Rocketicons

Search thousands of open-source icons, then add only the icons your project uses. Rocketicons writes selected components into your source tree for React and React Native, with Tailwind-compatible styling. No full icon collection is imported into the application, and unused icons do not rely on tree-shaking to disappear.

Why Rocketicons?

Most icon libraries install a package containing a complete collection. Rocketicons takes a different route: choose an icon, run the CLI, and receive one local component that your application owns and compiles.

  • Minimal by construction: selected icons become local source files.
  • React and React Native: share the same component API across web and native projects.
  • Tailwind-compatible: style color, size, dark mode, and states with familiar classes.
  • Reviewable and repeatable: generated files can be inspected and committed with your feature.
  • Agent-friendly discovery: use the MCP server or the versioned static catalog at /ai/v1/catalog.json.

Initialization still installs the shared @rocketicons/utils and @rocketicons/tailwind dependencies. Rocketicons is precise about that tradeoff: selected icon source stays local, while common rendering and styling behavior remains shared.

Quick start

Start in an existing React or React Native project. The CLI detects TypeScript or JavaScript and the project's package manager.

npx rocketicons init
npx rocketicons search rocket --collection rc
npx rocketicons add @rc/rc-rocket-icon --dry-run
npx rocketicons add @rc/rc-rocket-icon

Then import the generated component:

import RcRocketIcon from "@/ri/icons/rc-rocket-icon";

export function LaunchButton() {
  return <RcRocketIcon className="icon-sky-500-lg dark:icon-white-lg" />;
}

The CLI writes TSX or JSX to src/ri, configures the @/ri/* alias, and accepts several exact icon IDs in one add call. Use --json, --dry-run, and --cwd <absolute path> for agent workflows.

Iconoir v7.12.1 is available as @oir/oir-home and, where Iconoir supplies a solid style, @oir/oir-solid-<name>. The collection contains 1,383 regular and 288 solid icons under Iconoir's MIT license. For example, npx rocketicons add @oir/oir-solid-arrow-down-circle adds just that component.

Commit src/ri with your application so collaborators, CI, deployments, and offline builds use the same icon source.

Documentation and machine discovery

MCP server

The MCP package is available on npm. Configure a stdio MCP client to run npx -y rocketicons mcp (or the dedicated npx -y @rocketicons/mcp). From this checkout, build the CLI and MCP packages and use npx --no-install rocketicons mcp. Search uses Algolia for broad terms and a bundled index if Algolia is unavailable. Pass collections: ["fi"] to search_icons to keep results within one family. Exact IDs such as @fi/fi-calendar resolve locally. Inspect the SVG resource, dry-run init_project and add_icons, then use get_icon_usage for the local import. See MCP setup.

The MCP includes opt-in instrumentation, but collection remains disabled until the collector is deployed and verified. Read the usage measurement notice (Português brasileiro) and contract.

Monorepo packages

  • @rocketicons/cli — initializes projects and writes selected icon components.
  • @rocketicons/toolkit — shared catalog, search, and project operations for CLI and MCP.
  • @rocketicons/mcp — local stdio server for icon discovery and installation.
  • rocketicons — generated catalog data and legacy package exports.
  • @rocketicons/utils — shared component utilities.
  • @rocketicons/tailwind — Tailwind integration.
  • @rocketicons/core and @rocketicons/generator — generation pipeline.
  • ignition — the statically exported website.

Development

Install dependencies and run workspace checks from the repository root:

npm install
npm run test-all
npm run lint-all
npm run build-all

Website-specific development commands live in packages/ignition/README.md.

License

Rocketicons is released under the MIT License. Included icon collections retain their upstream licenses; review the collection metadata and license URL before use.