Release candidate for Lucide v1 is out!🚀
You're looking at the site for v1, for v0 go to v0 site

Skip to content

Migration Guide: react-feather → lucide-react

react-feather is similar to lucide-react, the package is inspired by react-feather. The API is nearly identical, so migration is straightforward.

1. Install the new package

sh
npm install lucide-react
npm uninstall react-feather

2. Update imports

Replace all react-feather imports with lucide-react:

diff
- import { Home, User } from 'react-feather'
+ import { Home, User } from 'lucide-react'

You can do this across your entire codebase with a find-and-replace:

  • Find: from 'react-feather'
  • Replace: from 'lucide-react'

3. Renamed icons

Four icons have been renamed. Update any usages of these:

react-featherlucide-react
GitHubGithub
GridLayoutGrid
TableTable2
ToolWrench

Examples

diff
- import { GitHub, Grid, Table, Tool } from 'react-feather'
+ import { Github, LayoutGrid, Table2, Wrench } from 'lucide-react'

- <GitHub />
+ <Github />

- <Grid />
+ <LayoutGrid />

- <Table />
+ <Table2 />

- <Tool />
+ <Wrench />

4. All other icons

All remaining icons keep the same name and work as drop-in replacements. No other changes to props or usage are required.