React Iconoir Icons

NPM Version NPM Monthly Downloads NPM License

Iconoir is an open source library with 900+ SVG Icons. No premium icons, no email sign-up, no newsletters. You can browse the full suite of icons at iconoir.com.

iconoir-react is an open source package that exports these icons as React.js components that can be used in all of your React projects.

Installation

yarn add iconoir-react

or

npm i iconoir-react

Usage

import React from 'react';
import { Iconoir } from 'iconoir-react';

const App = () => {
  return <Iconoir />
};

export default App;

Icons can take any standard SVG properties as optional props, e.g.

<Iconoir color="red" height={36} width={36} />

Default values for the most common props are given below:

Prop nameDefault value
color"currentColor"
width"1.5em"
height"1.5em"
strokeWidth1.5

IconoirProvider

Tired of specifying the same props for every single icon, every time you use them? So were we. Use IconoirProvider to set the default icon props for everything inside IconoirProvider.

import { IconoirProvider, Check } from 'iconoir-react'

return (
  <IconoirProvider
    iconProps={{
      color: '#AAAAAA',
      strokeWidth: 1,
      width: '1em',
      height: '1em',
    }}
  >
    <SomeOtherContainer>
      <Check />
    </SomeOtherContainer>
  </IconoirProvider>
)

Icon names

For the most part, the React components are named as PascalCase variations of their reference names (i.e. add-circle-outline becomes AddCircleOutline). However, some names have been altered slightly either because they start with numerical digits, which would lead to invalid React component names, or because they are organisations which use PascalCase in their brand names, such as GitHub. The altered names are as follows:

Iconoir NameReact Component
1st-medalMedal1St
4k-displayDisplay4K
4x4-cellCell4X4
360-viewView360
githubGitHub
github-outlineGitHubOutline
gitlab-fullGitLabFull
linkedinLinkedIn
tiktokTikTok
youtubeYouTube
More?
If you would like to use Iconoir on a different library or if you want to contribute to support a new library, open a feature request in our official GitHub repository.
Iconoir Logo
Parts of this content are ©2020-2023 by individual Iconoir contributors. Content available under a MIT License.