# Master Icons
> Optically sized interface icons for React, Vue, Svelte, Preact, Astro and plain SVG.
# Getting started
Install Master Icons and render your first icon.
## Install
Install the package for your framework. Each framework package brings the shared `@master/icons` core with it and uses the framework already in your application.
| Framework | Package |
| --- | --- |
| React 18 or 19 | `@master/icons-react` |
| Vue 3.5 or later | `@master/icons-vue` |
| Svelte 5 | `@master/icons-svelte` |
| Preact 11 | `@master/icons-preact` |
| Astro 7 | `@master/icons-astro` |
| No framework | `@master/icons` |
```sh
npm install @master/icons-react
```
With other package managers, use `bun add`, `pnpm add` or `yarn add` with the same name. Install only the package for your framework; the others are not needed. The packages support Node.js 22 and later, and the Astro package requires Node.js 24 or later.
## Render an icon
Import each icon by name. Icon components end in `Icon`.
```tsx
import { SearchIcon } from '@master/icons-react';
```
Icons draw in `currentColor`, so they take the color of the surrounding text. Without options, an icon renders the 24 px drawing with soft corners. Browse every name, copy its import and download SVG files in the [collection](https://icons.master.co/icons).
## Choose an entry
Each package has two kinds of entry, with the same icon names:
- **Dynamic**, such as `@master/icons-react`: each icon carries all nine drawings (three optical sizes by three corner styles) and accepts `size`, `corner` and `strokeWidth`.
- **Fixed**, such as `@master/icons-react/20/soft`: each icon carries one drawing. Use it when the whole interface uses one size and corner style; it ships less.
```tsx
import { SearchIcon } from '@master/icons-react/20/soft';
```
Unused icons are removed by any bundler that supports tree shaking. Continue with the page for your framework: [SVG and JavaScript](https://icons.master.co/guide/svg.md), [React](https://icons.master.co/guide/react.md), [Vue](https://icons.master.co/guide/vue.md), [Svelte](https://icons.master.co/guide/svelte.md), [Preact](https://icons.master.co/guide/preact.md) or [Astro](https://icons.master.co/guide/astro.md).
## Set up with an AI agent
A coding agent can run this setup for you. Paste the prompt below into the agent from the app's root directory. It inspects the project and asks for the framework package, the default size, corners and stroke, and what happens to an existing icon library before changing files. Then it installs the package, renders a first icon and runs your checks.
**Set up Master Icons**
````text
You are working in an existing web application. Set up Master Icons end to end.
Documentation: https://icons.master.co/llms.txt, which links every guide as Markdown (read getting-started, the page for the chosen framework, optical-sizes, stroke-width and accessibility), and the README of the installed package. After installing, follow node_modules/@master/icons/skills/master-icons/SKILL.md.
Master Icons is published on npm as @master/icons (the core) and one package per framework: @master/icons-react, @master/icons-vue, @master/icons-svelte, @master/icons-preact and @master/icons-astro. Install only these names; do not install a package with a similar name.
First inspect the project before editing: package manager and lockfile, Node.js version, framework and build tool (React, Vue, Svelte, Preact, Astro or none), any icon library already in use and how it is imported, the dev/lint/build/test commands, and agent guidance files such as AGENTS.md.
Before editing, ask me these and wait for the answers. Do not choose them yourself:
- Integration: the package for the framework you found, or @master/icons for plain SVG and JavaScript. Install exactly one package.
- Defaults: the optical size (16, 20 or 24; 24 for a general interface, 16 or 20 for a dense one), the corner style (sharp, soft or rounded; soft is the default), and whether to keep each master's native stroke or set one width (0.75–1.5 at 16 px, 1–2 at 20 px, 1.25–2.5 at 24 px, in steps of 0.25).
- Existing icons: if the project already uses another icon library, whether to leave it in place (the default) and use Master Icons only for new screens, or replace the icons I name. Never replace icons I have not named.
Then adopt Master Icons conservatively:
1. Run every command from the app root, where its package.json lives, with the project's package manager, and install the chosen package from npm.
2. Import each icon by name. The dynamic entry (import { SearchIcon } from '@master/icons-react') accepts size, corner and strokeWidth; a fixed entry such as '@master/icons-react/20/soft' holds one master and ships less. Prefer fixed entries when the app uses one setting everywhere.
3. Render icons at their native sizes. Pass size, which chooses the nearest optical master, instead of resizing an icon with CSS width and height. strokeWidth chooses precomputed geometry, so never override stroke-width in CSS.
4. Keep icons accessible: an icon beside visible text stays decorative, an icon-only button carries its accessible name on the button, and a meaningful standalone icon gets label.
5. If I chose to replace named icons, map each one to the closest name in node_modules/@master/icons/dist/catalog.json, show me the mapping before editing, keep every control's accessible name, and remove the old dependency only after nothing imports it.
6. Preserve the existing architecture and styling, and avoid unrelated refactors.
7. Verify: render a SearchIcon at size 20 on a visible page and confirm it draws in the text color with soft corners in light and dark mode. Then remove it unless I want to keep it, and run the project's lint, build and tests.
When finished, summarize the changed files, the package installed, the defaults chosen, the icons replaced or intentionally left unchanged, the validation results, and anything not verified in a browser.
````
## For AI agents
Two resources keep a coding agent on real names and the rules above:
- **Agent skill.** `@master/icons` ships a skill at `node_modules/@master/icons/skills/master-icons/SKILL.md`. Copy the `master-icons` folder into your agent's skills folder, such as `.claude/skills` or `.agents/skills`. It covers packages, entries, sizes, stroke width and accessibility, and includes a script that searches the installed catalog so the agent never invents an icon name: `node node_modules/@master/icons/skills/master-icons/scripts/search.mjs search`.
- **llms.txt.** [/llms.txt](https://icons.master.co/llms.txt) indexes every guide as Markdown, and [/llms-full.txt](https://icons.master.co/llms-full.txt) holds them in one file. Every guide page is also available as Markdown by adding `.md` to its address, such as [/guide/getting-started.md](https://icons.master.co/guide/getting-started.md).
## Next steps
- Choose a drawing for the space available in [sizes and corners](https://icons.master.co/guide/optical-sizes.md).
- Adjust line weight with [stroke width](https://icons.master.co/guide/stroke-width.md).
- Name icons and the controls around them in [accessibility](https://icons.master.co/guide/accessibility.md).
- See how Master Icons differs from other libraries in the [comparison](https://icons.master.co/guide/comparison.md).
Source: https://icons.master.co/guide/getting-started.md
---
# Download
Download SVG sets, install the packages or link single files from a CDN.
## Packages
Install the package for your framework from npm. Each brings the shared `@master/icons` core with it.
| Use | Install | Guide |
| --- | --- | --- |
| SVG and JavaScript | `npm install @master/icons` | [SVG and JavaScript](https://icons.master.co/guide/svg.md) |
| React | `npm install @master/icons-react` | [React](https://icons.master.co/guide/react.md) |
| Vue | `npm install @master/icons-vue` | [Vue](https://icons.master.co/guide/vue.md) |
| Svelte | `npm install @master/icons-svelte` | [Svelte](https://icons.master.co/guide/svelte.md) |
| Preact | `npm install @master/icons-preact` | [Preact](https://icons.master.co/guide/preact.md) |
| Astro | `npm install @master/icons-astro` | [Astro](https://icons.master.co/guide/astro.md) |
## SVG sets
Each set is a ZIP archive of every icon drawn for one optical size and corner style, at its native stroke width. Pick the size your interface uses and its corners:
| Size | Sharp | Soft | Rounded |
| --- | --- | --- | --- |
| 16 px | [sharp](https://github.com/master-co/icons/releases/latest/download/master-icons-16-sharp.zip) | [soft](https://github.com/master-co/icons/releases/latest/download/master-icons-16-soft.zip) | [rounded](https://github.com/master-co/icons/releases/latest/download/master-icons-16-rounded.zip) |
| 20 px | [sharp](https://github.com/master-co/icons/releases/latest/download/master-icons-20-sharp.zip) | [soft](https://github.com/master-co/icons/releases/latest/download/master-icons-20-soft.zip) | [rounded](https://github.com/master-co/icons/releases/latest/download/master-icons-20-rounded.zip) |
| 24 px | [sharp](https://github.com/master-co/icons/releases/latest/download/master-icons-24-sharp.zip) | [soft](https://github.com/master-co/icons/releases/latest/download/master-icons-24-soft.zip) | [rounded](https://github.com/master-co/icons/releases/latest/download/master-icons-24-rounded.zip) |
To use other stroke widths, download the archive for the optical size. It holds a folder for each corner style and width, such as `soft/stroke-2/search.svg`:
- [`master-icons-16-strokes.zip`](https://github.com/master-co/icons/releases/latest/download/master-icons-16-strokes.zip): widths 0.75–1.5 at 16 px, in every corner style
- [`master-icons-20-strokes.zip`](https://github.com/master-co/icons/releases/latest/download/master-icons-20-strokes.zip): widths 1–2 at 20 px, in every corner style
- [`master-icons-24-strokes.zip`](https://github.com/master-co/icons/releases/latest/download/master-icons-24-strokes.zip): widths 1.25–2.5 at 24 px, in every corner style
The archives are attached to every [GitHub release](https://github.com/master-co/icons/releases) and these links always serve the newest one. Download single files at any size and width from each icon's details in the [collection](https://icons.master.co/icons).
## Files from a CDN
The `@master/icons` package includes every native SVG file, so any npm CDN serves them by path:
```html
```
The path is `icons/{size}/{corner}/{name}.svg`. An SVG in `` cannot take the text color with `currentColor`; inline the markup, or use a component, when it needs to.
## License
Each archive includes `LICENSE`, `THIRD_PARTY_NOTICES.md` and the `licenses/` folder, and each SVG file begins with its own notice. Keep them when you redistribute the icons. Brand icons remain trademarks of their owners and are for referring to those products. See [license and attribution](https://icons.master.co/guide/license.md).
Source: https://icons.master.co/guide/download.md
---
# Comparison
How Master Icons compares with other icon libraries.
## At a glance
Most icon libraries draw each icon once and scale it. Master Icons draws each icon at three optical sizes and in three corner styles, and redraws it for every supported stroke width. It has fewer icons than the largest libraries and concentrates on interface work: dashboards, apps and websites.
| Library | Icons | Drawn sizes | Styles | Line weight | Official components | License |
| --- | --- | --- | --- | --- | --- | --- |
| **Master Icons** | 946, including 107 brand entries | 16, 20 and 24 px | Sharp, soft and rounded corners | 0.75–2.5 in steps of 0.25, redrawn | React, Vue, Svelte, Preact, Astro | MIT; some artwork keeps its own notice |
| Lucide | 2,091 | 24 px | Outline | `strokeWidth` sets the SVG stroke | React, Vue, Svelte, Preact, Solid, Angular and more | ISC |
| Heroicons | 324 | 24 px; solid also 20 and 16 px | Outline and solid | — | React, Vue | MIT |
| Phosphor | 1,512 | One drawing | Six weights, including fill and duotone | Six fixed weights | React, Vue, web components and more | MIT |
| Tabler Icons | 5,491 outline, 1,054 filled | 24 px | Outline and filled | `stroke` sets the SVG stroke | React, Vue, Svelte, Preact, Solid and more | MIT |
| Material Symbols | 7,890 per style | Optical size axis, 20–48 | Outlined, rounded and sharp; fill axis | Weight axis, 100–700 | — (font and SVG files) | Apache 2.0 |
| Fluent UI System Icons | About 3,000 | Up to eight sizes, 10–48 px | Regular and filled | — | React | MIT |
| Font Awesome Free | 2,001 solid, 273 regular, 609 brands | One drawing | Solid, regular and brands | — | React, Vue, Angular | Icons CC BY 4.0, code MIT |
Counts come from the published npm packages in November 2026: `lucide-static` 1.75, `heroicons` 2.2, `@phosphor-icons/core` 2.1, `@tabler/icons` 3.52, `@material-symbols/svg-400` 0.49, `@fluentui/svg-icons` 1.1.346 and `@fortawesome/fontawesome-free` 7.3. They change with every release; check each project for its current figures.
## Optical sizes
A 24 px drawing scaled down to 16 px keeps its 24 px details, which crowd together and blur. Master Icons draws the 16 and 20 px masters separately, simplifying or rearranging details where a small size needs it, and `size` picks the nearest master automatically. Fluent UI and Heroicons also redraw small sizes, and Material Symbols adjusts through the optical size axis of its variable font; most other libraries scale a single drawing. See [sizes and corners](https://icons.master.co/guide/optical-sizes.md).
## Corners
The three corner styles change geometry and internal spacing, not only SVG line joins, so a whole interface can move between a precise and a friendly look without changing icon names. Material Symbols offers a similar choice as separate outlined, rounded and sharp families.
## Line weight
Libraries that expose a stroke width usually change the SVG `stroke-width` attribute. Lines then thicken in place and close gaps, cutouts and the space between details. Master Icons redraws each supported width ahead of time, with its cutouts and masks recomputed, so a heavier icon keeps its spacing. Phosphor and Material Symbols also draw their weights deliberately, as fixed weights or a font axis. See [stroke width](https://icons.master.co/guide/stroke-width.md).
## Size
A component imported from a fixed entry, such as `SearchIcon` from `@master/icons-react/24/soft`, adds about 1.5 KB to a minified and gzipped bundle, including the shared renderer. The dynamic entry adds about 2 KB per icon, because it carries all nine masters and their widths. Ten fixed icons add about 3 KB. Unused icons are tree-shaken.
The installed core package is larger than most icon packages: it includes every SVG file for all nine masters and the precomputed widths, about 20 MB compressed. This affects `node_modules`, not your application bundle.
## Choosing
Choose Master Icons for interfaces that use small sizes, need a consistent corner style or line weight across icons, or share one icon set across React, Vue, Svelte, Preact and Astro.
Another library may fit better when:
- You need the widest coverage of concepts: Material Symbols and Tabler Icons have several thousand icons.
- You want weights such as duotone or an icon font: Phosphor and Material Symbols.
- Your interface follows Microsoft Fluent or Material Design.
- You build with Angular, Solid, React Native or Flutter, which Lucide, Tabler Icons and Phosphor support officially.
Master Icons can run beside another library. Use it for new screens first, then replace icons one at a time; the [setup prompt](https://icons.master.co/guide/getting-started.md#set-up-with-an-ai-agent) maps existing icons to the closest names before changing anything.
Source: https://icons.master.co/guide/comparison.md
---
# SVG and JavaScript
Use icons without a framework dependency.
## SVG files
Download a single SVG from the [collection](https://icons.master.co/icons), or a ZIP archive of every icon for one size and corner style, together with their licenses. After [installing `@master/icons`](https://icons.master.co/guide/getting-started.md#install), the same files are available at the package subpath `@master/icons/svg/{size}/{corner}/{name}.svg`, such as `@master/icons/svg/20/soft/search.svg`.
Inline SVG uses `currentColor`. An external SVG loaded through `` does not inherit the surrounding text color.
## JavaScript renderer
```js
import { Search, renderSvg } from '@master/icons';
const svg = renderSvg(Search, { size: 20, corner: 'soft', label: 'Search' });
```
`renderSvg` returns SVG markup. Use it with this package's trusted icon definitions. Icon definitions are named without the `Icon` suffix used by components. The `size` option controls display size; `opticalSize` can select 16, 20 or 24 explicitly. By default, the closest optical drawing is selected.
| Option | Default | Behavior |
| --- | --- | --- |
| `size` | `24` | Display size, a positive finite number |
| `opticalSize` | `'auto'` | The 16, 20 or 24 master; `auto` picks the nearest, and the larger one at 18 and 22 |
| `corner` | `'soft'` | `'sharp'`, `'soft'` or `'rounded'` |
| `strokeWidth` | native | A [stroke width](https://icons.master.co/guide/stroke-width.md) in native units and steps of 0.25 |
| `color` | `'currentColor'` | The color of the drawing |
| `label` | none | Without it the SVG is `aria-hidden`; with it the SVG gets `role="img"` and the label |
| `direction` | `'ltr'` | `'rtl'` mirrors directional icons |
Only `arrow-left`, `arrow-right`, `chevron-left`, `chevron-right`, `chevrons-left`, `chevrons-right`, `undo` and `redo` mirror when `direction` is `rtl`.
Source: https://icons.master.co/guide/svg.md
---
# React
Render dynamic or fixed optical drawings in React.
## Dynamic icons
React is a required peer dependency. Install React 18 or 19 in your application and [install `@master/icons-react`](https://icons.master.co/guide/getting-started.md#install).
```tsx
import { SearchIcon } from '@master/icons-react';
```
The dynamic entry includes all nine optical size and corner combinations, along with their supported stroke widths, for each imported icon. It shares the same geometry as the other frameworks and SVG. `size` selects the nearest optical drawing; `corner` defaults to `soft`.
## Fixed icons
```tsx
import { SearchIcon } from '@master/icons-react/16/soft';
```
Fixed entries include only one optical size and corner style. Replace `16/soft` with any combination of `16`, `20`, `24` and `sharp`, `soft`, `rounded`. Fixed components do not accept `corner` or `opticalSize`; `size` only scales the selected drawing. Use the same fixed entry across an interface to keep its visual language consistent.
## Framework behavior
Components accept standard SVG props and events, and forward a ref to the SVG element through `forwardRef`. They render on the server and in the browser without a client-only wrapper.
Unlabeled icons are decorative. Use `label`, `aria-label` or `aria-labelledby` for a meaningful icon, or label the enclosing button. See [accessibility](https://icons.master.co/guide/accessibility.md).
## Custom stroke width
Both entries accept `strokeWidth`, in native units and steps of 0.25. It selects redrawn geometry rather than changing the SVG stroke attribute.
```tsx
import { SearchIcon } from '@master/icons-react/24/soft';
```
See [stroke width](https://icons.master.co/guide/stroke-width.md) for the range of each optical size and how widths are drawn.
Source: https://icons.master.co/guide/react.md
---
# Vue
Render dynamic or fixed optical drawings in Vue.
## Dynamic icons
Vue is a required peer dependency. Install Vue 3.5 or a later 3.x release in your application and [install `@master/icons-vue`](https://icons.master.co/guide/getting-started.md#install).
```vue
```
The dynamic entry includes all nine optical size and corner combinations, along with their supported stroke widths, for each imported icon. It shares the same geometry as the other frameworks and SVG. `size` selects the nearest optical drawing; `corner` defaults to `soft`.
## Fixed icons
```vue
```
Fixed entries include only one optical size and corner style. Replace `16/soft` with any combination of `16`, `20`, `24` and `sharp`, `soft`, `rounded`. Fixed components do not accept `corner` or `opticalSize`; `size` only scales the selected drawing.
## Framework behavior
Use `optical-size` in templates, such as `:optical-size="16"`. SVG attributes and event listeners are forwarded to the SVG root. These are functional components; a component ref is not an SVG element ref.
Unlabeled icons are decorative. Use `label`, `aria-label` or `aria-labelledby` for a meaningful icon, or label the enclosing button. See [accessibility](https://icons.master.co/guide/accessibility.md).
## Custom stroke width
Both entries accept `strokeWidth`, in native units and steps of 0.25. It selects redrawn geometry rather than changing the SVG stroke attribute.
```vue
```
See [stroke width](https://icons.master.co/guide/stroke-width.md) for the range of each optical size and how widths are drawn.
Source: https://icons.master.co/guide/vue.md
---
# Svelte
Render dynamic or fixed optical drawings in Svelte.
## Dynamic icons
Svelte is a required peer dependency. Install Svelte 5 in your application and [install `@master/icons-svelte`](https://icons.master.co/guide/getting-started.md#install).
```svelte
```
The dynamic entry includes all nine optical size and corner combinations, along with their supported stroke widths, for each imported icon. It shares the same geometry as the other frameworks and SVG. `size` selects the nearest optical drawing; `corner` defaults to `soft`.
## Fixed icons
```svelte
```
Fixed entries include only one optical size and corner style. Replace `16/soft` with any combination of `16`, `20`, `24` and `sharp`, `soft`, `rounded`. Fixed components do not accept `corner` or `opticalSize`; `size` only scales the selected drawing.
## Framework behavior
Native `.svelte` sources are compiled by your application for the server and browser. Use Svelte 5 event props such as `onclick`. `bind:ref` exposes the SVG element; changing `size` or `corner` updates the drawing.
Unlabeled icons are decorative. Use `label`, `aria-label` or `aria-labelledby` for a meaningful icon, or label the enclosing button. See [accessibility](https://icons.master.co/guide/accessibility.md).
## Custom stroke width
Both entries accept `strokeWidth`, in native units and steps of 0.25. It selects redrawn geometry rather than changing the SVG stroke attribute.
```svelte
```
See [stroke width](https://icons.master.co/guide/stroke-width.md) for the range of each optical size and how widths are drawn.
Source: https://icons.master.co/guide/svelte.md
---
# Preact
Render dynamic or fixed optical drawings in Preact.
## Dynamic icons
Preact is a required peer dependency. Install Preact 11 in your application and [install `@master/icons-preact`](https://icons.master.co/guide/getting-started.md#install).
```tsx
import { SearchIcon } from '@master/icons-preact';
```
The dynamic entry includes all nine optical size and corner combinations, along with their supported stroke widths, for each imported icon. It shares the same geometry as the other frameworks and SVG. `size` selects the nearest optical drawing; `corner` defaults to `soft`.
## Fixed icons
```tsx
import { SearchIcon } from '@master/icons-preact/16/soft';
```
Fixed entries include only one optical size and corner style. Replace `16/soft` with any combination of `16`, `20`, `24` and `sharp`, `soft`, `rounded`. Fixed components do not accept `corner` or `opticalSize`; `size` only scales the selected drawing.
## Framework behavior
Use your application’s Preact JSX configuration. Components accept SVG props, event handlers and SVG refs. This entry uses Preact directly and does not require React.
Unlabeled icons are decorative. Use `label`, `aria-label` or `aria-labelledby` for a meaningful icon, or label the enclosing button. See [accessibility](https://icons.master.co/guide/accessibility.md).
## Custom stroke width
Both entries accept `strokeWidth`, in native units and steps of 0.25. It selects redrawn geometry rather than changing the SVG stroke attribute.
```tsx
import { SearchIcon } from '@master/icons-preact/24/soft';
```
See [stroke width](https://icons.master.co/guide/stroke-width.md) for the range of each optical size and how widths are drawn.
Source: https://icons.master.co/guide/preact.md
---
# Astro
Render dynamic or fixed optical drawings in Astro.
## Dynamic icons
Astro is a required peer dependency. Install Astro 7 in your application and [install `@master/icons-astro`](https://icons.master.co/guide/getting-started.md#install).
```astro
---
import { SearchIcon } from '@master/icons-astro';
---
```
The dynamic entry includes all nine optical size and corner combinations, along with their supported stroke widths, for each imported icon. It shares the same geometry as the other frameworks and SVG. `size` selects the nearest optical drawing; `corner` defaults to `soft`.
## Fixed icons
```astro
---
import { SearchIcon } from '@master/icons-astro/16/soft';
---
```
Fixed entries include only one optical size and corner style. Replace `16/soft` with any combination of `16`, `20`, `24` and `sharp`, `soft`, `rounded`. Fixed components do not accept `corner` or `opticalSize`; `size` only scales the selected drawing.
## Framework behavior
Native `.astro` components render inline SVG without client-side icon JavaScript. No framework integration or `client:*` directive is needed. SVG attributes, `class:list` and a default slot are supported. Follow Astro’s Node.js requirements.
Unlabeled icons are decorative. Use `label`, `aria-label` or `aria-labelledby` for a meaningful icon, or label the enclosing button. See [accessibility](https://icons.master.co/guide/accessibility.md).
## Custom stroke width
Both entries accept `strokeWidth`, in native units and steps of 0.25. It selects redrawn geometry rather than changing the SVG stroke attribute.
```astro
---
import { SearchIcon } from '@master/icons-astro/24/soft';
---
```
See [stroke width](https://icons.master.co/guide/stroke-width.md) for the range of each optical size and how widths are drawn.
Source: https://icons.master.co/guide/astro.md
---
# Sizes and corners
Choose a drawing for the space available.
## Optical sizes
Each icon has drawings for 16, 20 and 24 pixels. Small drawings can simplify dense details; they are not merely scaled versions of the largest drawing.
The default display size is 24. Automatic optical selection chooses the nearest master; ties at 18 and 22 choose the larger one. CSS width and height do not trigger optical selection. Prefer native 16, 20 or 24 pixels for the intended result.
Start at 24 px for a general interface, and choose 16 or 20 px for a dense one, such as a toolbar or a table. Larger display sizes scale the 24 px drawing.
## Corner styles
Choose `sharp`, `soft` or `rounded`. The default is `soft`. These styles adjust geometry and internal spacing, not only SVG line joins. Natural curves and deliberately flat details can remain unchanged across styles.
Compare all nine masters in an icon's detail dialog in the [collection](https://icons.master.co/icons). To change line weight as well, see [stroke width](https://icons.master.co/guide/stroke-width.md).
Source: https://icons.master.co/guide/optical-sizes.md
---
# Stroke width
Adjust line weight while keeping cutouts and spacing.
## Set a width
Every icon accepts `strokeWidth`, in the dynamic and fixed entries of each framework package and in the JavaScript renderer.
```tsx
import { SearchIcon } from '@master/icons-react/24/soft';
```
```js
import { Search, renderSvg } from '@master/icons';
const svg = renderSvg(Search, { size: 20, strokeWidth: 1.75 });
```
Omit it to keep the drawing's native width. In the [collection](https://icons.master.co/icons), the stroke slider previews a width on every icon, and the copied code and downloads include it.
## Ranges
Widths are in the native units of the optical master's viewBox, in steps of 0.25. Each master supports its own range:
| Optical size | Native width | Range |
| --- | --- | --- |
| 16 px | 1.25 | 0.75–1.5 |
| 20 px | 1.5 | 1–2 |
| 24 px | 1.75 | 1.25–2.5 |
Values outside the selected master's range are clamped to it. Nonpositive and nonfinite values, and values that are not a multiple of 0.25, throw an error.
## Redrawn geometry
Changing the SVG `stroke-width` attribute only thickens lines in place, which closes gaps, cutouts and the space between details. Each supported width is drawn ahead of time instead: cutouts, masks and clearances are recomputed for it, so a heavier icon keeps its spacing. Never override `stroke-width` with CSS.
Display `size` scales the whole drawing, including its stroke. Brand marks keep their original shape and ignore the width; their outline versions, such as `brand-github-outline`, accept it.
## Download sets
Each optical size has one ZIP archive of every supported width in every corner style, such as `master-icons-24-strokes.zip` with folders like `soft/stroke-2/`. Its files carry the same license notices as the native sets. See [download](https://icons.master.co/guide/download.md#sets).
Source: https://icons.master.co/guide/stroke-width.md
---
# Accessibility
Give meaning to icons and the controls around them.
## Name the control
An icon beside visible text is decorative. Leave `label` unset: the renderer sets `aria-hidden="true"`. For an icon-only button, give the button an accessible name.
```tsx
```
## Name a standalone icon
When an icon conveys information by itself, provide `label`. The renderer adds `role="img"` and the accessible label.
```tsx
```
Do not rely on color alone to convey state. Keep keyboard focus visible, provide a large enough activation area, and place essential explanations in text.
Source: https://icons.master.co/guide/accessibility.md
---
# License and attribution
Keep the notices that travel with the icons.
## Master Icons
Master Icons is open source under the [MIT license](https://icons.master.co/LICENSE.txt). Preserve applicable copyright and license notices when redistributing the icons.
## Brand icons
The `brand-` collection includes Simple Icons, official brand assets, the Master mark, and a documented Dcard raster-to-vector trace. Artwork licenses are separate from the code license: Vue retains CC-BY-NC-SA-4.0 with additional permissions; JavaScript and GitHub Copilot retain upstream MIT notices; Microsoft and OpenAI assets retain their own terms. Source-specific notices are preserved in the package and downloads, including `licenses/brand-additions.txt`. Dcard uses an archived app mark; its original guide specifies a 48 px minimum, so the smaller exports are optical previews rather than a claim of guideline compliance. Brand names and marks belong to their respective owners; the code license does not grant trademark rights. See the [third-party notices](https://icons.master.co/THIRD_PARTY_NOTICES.md) for individual sources and versions.
## Adapted work
Some drawings adapt the construction of other open-source icon sets, including Lucide, Tabler, Phosphor, Hugeicons Free, Iconoir and Material Design Icons. Each adapted icon keeps its upstream MIT, ISC or Apache 2.0 notice in its SVG file, the package and the download archives. Read the [third-party notices](https://icons.master.co/THIRD_PARTY_NOTICES.md) for the exact source of every icon.
The `teapot` drawing adapts the lid of an OpenMoji emoji. That drawing and its modifications are licensed under CC BY-SA 4.0, not the MIT license; its SVG and the package include the complete notice.
The independent review tool also includes upstream comparison drawings. Those research assets are separate from the Master Icons package and website; their original licenses remain with the research files.
Source: https://icons.master.co/guide/license.md