Black Friday is here 🔥 Get Wensity Pro for 20% less with

Use Wensity icons.

This guide covers how to add Wensity Icons, the 1000 rounded icons in outline, duotone and solid, to a React or Next.js app. You copy an icon from the icon browser, add it with the Wensity CLI, or ask your coding agent for it. Each icon lands in your project as its own file, so there is no icon package to install and nothing to keep updated. 50 icons are free with no account, and the other 950 come with Wensity Pro.

Copy an icon

  1. Open the icon browser. Press / to search: names, other names (search "photo" to find image) and categories all match.
  2. Pick a style in the sidebar, or under the search on a phone. The grid and the copy follow it.
  3. Click an icon. The panel shows it at every size, with Copy SVG and Copy JSX.

Arrow keys move between icons and Esc closes the panel. The page address keeps the style, category and icon, so a link opens the same view for whoever you send it to.

Use an SVG icon in React

Copy JSX gives you the <svg> with React attribute names. Wrap it in a component and pass props through, so each place that uses it can set its size and class:

components/icons/icon-home.tsx
import type { SVGProps } from "react";
export function IconHome(props: SVGProps<SVGSVGElement>) {
return (
<svg width="24" height="24" viewBox="0 0 24 24" fill="none" aria-hidden="true" {...props}>
{/* the <path> elements from Copy JSX */}
</svg>
);
}

Keep one file per icon, or one file per group of icons, so your bundle only carries the icons a page uses. Decorative icons get aria-hidden="true". An icon that is the only content of a button needs a label on the button, such as aria-label="Home".

Copy SVG gives plain SVG markup for HTML, Figma, or a static file.

Install icons with the CLI

The Wensity CLI writes that component for you, one file per icon in components/wensity/icons/ (src/components/wensity/icons/ when your project has a src folder, or the icons folder inside the components folder set in your wensity.json):

terminal
npx wensity@latest icons add home search settings
npx wensity@latest icons add home --style solid
Source
import { IconHome } from "@/components/wensity/icons/home";
import { IconHomeSolid } from "@/components/wensity/icons/home-solid";
<IconHome className="size-5" />

Free icons install without logging in. For Pro icons, run npx wensity@latest login once on each computer. Add --format svg for plain .svg files. Running the same command again leaves identical files alone, and a file you edited is only replaced with --force.

Ask your agent

With the Wensity MCP server connected, Claude Code, Cursor, Codex and VS Code can find icons and install them through the same installer as the CLI. Ask in plain words, for example "add the Wensity solid home icon to this project". The agent shows you the file it plans to write before it writes anything.

Download SVG icons and sprites

With Pro, Dashboard → Icons has the whole set as one ZIP: every icon in every style as SVG files, one SVG sprite per style, and the React components. It suits design tools, static sites and projects that do not use React. To use a sprite, inline the file once on the page, then point at an icon by name:

Source
<svg width="24" height="24" aria-hidden="true"><use href="#home" /></svg>

Size and color with currentColor

Every icon draws its strokes and fills in currentColor, so it takes the text color of whatever holds it: change the color in CSS or with a Tailwind class and the icon follows. Size them with width and height, or with Tailwind CSS classes:

Source
<IconHome className="size-5 text-neutral-500" />
<button aria-label="Home" className="text-white hover:text-neutral-300">
<IconHome className="size-6" />
</button>

The 1.5px stroke is drawn for 24px. At 16px and 20px it scales down with the icon and still reads clearly; above 32px, outline icons start to look light, so solid or duotone often suit large sizes better.

Outline, duotone and solid

StyleHow it is drawnGood for
Outline1.5px strokes, no fillNavigation, toolbars, most interface text
DuotoneThe outline over a fill of the same color at 30% opacityFeature lists, empty states, settings rows
SolidFilled shapes, inner details cut out at the same 1.5px widthSelected states, small sizes, tab bars

All three are the same drawing, so you can switch style per state, for example outline at rest and solid when selected, without the icon shifting.

Free and Pro

The 50 free icons cover what most apps need first: navigation, common actions, status, account, messages, files, media and shopping. Anyone can copy them, signed in or not.

The other 950 icons come with Wensity Pro, Annual or Lifetime. Without Pro, a few of them show under the free icons in the browser, and a search tells you how many Pro icons match. With Pro, sign in and every icon copies, installs and downloads in every style. Each Pro copy, install and download is checked against your account at that moment.

When a Pro Annual plan ends

Pro icons already in your projects stay licensed to you and keep working. Copying, installing and downloading new Pro icons stops until you renew.

Commercial use and license

Free icons are free to use in personal, commercial and client projects, with no credit required, but they are not MIT licensed: you may not pass them on as icons, for example in an icon pack, icon font, design-tool library, package or public repository. Pro icons follow the same rule under the Wensity UI Commercial License, for the developer your plan covers. Section 9 of the license has the full terms.