```
+
+## Accessibility
+
+By default, we hide icons from screen readers using `aria-hidden="true"`.
+
+You can add accessibility attributes using aria-labels.
+
+```vue
+
+
+
+
+
+```
+
+For best practices on accessibility, please see our [accessibility guide](../accessibility.md).
diff --git a/docs/guide/packages/lucide.md b/docs/guide/packages/lucide.md
deleted file mode 100644
index 4f95a57db..000000000
--- a/docs/guide/packages/lucide.md
+++ /dev/null
@@ -1,226 +0,0 @@
-# Lucide
-
-The core Lucide package for vanilla JavaScript applications. This package allows you to easily add scalable vector icons to any web project without framework dependencies. Perfect for static websites, legacy applications, or when you need lightweight icon integration with maximum browser compatibility.
-
-**What you can accomplish:**
-- Add icons to HTML using simple data attributes
-- Dynamically create and insert SVG icons with JavaScript
-- Customize icon appearance with CSS classes and inline styles
-- Tree-shake unused icons to keep bundle sizes minimal
-- Use icons in any JavaScript environment or plain HTML
-
-## Installation
-
-### Package Managers
-
-::: code-group
-
-```sh [pnpm]
-pnpm add lucide
-```
-
-```sh [yarn]
-yarn add lucide
-```
-
-```sh [npm]
-npm install lucide
-```
-
-```sh [bun]
-bun add lucide
-```
-
-:::
-
-### CDN
-
-```html
-
-
-
-
-
-```
-
-## Usage
-
-### With unpkg
-
-Here is a complete example with unpkg
-
-```html
-
-
-
-
-
-
-
-
-
-```
-We strongly suggest you anchor to a specific version, such as `https://unpkg.com/lucide@x.xxx.x/dist/umd/lucide.min.js`, rather than using `@latest`.
-
-### With ESModules
-
-To reduce bundle size, lucide is built to be fully tree-shakable.
-The `createIcons` function will search for HTMLElements with the attribute `data-lucide` and replace it with the svg from the given icon name.
-
-```html
-
-
-```
-
-```js
-import { createIcons, icons } from 'lucide';
-
-// Caution, this will import all the icons and bundle them.
-createIcons({ icons });
-
-// Recommended way, to include only the icons you need.
-import { createIcons, Menu, ArrowRight, Globe } from 'lucide';
-
-createIcons({
- icons: {
- Menu,
- ArrowRight,
- Globe
- }
-});
-```
-
-## Advanced Usage
-
-### Additional Options
-
-In the `createIcons` function you can pass some extra parameters:
-
-- you can pass `nameAttr` to adjust the attribute name to replace for
-- you can pass `attrs` to pass additional custom attributes, for instance CSS classes or stroke options.
-- you can pass `root` to provide a custom DOM element the icons should be replaced in (useful when manipulating small sections of a large DOM or elements in the shadow DOM)
-- you can pass `inTemplates: true` to also replace icons inside `` tags.
-
-Here is a full example:
-
-```js
-import { createIcons } from 'lucide';
-
-createIcons({
- attrs: {
- class: ['my-custom-class', 'icon'],
- 'stroke-width': 1,
- stroke: '#333'
- },
- nameAttr: 'data-lucide', // attribute for the icon name.
- root: element, // DOM element to replace icons in.
- inTemplates: true // Also replace icons inside tags.
-});
-```
-
-### Treeshake the library, only use the icons you use
-
-```js
-import { createIcons, Menu, ArrowRight, Globe } from 'lucide';
-
-createIcons({
- icons: {
- Menu,
- ArrowRight,
- Globe
- }
-});
-```
-
-### Custom Document root
-
-Apply icons in a custom root element, for instance a shadow DOM root.
-
-```js
-import { createIcons } from 'lucide';
-
-// Custom root element, for instance a shadow DOM root.
-const shadowRoot = element.attachShadow({ mode: 'open' });
-
-createIcons({
- root: shadowRoot
-});
-```
-
-### Apply icons inside `` tags
-
-By default icons inside `` tags are not added.
-By setting the `inTemplates` option to `true`, icons inside templates will also be replaced.
-
-```js
-import { createIcons } from 'lucide';
-
-createIcons({
- inTemplates: true
-});
-```
-
-### Custom Element binding
-
-```js
-import { createElement, Menu } from 'lucide';
-
-const menuIcon = createElement(Menu); // Returns HTMLElement (svg)
-
-// Append HTMLElement in the DOM
-const myApp = document.getElementById('app');
-myApp.appendChild(menuIcon);
-```
-
-#### Custom Element binding with custom attributes
-
-```js
-import { createElement, Menu } from 'lucide';
-
-const menuIcon = createElement(Menu, {
- class: ['my-custom-class', 'icon'],
- 'stroke-width': 1,
- stroke: '#333'
-}); // Returns HTMLElement (svg)
-
-// Append HTMLElement in the DOM
-const myApp = document.getElementById('app');
-myApp.appendChild(menuIcon);
-```
-
-### With Lucide lab or custom icons
-
-[Lucide lab](https://github.com/lucide-icons/lucide-lab) is a collection of icons that are not part of the Lucide main library.
-They can be used in the same way as the official icons.
-
-```js
-import { coconut } from '@lucide/lab';
-
-createIcons({
- icons: {
- coconut
- }
-});
-```
-
-## Accessibility
-
-By default, we hide icons from screen readers using `aria-hidden="true"`.
-
-You can add accessibility attributes using aria-labels.
-
-```html
-
-
-
-
-
-
-
-```
-
-For best practices on accessibility, please see our [accessibility guide](../advanced/accessibility.md).
diff --git a/docs/guide/preact/advanced/accessibility.md b/docs/guide/preact/advanced/accessibility.md
new file mode 100644
index 000000000..f7f99d347
--- /dev/null
+++ b/docs/guide/preact/advanced/accessibility.md
@@ -0,0 +1,52 @@
+---
+title: Accessibility - Preact
+description: Best practices for accessible icons in your Preact application.
+---
+
+
+
+# Accessibility
+
+Lucide icons ship with `aria-hidden="true"` by default. In almost all cases this is exactly what you want.
+
+## Should icons be accessible?
+
+Most of the time, icons are used purely for decoration or visual reinforcement. Exposing decorative icons to assistive technologies can create unnecessary noise for screen reader users.
+
+For a broader explanation of this, and other best practices on how to use icons accessibly in your application, please refer to our detailed guide on accessibility:
+
+
+
+Only if an icon **conveys essential meaning on its own** should it be made accessible. The sections below explain how to do that in Preact.
+
+## Making an icon accessible
+
+To expose an icon to assistive technologies, provide an accessible name by passing a `title` element as a child or passing the `aria-label` prop to the icon component.
+
+This removes the `aria-hidden` attribute and makes the icon visible to screen readers.
+
+```tsx
+
+ This is my house
+
+
+// or
+
+
+```
+
+Choose a label that clearly describes the meaning of the icon or the action it represents in the context of your application.
+
+## Accessible icon buttons
+
+When an icon is used inside a button, the accessible label should usually be applied to the button itself, and not the icon.
+
+```tsx
+
+```
+
+This ensures assistive technologies describe the interactive element, rather than the decorative graphic inside it.
diff --git a/docs/guide/preact/advanced/aliased-names.md b/docs/guide/preact/advanced/aliased-names.md
new file mode 100644
index 000000000..27c420cce
--- /dev/null
+++ b/docs/guide/preact/advanced/aliased-names.md
@@ -0,0 +1,59 @@
+---
+title: Aliased Names - Preact
+description: Learn about the different import name styles available for Lucide icons in your project and how to choose the one that best fits your needs.
+---
+# Aliased Names
+
+Some icons have multiple names. This is because we sometimes choose to rename them to make them more consistent with the rest of the icon set, or the name was not generic. For example, the `edit-2` icon is renamed to `pen` to make the name more generic, since it is just a pen icon.
+
+Beside these aliases, Lucide also includes prefixed and suffixed names to use within your project. This is to prevent import name collisions with other libraries or your own code.
+
+```tsx
+// These are all the same icon
+import {
+ House,
+ HouseIcon,
+ LucideHouse,
+} from "lucide-preact";
+```
+
+## Choosing import name style
+
+If you want consistent imports across your project, or if you want to change the autocompletion of Lucide icons in your IDE, there an option to choose the import name style you prefer.
+
+This can be done by creating a custom module declaration file to override Lucide imports and turning off the autocomplete in your IDE.
+
+### Turn off autocomplete in your IDE
+
+```json [.vscode/settings.json]
+{
+ "js/ts.preferences.autoImportFileExcludePatterns": [
+ "lucide-preact",
+ ]
+}
+```
+
+### Create a custom module declaration file
+
+Create a custom TypeScript declaration file that re-exports the preferred naming style:
+
+```ts [lucide-preact.d.ts]
+declare module "lucide-preact" {
+ // Prefixed import names
+ export * from "lucide-preact/dist/lucide-preact.prefixed";
+ // or
+ // Suffixed import names
+ export * from "lucide-preact/dist/lucide-preact.suffixed";
+}
+```
+
+Place this file in your project root or in a directory included in your TypeScript configuration.
+A common approach is to create a `@types` folder and name the file `lucide-preact.d.ts`.
+
+### Import name styles
+
+| Import Style | Available imports | Declaration file import |
+| ------------- | --------------------------- | ----------------------- |
+| Default | Home, HomeIcon, LucideHome | |
+| Prefixed | LucideHome | lucide-preact.prefixed |
+| Suffixed | HomeIcon | lucide-preact.suffixed |
diff --git a/docs/guide/preact/advanced/combining-icons.md b/docs/guide/preact/advanced/combining-icons.md
new file mode 100644
index 000000000..cd2dc2871
--- /dev/null
+++ b/docs/guide/preact/advanced/combining-icons.md
@@ -0,0 +1,117 @@
+---
+title: Combining icons - Preact
+description: Learn how to combine multiple icons into a single icon nested SVG elements in your Preact application.
+---
+
+
+# Combining icons
+
+You can combine multiple icons into a single icon by nesting SVG elements.
+This is useful if you want to create custom icons icons by combining existing ones.
+
+::: sandpack {showTabs=false editorHeight=400 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```jsx App.js [active]
+import { Scan, User } from "lucide-preact";
+import { h } from "preact";
+
+function App() {
+ return (
+
+
+
+
+
+ );
+}
+
+export default App;
+
+```
+:::
+
+This is valid, since [SVGs can be nested](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/svg#nested_svg_element), and all SVG properties are supported on the icons.
+The `x` and `y` coordinates can be adjusted to position the icons as you like.
+
+::: info Limitation
+When combining icons, you need to make sure that the `x` and `y` coordinates are within the `viewBox` of the outer icon (24x24).
+:::
+
+## With native SVG elements
+
+You can also combine Lucide icons with native SVG elements to build custom icon variations.
+
+### Example with notification badge
+
+For example, you can add a notification badge to an icon by using the `circle` SVG element.
+
+::: sandpack {showTabs=false editorHeight=580 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```jsx App.js [active]
+import { Mail } from "lucide-preact";
+import { h } from "preact";
+
+function App() {
+ const hasUnreadMessages = true;
+
+ return (
+
+
+ {hasUnreadMessages && (
+
+ )}
+
+
+ );
+}
+
+export default App;
+
+```
+:::
+
+### Example with text element
+
+You can also use the `text` SVG element to add text to your icon.
+
+::: sandpack {showTabs=false editorHeight=400 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```jsx App.js [active]
+import { File } from "lucide-preact";
+import { h } from "preact";
+
+function App() {
+ return (
+
+
+
+ JS
+
+
+
+ );
+}
+
+export default App;
+
+```
+:::
diff --git a/docs/guide/preact/advanced/filled-icons.md b/docs/guide/preact/advanced/filled-icons.md
new file mode 100644
index 000000000..28da66430
--- /dev/null
+++ b/docs/guide/preact/advanced/filled-icons.md
@@ -0,0 +1,63 @@
+---
+title: Filled Icons - Preact
+description: Learn how to use fills with Lucide icons in your Preact application, and the limitations of using fills with Lucide icons.
+---
+
+
+# Filled Icons
+
+Fills are officially not supported.
+However, all SVG properties are available on all icons.
+Fill can still be used and will work fine on certain icons.
+
+Example with stars:
+
+::: sandpack { editorHeight=580 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```jsx App.js [active]
+import { Star, StarHalf } from "lucide-preact";
+import { h } from "preact";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+ { Array.from({ length: 5 }, () => (
+
+ ))}
+
+
+
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+
+```css icon.css
+.star-rating {
+ position: relative;
+}
+
+.stars {
+ display: flex;
+ gap: 4px;
+}
+
+.rating {
+ position: absolute;
+ top: 0;
+}
+
+```
+
+:::
diff --git a/docs/guide/preact/advanced/global-styling.md b/docs/guide/preact/advanced/global-styling.md
new file mode 100644
index 000000000..c8e77feb7
--- /dev/null
+++ b/docs/guide/preact/advanced/global-styling.md
@@ -0,0 +1,162 @@
+---
+title: Global Styling - Preact
+description: Learn how to style all Lucide icons globally in your Preact application using CSS or the Lucide context provider.
+---
+
+
+# Global Styling
+
+Adjusting icons can be done by using [color](../basics/color.md), [size](../basics/sizing.md) and [stroke width](../basics/stroke-width.md).
+To style all icons globally, you can either use CSS, or use a context provider.
+
+We recommend using CSS for global styling, as it is the most straightforward way to achieve this.
+But using CSS prevents you from using props like `size`, `color` and `strokeWidth` on individual icons, since CSS specificity will override these props, to be able to use the props on individual ones you need to use the Lucide context provider.
+
+## Context Provider
+
+For global styling using a context provider, you can use the `LucideProvider` component that is provided by the `lucide-preact` package.
+
+```tsx
+import { LucideProvider, Home } from 'lucide-preact';
+
+const App = () => (
+
+
+
+);
+```
+
+This will apply the `color`, `size` and `strokeWidth` props to all icons that are children of the `LucideProvider`.
+
+
+## Style by using CSS
+Styling icons is easy to accomplish using CSS.
+
+Every icon has a class attribute applied called `lucide`. This class name can be used in the CSS file to target all icons that are being used within the app.
+
+- The **color** of the icons can be changed using the [`color`](https://developer.mozilla.org/en-US/docs/Web/CSS/color) CSS property.
+- The **size** of the icons can be changed using [`width`](https://developer.mozilla.org/en-US/docs/Web/CSS/width) and [`height`](https://developer.mozilla.org/en-US/docs/Web/CSS/height) CSS properties.
+- The **stroke width** of the icons can be changed using the [`stroke-width`](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-width) CSS property.
+
+::: sandpack {editorHeight=400 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```css icon.css [active]
+.lucide {
+ /* Change this! */
+ color: #ffadff;
+ width: 48px;
+ height: 48px;
+ stroke-width: 1px;
+}
+
+.grid {
+ display: grid;
+ grid-template-columns: 1fr 1fr 1fr;
+ grid-template-rows: 1fr 1fr 1fr;
+ gap: 6px;
+}
+```
+
+```jsx App.js
+import {
+ CakeSlice,
+ Candy,
+ Apple,
+ Cookie,
+ Martini,
+ IceCream2,
+ Sandwich,
+ Wine,
+ Dessert,
+} from "lucide-preact";
+import { h } from "preact";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+
+
+
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+
+### Absolute stroke width
+
+For global absolute stroke width styling the `vector-effect: non-scaling-stroke` CSS property can be applied to the children. This will keep the stroke-width the same size no matter the size of the icon. See [absolute-stroke-width](../basics/stroke-width.md#absolute-stroke-width) for more info.
+
+::: sandpack {editorHeight=480 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```css icon.css [active]
+.lucide {
+ width: 48px;
+ height: 48px;
+ stroke-width: 1.5;
+}
+
+.lucide * {
+ vector-effect: non-scaling-stroke;
+}
+
+.grid {
+ display: grid;
+ grid-template-columns: 1fr 1fr 1fr;
+ grid-template-rows: 1fr 1fr 1fr;
+ gap: 6px;
+}
+```
+
+```jsx App.js
+import {
+ TentTree,
+ Caravan,
+ FlameKindling,
+ MountainSnow,
+ Trees,
+ Axe,
+ Map,
+ CloudMoon,
+ Sparkles,
+} from "lucide-preact";
+import { h } from "preact";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+
+
+
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
diff --git a/docs/guide/preact/advanced/typescript.md b/docs/guide/preact/advanced/typescript.md
new file mode 100644
index 000000000..b55c7c720
--- /dev/null
+++ b/docs/guide/preact/advanced/typescript.md
@@ -0,0 +1,97 @@
+---
+title: Typescript - Preact
+description: Learn about the different types exported by the `lucide-preact` package and how to use them in your Preact application.
+---
+# TypeScript
+
+List of exported types from the `lucide-preact` package.
+These can be used to type your components when using Lucide icons in a TypeScript React project
+
+## `LucideProps`
+
+Exports all props that can be passed to an icon component and any other SVG attributes, see: [SVG Presentation Attributes on MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/Presentation).
+
+```ts
+interface LucideProps {
+ size?: number | string;
+ color?: string;
+ strokeWidth?: number;
+ absoluteStrokeWidth?: boolean;
+ [key: string]: any; // Any other SVG attributes
+}
+```
+
+### Using `LucideProps`
+You can use the `LucideProps` interface to type your custom icon components or when you need to work with icon props.
+
+```tsx
+import { type LucideProps } from 'lucide-preact';
+import { Camera } from 'lucide-preact';
+
+const WrapIcon = (props: LucideProps) => {
+ return ;
+};
+
+export default WrapIcon;
+```
+
+## `LucideIcon`
+
+Type for individual icon components.
+
+```ts
+type LucideIcon = React.FC;
+```
+
+### Using `LucideIcon`
+
+You can use the `LucideIcon` type when you need to work with icon components directly.
+
+```tsx
+import { type LucideIcon } from 'lucide-preact';
+
+interface ButtonProps {
+ icon: LucideIcon;
+ label: string;
+}
+
+const IconButton = ({ icon: Icon, label }: ButtonProps) => {
+ return (
+
+ );
+};
+
+export default IconButton;
+```
+
+## `IconNode`
+
+Type for the raw SVG structure of an icon. This is an array of SVG elements and their attributes to render the icon.
+Not commonly used directly in application code. But can be useful for advanced use cases, such as using custom icons or with Lucide Lab.
+
+```ts
+type IconNode = [elementName: string, attrs: Record][];
+```
+
+### Using `IconNode`
+You can use the `IconNode` type when you need to work with the raw SVG structure of an icon.
+
+```tsx
+import { type IconNode, Icon } from 'lucide-preact';
+
+const customIcon: IconNode = [
+ ['circle', { cx: 12, cy: 12, r: 10 }],
+ ['line', { x1: 12, y1: 8, x2: 12, y2: 12 }],
+ ['line', { x1: 12, y1: 16, x2: 12, y2: 16 }],
+];
+
+const MyCustomIcon = () => {
+ return (
+
+ );
+};
+
+export default MyCustomIcon;
+```
diff --git a/docs/guide/preact/advanced/with-lucide-lab.md b/docs/guide/preact/advanced/with-lucide-lab.md
new file mode 100644
index 000000000..855a5505b
--- /dev/null
+++ b/docs/guide/preact/advanced/with-lucide-lab.md
@@ -0,0 +1,23 @@
+---
+title: With Lucide Lab or custom icons - Preact
+description: Learn how to use Lucide Lab or custom icons in your Preact applications using the Icon component.
+---
+# With Lucide Lab or custom icons
+
+[Lucide Lab](https://github.com/lucide-icons/lucide-lab) is a collection of icons that are not part of the Lucide main library.
+
+They can be used by using the `Icon` component.
+All props like regular lucide icons can be passed to adjust the icon appearance.
+
+## Using the `Icon` component
+
+This creates a single icon based on the iconNode passed and renders a Lucide icon component.
+
+```jsx
+import { Icon } from 'lucide-preact';
+import { coconut } from '@lucide/lab';
+
+const App = () => (
+
+);
+```
diff --git a/docs/guide/preact/basics/color.md b/docs/guide/preact/basics/color.md
new file mode 100644
index 000000000..48d16aee4
--- /dev/null
+++ b/docs/guide/preact/basics/color.md
@@ -0,0 +1,72 @@
+---
+title: Color - Preact
+description: Learn how to adjust the color of icons in your Preact application using the `color` prop or by using parent elements text color value.
+---
+
+
+# Color
+
+By default, all icons have the color value: `currentColor`. This keyword uses the element's computed text `color` value to represent the icon color.
+
+Read more about [ `currentColor` on MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#currentcolor_keyword).
+
+## Adjust the color using the `color` prop
+
+The color can be adjusted by passing the color prop to the element.
+
+::: sandpack {showTabs=false editorHeight=295 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```js App.js [active]
+import { h } from "preact";
+import { Smile } from "lucide-preact";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+## Using parent elements text color value
+
+Because the color of lucide icons uses `currentColor`, the color of the icon depends on the computed `color` of the element, or it inherits it from its parent.
+
+For example, if a parent element's color value is `#fff` and one of the children is a lucide icon, the color of the icon will be rendered as `#fff`. This is browser native behavior.
+
+::: sandpack {showTabs=false editorHeight=340 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```jsx Button.jsx [active]
+import { h } from "preact";
+import { ThumbsUp } from "lucide-preact";
+
+function LikeButton() {
+ return (
+
+ );
+}
+
+export default LikeButton;
+```
+
+```js App.js [hidden]
+import { h } from "preact";
+import Button from "./Button";
+
+export default function App() {
+ return ;
+}
+
+```
+
+:::
diff --git a/docs/guide/preact/basics/sizing.md b/docs/guide/preact/basics/sizing.md
new file mode 100644
index 000000000..cbe10ce3e
--- /dev/null
+++ b/docs/guide/preact/basics/sizing.md
@@ -0,0 +1,130 @@
+---
+title: Sizing - Preact
+description: Learn how to adjust the size of icons in your Preact application using the `size` prop or by using CSS.
+---
+
+
+# Sizing
+
+By default, the size of all icons is `24px` by `24px`. The size is adjustable using the `size` prop and CSS.
+
+## Adjusting the icon size using the `size` prop
+
+::: sandpack {showTabs=false editorHeight=320 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```js App.js [active]
+import { h } from "preact";
+import { Landmark } from "lucide-preact";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+## Adjusting the icon size via CSS
+
+The CSS properties `width` and `height` can be used to adjust the icon size.
+
+::: sandpack {editorHeight=320 dependencies="lucide-preact"}
+
+```css icon.css [active]
+.my-beer-icon {
+ /* Change this! */
+ width: 64px;
+ height: 64px;
+}
+```
+
+```jsx App.js
+import { h } from "preact";
+import { Beer } from "lucide-preact";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+### Dynamically change the icon size based on the font size
+
+It is possible to resize icons based on font size. This can be achieved using the `em` unit. See this [MDN article](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size#ems) for more information on the `em` unit.
+
+::: sandpack {editorHeight=320 dependencies="lucide-preact"}
+
+```css icon.css [active]
+.my-icon {
+ /* Icon size will relative to font-size of .text-wrapper */
+ width: 1em;
+ height: 1em;
+}
+
+.text-wrapper {
+ /* Change this! */
+ font-size: 96px;
+
+ /* layout stuff */
+ display: flex;
+ gap: 0.25em;
+ align-items: center;
+}
+```
+
+```jsx App.js
+import { h } from "preact";
+import { Star } from "lucide-preact";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
Yes
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+### Resizing with Tailwind
+
+`size-*` utilities can be used to adjust the size of the icon. See the [Tailwind documentation](https://tailwindcss.com/docs/width#setting-both-width-and-height) for more information on the `size-*` utilities.
+
+::: sandpack {showTabs=false editorHeight=300 editorWidthPercentage=60 dependencies="lucide-preact" externalResources="https://cdn.tailwindcss.com"}
+
+```js App.js [active]
+import { h } from "preact";
+import { PartyPopper } from "lucide-preact";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
+
diff --git a/docs/guide/preact/basics/stroke-width.md b/docs/guide/preact/basics/stroke-width.md
new file mode 100644
index 000000000..fe88199b3
--- /dev/null
+++ b/docs/guide/preact/basics/stroke-width.md
@@ -0,0 +1,69 @@
+---
+title: Stroke width - Preact
+description: Learn how to adjust the stroke width of icons in your Preact application using the `strokeWidth` prop or adjust the strokeWidth appearance using the `absoluteStrokeWidth` prop.
+---
+
+
+# Stroke width
+
+All icons are designed with SVG elements using strokes.
+These have a default stroke width of `2px`.
+
+The `strokeWidth` can be adjusted to create a different look of the icons.
+
+## Adjusting stroke width with `strokeWidth` prop
+
+::: sandpack {showTabs=false editorHeight=320 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```jsx App.js [active]
+import { h } from "preact";
+import { FolderLock } from "lucide-preact";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+## Absolute stroke width
+
+When adjusting the `size` prop the size of the stroke width will be relative to the size of the icon, this is the default SVG behavior. The `absoluteStrokeWidth` prop is introduced to adjust this behavior to make the stroke width constant no matter the size of the icon.
+
+This means that when `absoluteStrokeWidth` is enabled and the `size` of the icons is set to `48px` the `strokeWidth` will still be `2px` on the screen.
+
+Note `2px` is the default stroke width for a Lucide icon, this can be adjusted to all sizes.
+
+
+
+### Adjusting stroke width with `absoluteStrokeWidth` prop
+
+Setting `absoluteStrokeWidth` to `true` will make the stroke width absolute.
+
+::: sandpack {showTabs=false editorHeight=340 editorWidthPercentage=60 dependencies="lucide-preact"}
+
+```jsx App.js [active]
+import { h } from "preact";
+import { RollerCoaster } from "lucide-preact";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
diff --git a/docs/guide/preact/getting-started.md b/docs/guide/preact/getting-started.md
new file mode 100644
index 000000000..6b39f8b9d
--- /dev/null
+++ b/docs/guide/preact/getting-started.md
@@ -0,0 +1,81 @@
+---
+title: Getting started - Preact
+description: This guide will help you get started with Lucide in your Preact project.
+---
+
+
+# Getting started
+
+This guide will help you get started with Lucide in your Preact project.
+Make sure you have a Preact environment set up. If you don't have one yet, you can create a new Preact project using Create Preact App, Vite, or any other Preact boilerplate of your choice.
+
+## Installation
+
+
+
+::: code-group
+
+```sh [pnpm]
+pnpm add lucide-preact@next
+```
+
+```sh [yarn]
+yarn add lucide-preact@next
+```
+
+```sh [npm]
+npm install lucide-preact@next
+```
+
+```sh [bun]
+bun add lucide-preact@next
+```
+
+:::
+
+## Importing your first icon
+
+Lucide is built with ES Modules, so it's completely tree-shakable.
+
+Each icon can be imported as a Preact component, which renders an inline SVG element. This way, only the icons that are imported into your project are included in the final bundle. The rest of the icons are tree-shaken away.
+
+```jsx
+import { Camera } from 'lucide-preact';
+
+// Usage
+const App = () => {
+ return ;
+};
+
+export default App;
+```
+
+## Props
+
+To customize the appearance of an icon, you can use the following props:
+
+| name | type | default |
+| --------------------- | --------- | ------------ |
+| `size` | *number* | 24 |
+| `color` | *string* | currentColor |
+| `strokeWidth` | *number* | 2 |
+| `absoluteStrokeWidth` | *boolean* | false |
+
+Because icons render as SVG elements, all standard SVG attributes can also be applied as props. See the list of SVG Presentation Attributes on [MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/Presentation).
+
+```jsx
+// Usage
+const App = () => {
+ return ;
+};
+```
+
+More examples and details how to use props, continue the guide:
+
+
+
+
diff --git a/docs/guide/preact/index.md b/docs/guide/preact/index.md
new file mode 100644
index 000000000..c664aec10
--- /dev/null
+++ b/docs/guide/preact/index.md
@@ -0,0 +1,53 @@
+---
+title: Lucide for Preact
+description: Lucide provides a Preact icon component library that makes it easy to integrate icons into your Preact applications. Each icon is available as a standalone Preact component, allowing for seamless integration and customization.
+nextPage:
+ - getting-started
+---
+
+
+
+
+
+
+# Lucide for Preact
+
+Lucide provides a Preact icon component library that makes it easy to integrate icons into your Preact applications.
+Each icon is available as a standalone Preact component, allowing for seamless integration and customization.
+
+List of features:
+- **Easy to Use**: Import icons as Preact components and use them directly in your Preact components with JSX.
+- **Customizable**: Adjust size, color, and other properties via props.
+- **Tree-shakable**: Only the icons you use are included in your final bundle
+- **TypeScript Support**: Fully typed components for better developer experience.
+
+## Overview
+
+
+
+
+
+### Basics
+{{''}}
+
+
+
+
+
+### Advanced
+{{''}}
+
+
+
+
+
+### Resources
+{{''}}
+
+
+
+
diff --git a/docs/guide/preact/migration.md b/docs/guide/preact/migration.md
new file mode 100644
index 000000000..72261e47e
--- /dev/null
+++ b/docs/guide/preact/migration.md
@@ -0,0 +1,20 @@
+# Migration from v0
+
+Brand icons are removed in v1. If you are using any of the following icons, you will need to replace them with a custom SVG or an alternative icon:
+
+- Chromium
+- Codepen
+- Codesandbox
+- Dribbble
+- Facebook
+- Figma
+- Framer
+- Github
+- Gitlab
+- Instagram
+- LinkedIn
+- Pocket
+- RailSymbol (based on the British Rail logo)
+- Slack
+
+We recommend to use the official SVG icons provided by the respective brands, most of them can be found on their websites or in their brand guidelines. Alternatively, you can use the icons from [Simple Icons](https://simpleicons.org/), which provides a large collection of brand icons. Also with links to the official Brand Guidelines and SVG icons.
diff --git a/docs/guide/react-native/advanced/aliased-names.md b/docs/guide/react-native/advanced/aliased-names.md
new file mode 100644
index 000000000..77699f55e
--- /dev/null
+++ b/docs/guide/react-native/advanced/aliased-names.md
@@ -0,0 +1,59 @@
+---
+title: Aliased Names - React Native
+description: Learn about the different import name styles available for Lucide icons in your React Native project and how to choose the one that best fits your needs.
+---
+# Aliased Names
+
+Some icons have multiple names. This is because we sometimes choose to rename them to make them more consistent with the rest of the icon set, or the name was not generic. For example, the `edit-2` icon is renamed to `pen` to make the name more generic, since it is just a pen icon.
+
+Beside these aliases, Lucide also includes prefixed and suffixed names to use within your project. This is to prevent import name collisions with other libraries or your own code.
+
+```tsx
+// These are all the same icon
+import {
+ House,
+ HouseIcon,
+ LucideHouse,
+} from "lucide-react-native";
+```
+
+## Choosing import name style
+
+If you want consistent imports across your project, or if you want to change the autocompletion of Lucide icons in your IDE, there an option to choose the import name style you prefer.
+
+This can be done by creating a custom module declaration file to override Lucide imports and turning off the autocomplete in your IDE.
+
+### Turn off autocomplete in your IDE
+
+```json [.vscode/settings.json]
+{
+ "js/ts.preferences.autoImportFileExcludePatterns": [
+ "lucide-react-native",
+ ]
+}
+```
+
+### Create a custom module declaration file
+
+Create a custom TypeScript declaration file that re-exports the preferred naming style:
+
+```ts [lucide-react-native.d.ts]
+declare module "lucide-react-native" {
+ // Prefixed import names
+ export * from "lucide-react-native/dist/lucide-react-native.prefixed";
+ // or
+ // Suffixed import names
+ export * from "lucide-react-native/dist/lucide-react-native.suffixed";
+}
+```
+
+Place this file in your project root or in a directory included in your TypeScript configuration.
+A common approach is to create a `@types` folder and name the file `lucide-react-native.d.ts`.
+
+### Import name styles
+
+| Import Style | Available imports | Declaration file import |
+| ------------- | --------------------------- | ----------------------- |
+| Default | Home, HomeIcon, LucideHome | |
+| Prefixed | LucideHome | lucide-react-native.prefixed |
+| Suffixed | HomeIcon | lucide-react-native.suffixed |
diff --git a/docs/guide/react-native/advanced/combining-icons.md b/docs/guide/react-native/advanced/combining-icons.md
new file mode 100644
index 000000000..76e764340
--- /dev/null
+++ b/docs/guide/react-native/advanced/combining-icons.md
@@ -0,0 +1,136 @@
+---
+title: Combining icons - React Native
+description: Learn how to combine multiple icons into a single icon nested SVG elements in your React Native application.
+---
+
+# Combining icons
+
+You can combine multiple icons into a single icon by nesting SVG elements.
+This is useful if you want to create custom icons icons by combining existing ones.
+
+```SnackPlayer name=State&ext=js&dependencies=react-native-svg,lucide-react-native
+import React, {useState, useEffect} from 'react';
+import { View, StyleSheet } from 'react-native';
+import { Scan, User} from "lucide-react-native";
+
+const App = () => {
+ return (
+
+
+
+
+
+ );
+};
+
+const styles = StyleSheet.create({
+ container: {
+ height: '100%',
+ alignItems: 'center',
+ display: 'flex',
+ justifyContent: 'center'
+ },
+});
+
+export default App;
+```
+
+This is valid, since [SVGs can be nested](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/svg#nested_svg_element), and all SVG properties are supported on the icons.
+The `x` and `y` coordinates can be adjusted to position the icons as you like.
+
+::: info Limitation
+When combining icons, you need to make sure that the `x` and `y` coordinates are within the `viewBox` of the outer icon (24x24).
+:::
+
+## With native SVG elements
+
+You can also combine Lucide icons with native SVG elements to build custom icon variations.
+
+### Example with notification badge
+
+For example, you can add a notification badge to an icon by using the `circle` SVG element.
+
+```SnackPlayer name=State&ext=js&dependencies=react-native-svg,lucide-react-native
+import React, {useState, useEffect} from 'react';
+import { View, StyleSheet } from 'react-native';
+import { Mail } from "lucide-react-native";
+import { Circle } from 'react-native-svg';
+
+const App = () => {
+ const hasUnreadMessages = true;
+
+ return (
+
+
+ {hasUnreadMessages && (
+
+ )}
+
+
+ );
+};
+
+const styles = StyleSheet.create({
+ container: {
+ height: '100%',
+ alignItems: 'center',
+ display: 'flex',
+ justifyContent: 'center'
+ },
+});
+
+export default App;
+```
+
+### Example with text element
+
+You can also use the `text` SVG element to add text to your icon.
+
+```SnackPlayer name=State&ext=js&dependencies=react-native-svg,lucide-react-native
+import React, {useState, useEffect} from 'react';
+import { View, StyleSheet } from 'react-native';
+import { File } from "lucide-react-native";
+import { Text } from 'react-native-svg';
+
+const App = () => {
+ const hasUnreadMessages = true;
+
+ return (
+
+
+
+ JS
+
+
+
+ );
+};
+
+const styles = StyleSheet.create({
+ container: {
+ height: '100%',
+ alignItems: 'center',
+ display: 'flex',
+ justifyContent: 'center'
+ },
+});
+
+export default App;
+```
diff --git a/docs/guide/react-native/advanced/filled-icons.md b/docs/guide/react-native/advanced/filled-icons.md
new file mode 100644
index 000000000..b5a0153b7
--- /dev/null
+++ b/docs/guide/react-native/advanced/filled-icons.md
@@ -0,0 +1,60 @@
+---
+title: Filled Icons - React Native
+description: Learn how to use fills with Lucide icons in your React Native application, and the limitations of using fills with Lucide icons.
+---
+
+# Filled Icons
+
+Fills are officially not supported.
+However, all SVG properties are available on all icons.
+Fill can still be used and will work fine on certain icons.
+
+Example with stars:
+
+```SnackPlayer name=State&ext=js&dependencies=react-native-svg,lucide-react-native
+import React, {useState, useEffect} from 'react';
+import { View, StyleSheet } from 'react-native';
+import { Star, StarHalf } from "lucide-react-native";
+
+const App = () => {
+ return (
+
+
+
+ { Array.from({ length: 5 }, () => (
+
+ ))}
+
+
+
+
+
+
+
+
+ );
+};
+
+const styles = StyleSheet.create({
+ container: {
+ height: '100%',
+ alignItems: 'center',
+ display: 'flex',
+ justifyContent: 'center'
+ },
+ starRating: {
+ position: 'relative',
+ },
+ stars: {
+ display: 'flex',
+ flexDirection: 'row',
+ gap: 4,
+ },
+ rating: {
+ position: 'absolute',
+ top: 0,
+ }
+});
+
+export default App;
+```
diff --git a/docs/guide/react-native/advanced/global-styling.md b/docs/guide/react-native/advanced/global-styling.md
new file mode 100644
index 000000000..f2a2b1f71
--- /dev/null
+++ b/docs/guide/react-native/advanced/global-styling.md
@@ -0,0 +1,28 @@
+---
+title: Global Styling - React Native
+description: Learn how to style all Lucide icons globally in your React Native application using CSS or the Lucide context provider.
+---
+# Global Styling
+
+Adjusting icons can be done by using [color](../basics/color.md), [size](../basics/sizing.md) and [stroke width](../basics/stroke-width.md).
+To style all icons globally, you can use a context provider.
+
+## Context Provider
+
+For global styling using a context provider, you can use the `LucideProvider` component that is provided by the `lucide-react-native` package.
+
+```tsx
+import { LucideProvider, Home } from 'lucide-react-native';
+
+const App = () => (
+
+
+
+);
+```
+
+This will apply the `color`, `size` and `strokeWidth` props to all icons that are children of the `LucideProvider`.
diff --git a/docs/guide/react-native/advanced/typescript.md b/docs/guide/react-native/advanced/typescript.md
new file mode 100644
index 000000000..fcf811627
--- /dev/null
+++ b/docs/guide/react-native/advanced/typescript.md
@@ -0,0 +1,96 @@
+---
+title: Typescript - React Native
+description: Learn about the different types exported by the `lucide-react-native` package and how to use them in your React Native application.
+---
+# TypeScript Support
+
+List of exported types from the `lucide-react-native` package.
+These can be used to type your components when using Lucide icons in a TypeScript React project
+
+## `LucideProps`
+
+Exports all props that can be passed to an icon component and SVG props supported by [react-native-svg](https://github.com/software-mansion/react-native-svg).
+
+```ts
+interface LucideProps {
+ size?: number | string;
+ color?: string;
+ strokeWidth?: number;
+ absoluteStrokeWidth?: boolean;
+ [key: string]: any; // Any other SVG props, supported by react-native-svg
+}
+```
+
+### Using `LucideProps`
+You can use the `LucideProps` interface to type your custom icon components or when you need to work with icon props.
+
+```tsx
+import { Camera, type LucideProps } from 'lucide-react-native';
+
+const WrapIcon = (props: LucideProps) => {
+ return ;
+};
+
+export default WrapIcon;
+```
+
+## `LucideIcon`
+
+Type for individual icon components.
+
+```ts
+type LucideIcon = React.FC;
+```
+
+### Using `LucideIcon`
+
+You can use the `LucideIcon` type when you need to work with icon components directly.
+
+```tsx
+import { type LucideIcon } from 'lucide-react-native';
+
+interface ButtonProps {
+ icon: LucideIcon;
+ label: string;
+}
+
+const IconButton = ({ icon: Icon, label }: ButtonProps) => {
+ return (
+
+ );
+};
+
+export default IconButton;
+```
+
+## `IconNode`
+
+Type for the raw SVG structure of an icon. This is an array of SVG elements and their attributes to render the icon.
+Not commonly used directly in application code. But can be useful for advanced use cases, such as using custom icons or with Lucide Lab.
+
+```ts
+type IconNode = [elementName: string, attrs: Record][];
+```
+
+### Using `IconNode`
+You can use the `IconNode` type when you need to work with the raw SVG structure of an icon.
+
+```tsx
+import { type IconNode, Icon } from 'lucide-react-native';
+
+const customIcon: IconNode = [
+ ['circle', { cx: 12, cy: 12, r: 10 }],
+ ['line', { x1: 12, y1: 8, x2: 12, y2: 12 }],
+ ['line', { x1: 12, y1: 16, x2: 12, y2: 16 }],
+];
+
+const MyCustomIcon = () => {
+ return (
+
+ );
+};
+
+export default MyCustomIcon;
+```
diff --git a/docs/guide/react-native/advanced/with-lucide-lab.md b/docs/guide/react-native/advanced/with-lucide-lab.md
new file mode 100644
index 000000000..29be0f83a
--- /dev/null
+++ b/docs/guide/react-native/advanced/with-lucide-lab.md
@@ -0,0 +1,23 @@
+---
+title: With Lucide Lab or custom icons - React Native
+description: Learn how to use Lucide Lab or custom icons in your React Native applications using the Icon component.
+---
+# With Lucide Lab or custom icons
+
+[Lucide Lab](https://github.com/lucide-icons/lucide-lab) is a collection of icons that are not part of the Lucide main library.
+
+They can be used by using the `Icon` component.
+All props like regular lucide icons can be passed to adjust the icon appearance.
+
+## Using the `Icon` component
+
+This creates a single icon based on the iconNode passed and renders a Lucide icon component.
+
+```jsx
+import { Icon } from 'lucide-react-native';
+import { coconut } from '@lucide/lab';
+
+const App = () => (
+
+);
+```
diff --git a/docs/guide/react-native/basics/color.md b/docs/guide/react-native/basics/color.md
new file mode 100644
index 000000000..ca9b4f866
--- /dev/null
+++ b/docs/guide/react-native/basics/color.md
@@ -0,0 +1,31 @@
+---
+title: Color - React Native
+description: Learn how to adjust the color of icons in your React Native application using the `color` prop or by using parent elements text color value.
+---
+# Color
+
+By default, all icons have the color value: `currentColor`. This keyword uses the element's computed text `color` value to represent the icon color.
+
+Read more about [ `currentColor` on MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#currentcolor_keyword).
+
+## Adjust the color using the `color` prop
+
+The color can be adjusted by passing the color prop to the element.
+
+```SnackPlayer name=State&ext=js&dependencies=react-native-svg,lucide-react-native
+import React, {useState, useEffect} from 'react';
+import { View } from 'react-native';
+import { Smile } from "lucide-react-native";
+
+const style = { height: '100%', alignItems: 'center', display: 'flex', justifyContent: 'center' }
+
+const App = () => {
+ return (
+
+
+
+ );
+};
+
+export default App;
+```
diff --git a/docs/guide/react-native/basics/sizing.md b/docs/guide/react-native/basics/sizing.md
new file mode 100644
index 000000000..778b4f2c7
--- /dev/null
+++ b/docs/guide/react-native/basics/sizing.md
@@ -0,0 +1,60 @@
+---
+title: Sizing - React Native
+description: Learn how to adjust the size of icons in your React Native application using the `size` prop or by using CSS.
+---
+# Sizing
+
+By default, the size of all icons is `24px` by `24px`. The size is adjustable using the `size` prop and CSS.
+
+## Adjusting the icon size using the `size` prop
+
+```SnackPlayer name=State&ext=js&dependencies=react-native-svg,lucide-react-native
+import React, {useState, useEffect} from 'react';
+import { View } from 'react-native';
+import { Landmark } from "lucide-react-native";
+
+const style = { height: '100%', alignItems: 'center', display: 'flex', justifyContent: 'center' }
+
+const App = () => {
+ return (
+
+
+
+ );
+};
+
+export default App;
+```
+
+## Adjusting the icon size via the style prop
+
+The style properties `width` and `height` can be used to adjust the icon size.
+
+```SnackPlayer name=State&ext=js&dependencies=react-native-svg,lucide-react-native
+import React, {useState, useEffect} from 'react';
+import { View, StyleSheet } from 'react-native';
+import { Landmark } from "lucide-react-native";
+
+const styles = StyleSheet.create({
+ container: {
+ height: '100%',
+ alignItems: 'center',
+ display: 'flex',
+ justifyContent: 'center'
+ },
+ icon: {
+ width: 48,
+ height: 48
+ },
+});
+
+const App = () => {
+ return (
+
+
+
+ );
+};
+
+export default App;
+```
diff --git a/docs/guide/react-native/basics/stroke-width.md b/docs/guide/react-native/basics/stroke-width.md
new file mode 100644
index 000000000..1a8b6dffd
--- /dev/null
+++ b/docs/guide/react-native/basics/stroke-width.md
@@ -0,0 +1,80 @@
+---
+title: Stroke width - React Native
+description: Learn how to adjust the stroke width of icons in your React Native application using the `strokeWidth` prop or adjust the strokeWidth appearance using the `absoluteStrokeWidth` prop.
+---
+# Stroke width
+
+All icons are designed with SVG elements using strokes.
+These have a default stroke width of `2px`.
+
+The `strokeWidth` can be adjusted to create a different look of the icons.
+
+## Adjusting stroke width with `strokeWidth` prop
+
+```SnackPlayer name=State&ext=js&dependencies=react-native-svg,lucide-react-native
+import React, {useState, useEffect} from 'react';
+import { View } from 'react-native';
+import { FolderLock } from "lucide-react-native";
+
+const style = { height: '100%', alignItems: 'center', display: 'flex', justifyContent: 'center', backgroundColor: '#202127', color: '#fff' }
+
+const App = () => {
+ return (
+
+
+
+ );
+};
+
+export default App;
+```
+
+## Absolute stroke width
+
+When adjusting the `size` prop the size of the stroke width will be relative to the size of the icon, this is the default SVG behavior. The `absoluteStrokeWidth` prop is introduced to adjust this behavior to make the stroke width constant no matter the size of the icon.
+
+This means that when `absoluteStrokeWidth` is enabled and the `size` of the icons is set to `48px` the `strokeWidth` will still be `2px` on the screen.
+
+Note `2px` is the default stroke width for a Lucide icon, this can be adjusted to all sizes.
+
+
+
+### Adjusting stroke width with `absoluteStrokeWidth` prop
+
+Setting `absoluteStrokeWidth` to `true` will make the stroke width absolute.
+
+```SnackPlayer name=State&ext=js&dependencies=react-native-svg,lucide-react-native
+import React, {useState, useEffect} from 'react';
+import { View } from 'react-native';
+import { RollerCoaster } from "lucide-react-native";
+
+const style = { height: '100%', alignItems: 'center', display: 'flex', justifyContent: 'center', backgroundColor: '#202127', color: '#fff' }
+
+const App = () => {
+ return (
+
+
+
+ );
+};
+
+export default App;
+```
+
+
diff --git a/docs/guide/react-native/getting-started.md b/docs/guide/react-native/getting-started.md
new file mode 100644
index 000000000..eb3d40f62
--- /dev/null
+++ b/docs/guide/react-native/getting-started.md
@@ -0,0 +1,83 @@
+---
+title: Getting started - React Native
+description: This guide will help you get started with Lucide in your React Native project.
+---
+
+
+# Getting started
+
+This guide will help you get started with Lucide in your React Native project.
+Make sure you have a React Native environment set up. If you don't have one yet, you can create a new React Native project using React Native CLI, Expo, or any other React Native boilerplate of your choice.
+
+## Installation
+
+
+
+First, ensure that you have `react-native-svg` (version between 12 and 15) installed. Then, install the package:
+
+::: code-group
+
+```sh [pnpm]
+pnpm add lucide-react-native@next
+```
+
+```sh [yarn]
+yarn add lucide-react-native@next
+```
+
+```sh [npm]
+npm install lucide-react-native@next
+```
+
+```sh [bun]
+bun add lucide-react-native@next
+```
+
+:::
+
+## Importing your first icon
+
+Lucide is built with ES Modules.
+
+Each icon can be imported as a React component, which renders an `react-native-svg` element.
+
+```jsx
+import { Camera } from 'lucide-react-native';
+
+// Usage
+const App = () => {
+ return ;
+};
+
+export default App;
+```
+
+## Props
+
+To customize the appearance of an icon, you can use the following props:
+
+| name | type | default |
+| --------------------- | --------- | ------------ |
+| `size` | *number* | 24 |
+| `color` | *string* | currentColor |
+| `strokeWidth` | *number* | 2 |
+| `absoluteStrokeWidth` | *boolean* | false |
+
+Because icons render as SVG elements, all standard SVG attributes can also be applied as props. See the list of SVG Presentation Attributes on [MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/Presentation).
+
+```jsx
+// Usage
+const App = () => {
+ return ;
+};
+```
+
+More examples and details how to use props, continue the guide:
+
+
+
+
diff --git a/docs/guide/react-native/index.md b/docs/guide/react-native/index.md
new file mode 100644
index 000000000..a216d739a
--- /dev/null
+++ b/docs/guide/react-native/index.md
@@ -0,0 +1,71 @@
+---
+title: Lucide for React Native
+description: Lucide provides a React Native icon component library that makes it easy to integrate icons into your React Native applications. Each icon is available as a standalone React Native component, allowing for seamless integration and customization.
+nextPage:
+ - getting-started
+---
+
+
+
+
+
+# Lucide for React Native
+
+Lucide provides a React Native icon component library that makes it easy to integrate icons into your React Native applications.
+Each icon is available as a standalone React component, allowing for seamless integration and customization.
+
+List of features:
+
+- **Easy to use** – Import icons and use them directly in JSX.
+- **Customizable** – Adjust size, color, stroke width, and other properties via props.
+- **Tree-shakable** – Only the icons you import are included in your final bundle.
+- **TypeScript support** – Fully typed components for a better developer experience.
+
+## Overview
+
+
+
+
+
+### Basics
+{{''}}
+
+
+
+
+
+### Advanced
+{{''}}
+
+
+
+
+
+### Resources
+{{''}}
+
+
+
+
diff --git a/docs/guide/react-native/migration.md b/docs/guide/react-native/migration.md
new file mode 100644
index 000000000..72261e47e
--- /dev/null
+++ b/docs/guide/react-native/migration.md
@@ -0,0 +1,20 @@
+# Migration from v0
+
+Brand icons are removed in v1. If you are using any of the following icons, you will need to replace them with a custom SVG or an alternative icon:
+
+- Chromium
+- Codepen
+- Codesandbox
+- Dribbble
+- Facebook
+- Figma
+- Framer
+- Github
+- Gitlab
+- Instagram
+- LinkedIn
+- Pocket
+- RailSymbol (based on the British Rail logo)
+- Slack
+
+We recommend to use the official SVG icons provided by the respective brands, most of them can be found on their websites or in their brand guidelines. Alternatively, you can use the icons from [Simple Icons](https://simpleicons.org/), which provides a large collection of brand icons. Also with links to the official Brand Guidelines and SVG icons.
diff --git a/docs/guide/react/advanced/accessibility.md b/docs/guide/react/advanced/accessibility.md
new file mode 100644
index 000000000..c7e92d84e
--- /dev/null
+++ b/docs/guide/react/advanced/accessibility.md
@@ -0,0 +1,51 @@
+---
+title: Accessibility - React
+description: Best practices for accessible icons in your React application.
+---
+
+
+# Accessibility
+
+Lucide icons ship with `aria-hidden="true"` by default. In almost all cases this is exactly what you want.
+
+## Should icons be accessible?
+
+Most of the time, icons are used purely for decoration or visual reinforcement. Exposing decorative icons to assistive technologies can create unnecessary noise for screen reader users.
+
+For a broader explanation of this, and other best practices on how to use icons accessibly in your application, please refer to our detailed guide on accessibility:
+
+
+
+Only if an icon **conveys essential meaning on its own** should it be made accessible. The sections below explain how to do that in React.
+
+## Making an icon accessible
+
+To expose an icon to assistive technologies, provide an accessible name by passing a `title` element as a child or passing the `aria-label` prop to the icon component.
+
+This removes the `aria-hidden` attribute and makes the icon visible to screen readers.
+
+```tsx
+
+ This is my house
+
+
+// or
+
+
+```
+
+Choose a label that clearly describes the meaning of the icon or the action it represents in the context of your application.
+
+## Accessible icon buttons
+
+When an icon is used inside a button, the accessible label should usually be applied to the button itself, and not the icon.
+
+```tsx
+
+```
+
+This ensures assistive technologies describe the interactive element, rather than the decorative graphic inside it.
diff --git a/docs/guide/react/advanced/aliased-names.md b/docs/guide/react/advanced/aliased-names.md
new file mode 100644
index 000000000..42a09b5ca
--- /dev/null
+++ b/docs/guide/react/advanced/aliased-names.md
@@ -0,0 +1,59 @@
+---
+title: Aliased Names - React
+description: Learn about the different import name styles available for Lucide icons in your React project and how to choose the one that best fits your needs.
+---
+# Aliased Names
+
+Some icons have multiple names. This is because we sometimes choose to rename them to make them more consistent with the rest of the icon set, or the name was not generic. For example, the `edit-2` icon is renamed to `pen` to make the name more generic, since it is just a pen icon.
+
+Beside these aliases, Lucide also includes prefixed and suffixed names to use within your project. This is to prevent import name collisions with other libraries or your own code.
+
+```tsx
+// These are all the same icon
+import {
+ House,
+ HouseIcon,
+ LucideHouse,
+} from "lucide-react";
+```
+
+## Choosing import name style
+
+If you want consistent imports across your project, or if you want to change the autocompletion of Lucide icons in your IDE, there an option to choose the import name style you prefer.
+
+This can be done by creating a custom module declaration file to override Lucide imports and turning off the autocomplete in your IDE.
+
+### Turn off autocomplete in your IDE
+
+```json [.vscode/settings.json]
+{
+ "js/ts.preferences.autoImportFileExcludePatterns": [
+ "lucide-react",
+ ]
+}
+```
+
+### Create a custom module declaration file
+
+Create a custom TypeScript declaration file that re-exports the preferred naming style:
+
+```ts [lucide-react.d.ts]
+declare module "lucide-react" {
+ // Prefixed import names
+ export * from "lucide-react/dist/lucide-react.prefixed";
+ // or
+ // Suffixed import names
+ export * from "lucide-react/dist/lucide-react.suffixed";
+}
+```
+
+Place this file in your project root or in a directory included in your TypeScript configuration.
+A common approach is to create a `@types` folder and name the file `lucide-react.d.ts`.
+
+### Import name styles
+
+| Import Style | Available imports | Declaration file import |
+| ------------- | --------------------------- | ----------------------- |
+| Default | Home, HomeIcon, LucideHome | |
+| Prefixed | LucideHome | lucide-react.prefixed |
+| Suffixed | HomeIcon | lucide-react.suffixed |
diff --git a/docs/guide/react/advanced/combining-icons.md b/docs/guide/react/advanced/combining-icons.md
new file mode 100644
index 000000000..a13e1f1ed
--- /dev/null
+++ b/docs/guide/react/advanced/combining-icons.md
@@ -0,0 +1,112 @@
+---
+title: Combining icons - React
+description: Learn how to combine multiple icons into a single icon nested SVG elements in your React application.
+---
+
+
+# Combining icons
+
+You can combine multiple icons into a single icon by nesting SVG elements.
+This is useful if you want to create custom icons icons by combining existing ones.
+
+::: sandpack {template=react showTabs=false editorHeight=400 editorWidthPercentage=60 dependencies="lucide-react"}
+
+```jsx App.js [active]
+import { Scan, User } from "lucide-react";
+
+function App() {
+ return (
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+This is valid, since [SVGs can be nested](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/svg#nested_svg_element), and all SVG properties are supported on the icons.
+The `x` and `y` coordinates can be adjusted to position the icons as you like.
+
+::: info Limitation
+When combining icons, you need to make sure that the `x` and `y` coordinates are within the `viewBox` of the outer icon (24x24).
+:::
+
+## With native SVG elements
+
+You can also combine Lucide icons with native SVG elements to build custom icon variations.
+
+### Example with notification badge
+
+For example, you can add a notification badge to an icon by using the `circle` SVG element.
+
+
+::: sandpack {template=react showTabs=false editorHeight=580 editorWidthPercentage=60 dependencies="lucide-react"}
+
+```jsx App.js [active]
+import { Mail } from "lucide-react";
+
+function App() {
+ const hasUnreadMessages = true;
+
+ return (
+
+
+ {hasUnreadMessages && (
+
+ )}
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+### Example with text element
+
+You can also use the `text` SVG element to add text to your icon.
+
+::: sandpack {template=react showTabs=false editorHeight=400 editorWidthPercentage=60 dependencies="lucide-react"}
+
+```jsx App.js [active]
+import { File } from "lucide-react";
+
+function App() {
+ return (
+
+
+
+ JS
+
+
+
+ );
+}
+
+export default App;
+```
+:::
diff --git a/docs/guide/react/advanced/dynamic-icon-component.md b/docs/guide/react/advanced/dynamic-icon-component.md
new file mode 100644
index 000000000..31f230845
--- /dev/null
+++ b/docs/guide/react/advanced/dynamic-icon-component.md
@@ -0,0 +1,31 @@
+---
+title: Dynamic Icon Component - React
+description: Learn how to use the DynamicIcon component to load icons dynamically by name in your React application, and understand the caveats of using this approach.
+---
+# Dynamic Icon Component
+
+It is possible to use one generic icon component to load icons. But it is not recommended, since it is importing all icons during the build. See [Caveats](#caveats).
+
+`DynamicIcon` is useful for applications that want to show icons dynamically by icon name. For example, when using a content management system where icon names are stored in a database.
+
+For static use cases, it is recommended to import the icons directly.
+
+The same props can be passed to adjust the icon appearance. The `name` prop is required to load the correct icon.
+
+```jsx
+import { DynamicIcon } from 'lucide-react/dynamic';
+
+const App = () => (
+
+);
+```
+
+
+
+::: info Caveats
+
+- All icons are imported during build time, which increases build time.
+- The bundler will create a separate module for each icon, which can increase the number of network requests.
+- You can encounter flashing when loading the icon, since the icon is loaded dynamically.
+- When using server-side rendering, you need to make sure that the icon is available during the initial render.
+:::
diff --git a/docs/guide/react/advanced/filled-icons.md b/docs/guide/react/advanced/filled-icons.md
new file mode 100644
index 000000000..f706f4fd4
--- /dev/null
+++ b/docs/guide/react/advanced/filled-icons.md
@@ -0,0 +1,62 @@
+---
+title: Filled Icons - React
+description: Learn how to use fills with Lucide icons in your React application, and the limitations of using fills with Lucide icons.
+---
+
+
+# Filled Icons
+
+Fills are officially not supported.
+However, all SVG properties are available on all icons.
+Fill can still be used and will work fine on certain icons.
+
+Example with stars:
+
+::: sandpack {template=react editorHeight=580 editorWidthPercentage=60 dependencies="lucide-react"}
+
+```jsx App.js [active]
+import { Star, StarHalf } from "lucide-react";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+ { Array.from({ length: 5 }, () => (
+
+ ))}
+
+
+
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+
+```css icon.css
+.star-rating {
+ position: relative;
+}
+
+.stars {
+ display: flex;
+ gap: 4px;
+}
+
+.rating {
+ position: absolute;
+ top: 0;
+}
+
+```
+
+:::
diff --git a/docs/guide/react/advanced/global-styling.md b/docs/guide/react/advanced/global-styling.md
new file mode 100644
index 000000000..1a68b0457
--- /dev/null
+++ b/docs/guide/react/advanced/global-styling.md
@@ -0,0 +1,161 @@
+---
+title: Global Styling - React
+description: Learn how to style all Lucide icons globally in your React application using CSS or the Lucide context provider.
+---
+
+
+# Global Styling
+
+Adjusting icons can be done by using [color](../basics/color.md), [size](../basics/sizing.md) and [stroke width](../basics/stroke-width.md).
+To style all icons globally, you can either use CSS, or use a context provider.
+
+We recommend using CSS for global styling, as it is the most straightforward way to achieve this.
+But using CSS prevents you from using props like `size`, `color` and `strokeWidth` on individual icons, since CSS specificity will override these props, to be able to use the props on individual ones you need to use the Lucide context provider.
+
+## Context Provider
+
+For global styling using a context provider, you can use the `LucideProvider` component that is provided by the `lucide-react` package.
+
+
+```tsx
+import { LucideProvider, Home } from 'lucide-react';
+
+const App = () => (
+
+
+
+);
+```
+
+This will apply the `color`, `size` and `strokeWidth` props to all icons that are children of the `LucideProvider`.
+
+
+## Style by using CSS
+Styling icons is easy to accomplish using CSS.
+
+Every icon has a class attribute applied called `lucide`. This class name can be used in the CSS file to target all icons that are being used within the app.
+
+- The **color** of the icons can be changed using the [`color`](https://developer.mozilla.org/en-US/docs/Web/CSS/color) CSS property.
+- The **size** of the icons can be changed using [`width`](https://developer.mozilla.org/en-US/docs/Web/CSS/width) and [`height`](https://developer.mozilla.org/en-US/docs/Web/CSS/height) CSS properties.
+- The **stroke width** of the icons can be changed using the [`stroke-width`](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-width) CSS property.
+
+::: sandpack {template=react editorHeight=300 dependencies="lucide-react"}
+
+```css icon.css [active]
+.lucide {
+ /* Change this! */
+ color: #ffadff;
+ width: 56px;
+ height: 56px;
+ stroke-width: 1px;
+}
+
+.app {
+ display: grid;
+ grid-template-columns: 1fr 1fr 1fr;
+ grid-template-rows: 1fr 1fr 1fr;
+ gap: 6px;
+}
+```
+
+```jsx App.js
+import {
+ CakeSlice,
+ Candy,
+ Apple,
+ Cookie,
+ Martini,
+ IceCream2,
+ Sandwich,
+ Wine,
+ Dessert,
+} from "lucide-react";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+
+
+
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+### Absolute stroke width
+
+For global absolute stroke width styling the `vector-effect: non-scaling-stroke` CSS property can be applied to the children. This will keep the stroke-width the same size no matter the size of the icon. See [absolute-stroke-width](../basics/stroke-width.md#absolute-stroke-width) for more info.
+
+::: sandpack {template=react editorHeight=300 dependencies="lucide-react"}
+
+```css icon.css [active]
+.lucide {
+ width: 48px;
+ height: 48px;
+ stroke-width: 1.5;
+}
+
+.lucide * {
+ vector-effect: non-scaling-stroke;
+}
+
+.app {
+ display: grid;
+ grid-template-columns: 1fr 1fr 1fr;
+ grid-template-rows: 1fr 1fr 1fr;
+ gap: 6px;
+}
+
+```
+
+```jsx App.js
+import {
+ TentTree,
+ Caravan,
+ FlameKindling,
+ MountainSnow,
+ Trees,
+ Axe,
+ Map,
+ CloudMoon,
+ Sparkles,
+} from "lucide-react";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+
+
+
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
diff --git a/docs/guide/react/advanced/typescript.md b/docs/guide/react/advanced/typescript.md
new file mode 100644
index 000000000..08814820b
--- /dev/null
+++ b/docs/guide/react/advanced/typescript.md
@@ -0,0 +1,97 @@
+---
+title: Typescript - React
+description: Learn about the different types exported by the `lucide-react` package and how to use them in your React application.
+---
+# TypeScript Support
+
+List of exported types from the `lucide-react` package.
+These can be used to type your components when using Lucide icons in a TypeScript React project
+
+## `LucideProps`
+
+Exports all props that can be passed to an icon component and any other SVG attributes, see: [SVG Presentation Attributes on MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/Presentation).
+
+```ts
+interface LucideProps {
+ size?: number | string;
+ color?: string;
+ strokeWidth?: number;
+ absoluteStrokeWidth?: boolean;
+ [key: string]: any; // Any other SVG attributes
+}
+```
+
+### Using `LucideProps`
+You can use the `LucideProps` interface to type your custom icon components or when you need to work with icon props.
+
+```tsx
+import { type LucideProps } from 'lucide-react';
+import { Camera } from 'lucide-react';
+
+const WrapIcon = (props: LucideProps) => {
+ return ;
+};
+
+export default WrapIcon;
+```
+
+## `LucideIcon`
+
+Type for individual icon components.
+
+```ts
+type LucideIcon = React.FC;
+```
+
+### Using `LucideIcon`
+
+You can use the `LucideIcon` type when you need to work with icon components directly.
+
+```tsx
+import { type LucideIcon } from 'lucide-react';
+
+interface ButtonProps {
+ icon: LucideIcon;
+ label: string;
+}
+
+const IconButton = ({ icon: Icon, label }: ButtonProps) => {
+ return (
+
+ );
+};
+
+export default IconButton;
+```
+
+## `IconNode`
+
+Type for the raw SVG structure of an icon. This is an array of SVG elements and their attributes to render the icon.
+Not commonly used directly in application code. But can be useful for advanced use cases, such as using custom icons or with Lucide Lab.
+
+```ts
+type IconNode = [elementName: string, attrs: Record][];
+```
+
+### Using `IconNode`
+You can use the `IconNode` type when you need to work with the raw SVG structure of an icon.
+
+```tsx
+import { type IconNode, Icon } from 'lucide-react';
+
+const customIcon: IconNode = [
+ ['circle', { cx: 12, cy: 12, r: 10 }],
+ ['line', { x1: 12, y1: 8, x2: 12, y2: 12 }],
+ ['line', { x1: 12, y1: 16, x2: 12, y2: 16 }],
+];
+
+const MyCustomIcon = () => {
+ return (
+
+ );
+};
+
+export default MyCustomIcon;
+```
diff --git a/docs/guide/react/advanced/with-lucide-lab.md b/docs/guide/react/advanced/with-lucide-lab.md
new file mode 100644
index 000000000..851719a17
--- /dev/null
+++ b/docs/guide/react/advanced/with-lucide-lab.md
@@ -0,0 +1,23 @@
+---
+title: With Lucide Lab or custom icons - React
+description: Learn how to use Lucide Lab or custom icons in your React applications using the Icon component.
+---
+# With Lucide Lab or custom icons
+
+[Lucide Lab](https://github.com/lucide-icons/lucide-lab) is a collection of icons that are not part of the Lucide main library.
+
+They can be used by using the `Icon` component.
+All props like regular lucide icons can be passed to adjust the icon appearance.
+
+## Using the `Icon` component
+
+This creates a single icon based on the iconNode passed and renders a Lucide icon component.
+
+```jsx
+import { Icon } from 'lucide-react';
+import { coconut } from '@lucide/lab';
+
+const App = () => (
+
+);
+```
diff --git a/docs/guide/react/basics/color.md b/docs/guide/react/basics/color.md
new file mode 100644
index 000000000..218069185
--- /dev/null
+++ b/docs/guide/react/basics/color.md
@@ -0,0 +1,69 @@
+---
+title: Color - React
+description: Learn how to adjust the color of icons in your React application using the `color` prop or by using parent elements text color value.
+---
+
+
+# Color
+
+By default, all icons have the color value: `currentColor`. This keyword uses the element's computed text `color` value to represent the icon color.
+
+Read more about [ `currentColor` on MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#currentcolor_keyword).
+
+## Adjust the color using the `color` prop
+
+The color can be adjusted by passing the color prop to the element.
+
+::: sandpack {template=react showTabs=false editorHeight=295 editorWidthPercentage=60 dependencies="lucide-react"}
+
+```js App.js [active]
+import { Smile } from "lucide-react";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+
+## Using parent elements text color value
+
+Because the color of lucide icons uses `currentColor`, the color of the icon depends on the computed `color` of the element, or it inherits it from its parent.
+
+For example, if a parent element's color value is `#fff` and one of the children is a lucide icon, the color of the icon will be rendered as `#fff`. This is browser native behavior.
+
+::: sandpack {template=react showTabs=false editorHeight=320 editorWidthPercentage=60 dependencies="lucide-react"}
+
+```jsx Button.jsx [active]
+import { ThumbsUp } from "lucide-react";
+
+function LikeButton() {
+ return (
+
+ );
+}
+
+export default LikeButton;
+```
+
+```jsx App.js [hidden]
+import Button from "./Button";
+
+export default function App() {
+ return ;
+}
+
+```
+:::
diff --git a/docs/guide/react/basics/sizing.md b/docs/guide/react/basics/sizing.md
new file mode 100644
index 000000000..cf657e6a9
--- /dev/null
+++ b/docs/guide/react/basics/sizing.md
@@ -0,0 +1,124 @@
+---
+title: Sizing - React
+description: Learn how to adjust the size of icons in your React application using the `size` prop or by using CSS.
+---
+
+
+# Sizing
+
+By default, the size of all icons is `24px` by `24px`. The size is adjustable using the `size` prop and CSS.
+
+## Adjusting the icon size using the `size` prop
+
+::: sandpack {template=react showTabs=false editorHeight=300 editorWidthPercentage=60 dependencies="lucide-react"}
+
+```jsx App.js [active]
+import { Landmark } from "lucide-react";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+## Adjusting the icon size via CSS
+
+The CSS properties `width` and `height` can be used to adjust the icon size.
+
+::: sandpack {template=react editorHeight=300 dependencies="lucide-react"}
+
+```css icon.css [active]
+.my-beer-icon {
+ /* Change this! */
+ width: 64px;
+ height: 64px;
+}
+```
+
+```jsx App.js
+import { Beer } from "lucide-react";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+
+```
+:::
+
+### Dynamically change the icon size based on the font size
+
+It is possible to resize icons based on font size. This can be achieved using the `em` unit. See this [MDN article](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size#ems) for more information on the `em` unit.
+
+::: sandpack {template=react editorHeight=300 dependencies="lucide-react"}
+
+```css icon.css [active]
+.my-icon {
+ /* Icon size will relative to font-size of .text-wrapper */
+ width: 1em;
+ height: 1em;
+}
+
+.text-wrapper {
+ /* Change this! */
+ font-size: 96px;
+
+ /* layout stuff */
+ display: flex;
+ gap: 0.25em;
+ align-items: center;
+}
+```
+
+```jsx App.js
+import { Star } from "lucide-react";
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
Yes
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+### Resizing with Tailwind
+
+`size-*` utilities can be used to adjust the size of the icon. See the [Tailwind documentation](https://tailwindcss.com/docs/width#setting-both-width-and-height) for more information on the `size-*` utilities.
+
+::: sandpack {template=react editorHeight=300 editorWidthPercentage=60 dependencies="lucide-react" externalResources="https://cdn.tailwindcss.com"}
+
+```jsx App.js [active]
+import { PartyPopper } from "lucide-react";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
diff --git a/docs/guide/react/basics/stroke-width.md b/docs/guide/react/basics/stroke-width.md
new file mode 100644
index 000000000..8b6f8938a
--- /dev/null
+++ b/docs/guide/react/basics/stroke-width.md
@@ -0,0 +1,68 @@
+---
+title: Stroke width - React
+description: Learn how to adjust the stroke width of icons in your React application using the `strokeWidth` prop or adjust the strokeWidth appearance using the `absoluteStrokeWidth` prop.
+---
+
+
+# Stroke width
+
+All icons are designed with SVG elements using strokes.
+These have a default stroke width of `2px`.
+
+The `strokeWidth` can be adjusted to create a different look of the icons.
+
+## Adjusting stroke width with `strokeWidth` prop
+
+::: sandpack {template=react showTabs=false editorHeight=300 editorWidthPercentage=60 dependencies="lucide-react"}
+
+```jsx App.js [active]
+import { FolderLock } from "lucide-react";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+
+## Absolute stroke width
+
+When adjusting the `size` prop the size of the stroke width will be relative to the size of the icon, this is the default SVG behavior. The `absoluteStrokeWidth` prop is introduced to adjust this behavior to make the stroke width constant no matter the size of the icon.
+
+This means that when `absoluteStrokeWidth` is enabled and the `size` of the icons is set to `48px` the `strokeWidth` will still be `2px` on the screen.
+
+Note `2px` is the default stroke width for a Lucide icon, this can be adjusted to all sizes.
+
+
+
+### Adjusting stroke width with `absoluteStrokeWidth` prop
+
+Setting `absoluteStrokeWidth` to `true` will make the stroke width absolute.
+
+::: sandpack {template=react showTabs=false editorHeight=320 editorWidthPercentage=60 dependencies="lucide-react"}
+
+```jsx App.js [active]
+import { RollerCoaster } from "lucide-react";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
diff --git a/docs/guide/react/getting-started.md b/docs/guide/react/getting-started.md
new file mode 100644
index 000000000..3d587eb22
--- /dev/null
+++ b/docs/guide/react/getting-started.md
@@ -0,0 +1,79 @@
+---
+title: Getting started - React
+description: This guide will help you get started with Lucide in your React project.
+---
+
+
+# Getting started
+
+This guide will help you get started with Lucide in your React project.
+Make sure you have a React environment set up. If you don't have one yet, you can create a new React project using Create React App, Vite, or any other React boilerplate of your choice.
+
+## Installation
+
+
+
+::: code-group
+
+```sh [pnpm]
+pnpm add lucide-react@next
+```
+
+```sh [yarn]
+yarn add lucide-react@next
+```
+
+```sh [npm]
+npm install lucide-react@next
+```
+
+```sh [bun]
+bun add lucide-react@next
+```
+
+:::
+
+## Importing your first icon
+
+Lucide is built with ES Modules, so it's completely tree-shakable.
+
+Each icon can be imported as a React component, which renders an inline SVG element. This way, only the icons that are imported into your project are included in the final bundle. The rest of the icons are tree-shaken away.
+
+```jsx
+import { Camera } from 'lucide-react';
+// Usage
+const App = () => {
+ return ;
+};
+export default App;
+```
+
+## Props
+
+To customize the appearance of an icon, you can use the following props:
+
+| name | type | default |
+| --------------------- | --------- | ------------ |
+| `size` | *number* | 24 |
+| `color` | *string* | currentColor |
+| `strokeWidth` | *number* | 2 |
+| `absoluteStrokeWidth` | *boolean* | false |
+
+Because icons render as SVG elements, all standard SVG attributes can also be applied as props. See the list of SVG Presentation Attributes on [MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/Presentation).
+
+```jsx
+// Usage
+const App = () => {
+ return ;
+};
+```
+
+More examples and details how to use props, continue the guide:
+
+
+
+
diff --git a/docs/guide/react/index.md b/docs/guide/react/index.md
new file mode 100644
index 000000000..165c113c5
--- /dev/null
+++ b/docs/guide/react/index.md
@@ -0,0 +1,52 @@
+---
+title: Lucide for React
+description: Lucide provides a React icon component library that makes it easy to integrate icons into your React applications. Each icon is available as a standalone React component, allowing for seamless integration and customization.
+nextPage:
+ - getting-started
+---
+
+
+
+
+
+# Lucide for React
+
+Lucide provides a React component library for using icons in your applications. Each icon is available as a standalone component that renders an optimized inline SVG.
+
+List of features:
+
+- **Easy to use** – Import icons and use them directly in JSX.
+- **Customizable** – Adjust size, color, stroke width, and other properties via props.
+- **Tree-shakable** – Only the icons you import are included in your final bundle.
+- **TypeScript support** – Fully typed components for a better developer experience.
+
+## Overview
+
+
+
+
+
+### Basics
+{{''}}
+
+
+
+
+
+### Advanced
+{{''}}
+
+
+
+
+
+### Resources
+{{''}}
+
+
+
+
diff --git a/docs/guide/react/migration-from-feather.md b/docs/guide/react/migration-from-feather.md
new file mode 100644
index 000000000..54ef968ca
--- /dev/null
+++ b/docs/guide/react/migration-from-feather.md
@@ -0,0 +1,58 @@
+# 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-feather | lucide-react |
+| ------------- | ------------ |
+| `GitHub` | `Github` |
+| `Grid` | `LayoutGrid` |
+| `Table` | `Table2` |
+| `Tool` | `Wrench` |
+
+### Examples
+
+```diff
+- import { GitHub, Grid, Table, Tool } from 'react-feather'
++ import { Github, LayoutGrid, Table2, Wrench } from 'lucide-react'
+
+-
++
+
+-
++
+
+-
++
+
+-
++
+```
+
+## 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.
diff --git a/docs/guide/react/migration.md b/docs/guide/react/migration.md
new file mode 100644
index 000000000..72261e47e
--- /dev/null
+++ b/docs/guide/react/migration.md
@@ -0,0 +1,20 @@
+# Migration from v0
+
+Brand icons are removed in v1. If you are using any of the following icons, you will need to replace them with a custom SVG or an alternative icon:
+
+- Chromium
+- Codepen
+- Codesandbox
+- Dribbble
+- Facebook
+- Figma
+- Framer
+- Github
+- Gitlab
+- Instagram
+- LinkedIn
+- Pocket
+- RailSymbol (based on the British Rail logo)
+- Slack
+
+We recommend to use the official SVG icons provided by the respective brands, most of them can be found on their websites or in their brand guidelines. Alternatively, you can use the icons from [Simple Icons](https://simpleicons.org/), which provides a large collection of brand icons. Also with links to the official Brand Guidelines and SVG icons.
diff --git a/docs/guide/solid/advanced/accessibility.md b/docs/guide/solid/advanced/accessibility.md
new file mode 100644
index 000000000..c76a1c14f
--- /dev/null
+++ b/docs/guide/solid/advanced/accessibility.md
@@ -0,0 +1,51 @@
+---
+title: Accessibility - Solid
+description: Best practices for accessible icons in your Solid application.
+---
+
+
+# Accessibility
+
+Lucide icons ship with `aria-hidden="true"` by default. In almost all cases this is exactly what you want.
+
+## Should icons be accessible?
+
+Most of the time, icons are used purely for decoration or visual reinforcement. Exposing decorative icons to assistive technologies can create unnecessary noise for screen reader users.
+
+For a broader explanation of this, and other best practices on how to use icons accessibly in your application, please refer to our detailed guide on accessibility:
+
+
+
+Only if an icon **conveys essential meaning on its own** should it be made accessible. The sections below explain how to do that in Solid.
+
+## Making an icon accessible
+
+To expose an icon to assistive technologies, provide an accessible name by passing a `title` element as a child or passing the `aria-label` prop to the icon component.
+
+This removes the `aria-hidden` attribute and makes the icon visible to screen readers.
+
+```tsx
+
+ This is my house
+
+
+// or
+
+
+```
+
+Choose a label that clearly describes the meaning of the icon or the action it represents in the context of your application.
+
+## Accessible icon buttons
+
+When an icon is used inside a button, the accessible label should usually be applied to the button itself, and not the icon.
+
+```tsx
+
+```
+
+This ensures assistive technologies describe the interactive element, rather than the decorative graphic inside it.
diff --git a/docs/guide/solid/advanced/aliased-names.md b/docs/guide/solid/advanced/aliased-names.md
new file mode 100644
index 000000000..666e75e40
--- /dev/null
+++ b/docs/guide/solid/advanced/aliased-names.md
@@ -0,0 +1,29 @@
+---
+title: Aliased Names - Solid
+description: Learn about the different import name styles available for Lucide icons in your Solid project and how to choose the one that best fits your needs.
+---
+
+# Aliased Names
+
+Some icons have multiple names. This is because we sometimes choose to rename them to make them more consistent with the rest of the icon set, or the name was not generic. For example, the `edit-2` icon is renamed to `pen` to make the name more generic, since it is just a pen icon.
+
+Beside these aliases, Lucide also includes prefixed and suffixed names to use within your project. This is to prevent import name collisions with other libraries or your own code.
+
+```tsx
+// These are all the same icon
+import {
+ House,
+ HouseIcon,
+ LucideHouse,
+} from "lucide-solid";
+```
+
+### Turn off autocomplete in your IDE
+
+```json [.vscode/settings.json]
+{
+ "js/ts.preferences.autoImportFileExcludePatterns": [
+ "lucide-solid",
+ ]
+}
+```
diff --git a/docs/guide/solid/advanced/combining-icons.md b/docs/guide/solid/advanced/combining-icons.md
new file mode 100644
index 000000000..a904a5640
--- /dev/null
+++ b/docs/guide/solid/advanced/combining-icons.md
@@ -0,0 +1,116 @@
+---
+title: Combining icons - Solid
+description: Learn how to combine multiple icons into a single icon nested SVG elements in your Solid application.
+---
+
+
+
+# Combining icons
+
+You can combine multiple icons into a single icon by nesting SVG elements.
+This is useful if you want to create custom icons icons by combining existing ones.
+
+::: sandpack {template=vite-solid showTabs=false editorHeight=400 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```tsx App.tsx [active]
+import Scan from 'lucide-solid/icons/scan';
+import User from 'lucide-solid/icons/user';
+
+function App() {
+ return (
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+This is valid, since [SVGs can be nested](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/svg#nested_svg_element), and all SVG properties are supported on the icons.
+The `x` and `y` coordinates can be adjusted to position the icons as you like.
+
+::: info Limitation
+When combining icons, you need to make sure that the `x` and `y` coordinates are within the `viewBox` of the outer icon (24x24).
+:::
+
+## With native SVG elements
+
+You can also combine Lucide icons with native SVG elements to build custom icon variations.
+
+### Example with notification badge
+
+For example, you can add a notification badge to an icon by using the `circle` SVG element.
+
+::: sandpack {template=vite-solid showTabs=false editorHeight=580 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```tsx App.tsx [active]
+import Mail from 'lucide-solid/icons/mail';
+
+function App() {
+ const hasUnreadMessages = true;
+
+ return (
+
+
+ {hasUnreadMessages && (
+
+ )}
+
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+### Example with text element
+
+You can also use the `text` SVG element to add text to your icon.
+
+::: sandpack {template=vite-solid showTabs=false editorHeight=400 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```tsx App.tsx [active]
+import File from 'lucide-solid/icons/file';
+
+function App() {
+ return (
+
+
+
+ JS
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
diff --git a/docs/guide/solid/advanced/filled-icons.md b/docs/guide/solid/advanced/filled-icons.md
new file mode 100644
index 000000000..4949d23db
--- /dev/null
+++ b/docs/guide/solid/advanced/filled-icons.md
@@ -0,0 +1,64 @@
+---
+title: Filled Icons - Solid
+description: Learn how to use fills with Lucide icons in your Solid application, and the limitations of using fills with Lucide icons.
+---
+
+
+# Filled Icons
+
+Fills are officially not supported.
+However, all SVG properties are available on all icons.
+Fill can still be used and will work fine on certain icons.
+
+Example with stars:
+
+::: sandpack {template=vite-solid editorHeight=580 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```tsx App.tsx [active]
+import Star from 'lucide-solid/icons/star';
+import StarHalf from 'lucide-solid/icons/star-half';
+
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+ { Array.from({ length: 5 }, () => (
+
+ ))}
+
+
+
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+
+```css icon.css
+.star-rating {
+ position: relative;
+}
+
+.stars {
+ display: flex;
+ gap: 4px;
+}
+
+.rating {
+ position: absolute;
+ top: 0;
+}
+
+```
+
+:::
diff --git a/docs/guide/solid/advanced/global-styling.md b/docs/guide/solid/advanced/global-styling.md
new file mode 100644
index 000000000..6c55b55dd
--- /dev/null
+++ b/docs/guide/solid/advanced/global-styling.md
@@ -0,0 +1,157 @@
+---
+title: Global Styling - Solid
+description: Learn how to style all Lucide icons globally in your Solid application using CSS or the Lucide context provider.
+---
+
+
+# Global Styling
+
+Adjusting icons can be done by using [color](../basics/color.md), [size](../basics/sizing.md) and [stroke width](../basics/stroke-width.md).
+To style all icons globally, you can either use CSS, or use a context provider.
+
+We recommend using CSS for global styling, as it is the most straightforward way to achieve this.
+But using CSS prevents you from using props like `size`, `color` and `strokeWidth` on individual icons, since CSS specificity will override these props, to be able to use the props on individual ones you need to use the Lucide context provider.
+
+## Context Provider
+
+For global styling using a context provider, you can use the `LucideProvider` component that is provided by the `lucide-solid` package.
+
+
+
+```tsx
+import { LucideProvider, Home } from 'lucide-solid';
+
+const App = () => (
+
+
+
+);
+```
+
+This will apply the `color`, `size` and `strokeWidth` props to all icons that are children of the `LucideProvider`.
+
+
+## Style by using CSS
+Styling icons is easy to accomplish using CSS.
+
+Every icon has a class attribute applied called `lucide`. This class name can be used in the CSS file to target all icons that are being used within the app.
+
+- The **color** of the icons can be changed using the [`color`](https://developer.mozilla.org/en-US/docs/Web/CSS/color) CSS property.
+- The **size** of the icons can be changed using [`width`](https://developer.mozilla.org/en-US/docs/Web/CSS/width) and [`height`](https://developer.mozilla.org/en-US/docs/Web/CSS/height) CSS properties.
+- The **stroke width** of the icons can be changed using the [`stroke-width`](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-width) CSS property.
+
+::: sandpack {template=vite-solid editorHeight=300 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```css icon.css [active]
+.lucide {
+ /* Change this! */
+ color: #ffadff;
+ width: 48px;
+ height: 48px;
+ stroke-width: 1px;
+}
+
+.grid {
+ display: grid;
+ grid-template-columns: 1fr 1fr 1fr;
+ grid-template-rows: 1fr 1fr 1fr;
+ gap: 6px;
+}
+```
+
+```tsx App.tsx
+import CakeSlice from 'lucide-solid/icons/cake-slice';
+import Candy from 'lucide-solid/icons/candy';
+import Apple from 'lucide-solid/icons/apple';
+import Cookie from 'lucide-solid/icons/cookie';
+import Martini from 'lucide-solid/icons/martini';
+import IceCream2 from 'lucide-solid/icons/ice-cream-2';
+import Sandwich from 'lucide-solid/icons/sandwich';
+import Wine from 'lucide-solid/icons/wine';
+import Dessert from 'lucide-solid/icons/dessert';
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+
+
+
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+### Absolute stroke width
+
+For global absolute stroke width styling the `vector-effect: non-scaling-stroke` CSS property can be applied to the children. This will keep the stroke-width the same size no matter the size of the icon. See [absolute-stroke-width](../basics/stroke-width.md#absolute-stroke-width) for more info.
+
+::: sandpack {template=vite-solid editorHeight=300 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```css icon.css [active]
+.lucide {
+ width: 48px;
+ height: 48px;
+ stroke-width: 1.5;
+}
+
+.lucide * {
+ vector-effect: non-scaling-stroke;
+}
+
+.grid {
+ display: grid;
+ grid-template-columns: 1fr 1fr 1fr;
+ grid-template-rows: 1fr 1fr 1fr;
+ gap: 6px;
+}
+
+```
+
+```tsx App.tsx
+import TentTree from 'lucide-solid/icons/tent-tree';
+import Caravan from 'lucide-solid/icons/caravan';
+import FlameKindling from 'lucide-solid/icons/flame-kindling';
+import MountainSnow from 'lucide-solid/icons/mountain-snow';
+import Trees from 'lucide-solid/icons/trees';
+import Axe from 'lucide-solid/icons/axe';
+import Map from 'lucide-solid/icons/map';
+import CloudMoon from 'lucide-solid/icons/cloud-moon';
+import Sparkles from 'lucide-solid/icons/sparkles';
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+
+
+
+
+
+
+
+
+ );
+}
+
+export default App;
+```
+
+:::
diff --git a/docs/guide/solid/advanced/typescript.md b/docs/guide/solid/advanced/typescript.md
new file mode 100644
index 000000000..1142e3b0f
--- /dev/null
+++ b/docs/guide/solid/advanced/typescript.md
@@ -0,0 +1,97 @@
+---
+title: Typescript - Solid
+description: Learn about the different types exported by the `lucide-solid` package and how to use them in your Solid application.
+---
+# TypeScript Support
+
+List of exported types from the `lucide-solid` package.
+These can be used to type your components when using Lucide icons in a TypeScript React project
+
+## `LucideProps`
+
+Exports all props that can be passed to an icon component and any other SVG attributes, see: [SVG Presentation Attributes on MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/Presentation).
+
+```ts
+interface LucideProps extends SVGAttributes {
+ size?: number | string;
+ color?: string;
+ strokeWidth?: number;
+ absoluteStrokeWidth?: boolean;
+ [key: string]: any; // Any other SVG attributes
+}
+```
+
+### Using `LucideProps`
+You can use the `LucideProps` interface to type your custom icon components or when you need to work with icon props.
+
+```tsx
+import { type LucideProps } from 'lucide-solid';
+import { Camera } from 'lucide-solid';
+
+const WrapIcon = (props: LucideProps) => {
+ return ;
+};
+
+export default WrapIcon;
+```
+
+## `LucideIcon`
+
+Type for individual icon components.
+
+```ts
+type LucideIcon = (props: LucideProps) => JSX.Element;
+```
+
+### Using `LucideIcon`
+
+You can use the `LucideIcon` type when you need to work with icon components directly.
+
+```tsx
+import { type LucideIcon, Camera } from 'lucide-solid';
+
+interface ButtonProps {
+ icon: LucideIcon;
+ label: string;
+}
+
+const IconButton = ({ icon: Icon, label }) => {
+ return (
+
+ );
+};
+
+export default IconButton;
+```
+
+## `IconNode`
+
+Type for the raw SVG structure of an icon. This is an array of SVG elements and their attributes to render the icon.
+Not commonly used directly in application code. But can be useful for advanced use cases, such as using custom icons or [with Lucide Lab](./with-lucide-lab).
+
+```ts
+type IconNode = [elementName: string, attrs: Record][];
+```
+
+### Using `IconNode`
+You can use the `IconNode` type when you need to work with the raw SVG structure of an icon.
+
+```tsx
+import { type IconNode, Icon } from 'lucide-solid';
+
+const customIcon: IconNode = [
+ ['circle', { cx: 12, cy: 12, r: 10 }],
+ ['line', { x1: 12, y1: 8, x2: 12, y2: 12 }],
+ ['line', { x1: 12, y1: 16, x2: 12, y2: 16 }],
+];
+
+const MyCustomIcon = () => {
+ return (
+
+ );
+};
+
+export default MyCustomIcon;
+```
diff --git a/docs/guide/solid/advanced/with-lucide-lab.md b/docs/guide/solid/advanced/with-lucide-lab.md
new file mode 100644
index 000000000..210a2a97d
--- /dev/null
+++ b/docs/guide/solid/advanced/with-lucide-lab.md
@@ -0,0 +1,23 @@
+---
+title: With Lucide Lab or custom icons - Solid
+description: Learn how to use Lucide Lab or custom icons in your Solid applications using the Icon component.
+---
+# With Lucide Lab or custom icons
+
+[Lucide Lab](https://github.com/lucide-icons/lucide-lab) is a collection of icons that are not part of the Lucide main library.
+
+They can be used by using the `Icon` component.
+All props like regular lucide icons can be passed to adjust the icon appearance.
+
+## Using the `Icon` component
+
+This creates a single icon based on the iconNode passed and renders a Lucide icon component.
+
+```tsx
+import { Icon } from 'lucide-solid';
+import { coconut } from '@lucide/lab';
+
+const App = () => (
+
+);
+```
diff --git a/docs/guide/solid/basics/color.md b/docs/guide/solid/basics/color.md
new file mode 100644
index 000000000..57c337e8e
--- /dev/null
+++ b/docs/guide/solid/basics/color.md
@@ -0,0 +1,66 @@
+---
+title: Color - Solid
+description: Learn how to adjust the color of icons in your Solid application using the `color` prop or by using parent elements text color value.
+---
+
+
+# Color
+
+By default, all icons have the color value: `currentColor`. This keyword uses the element's computed text `color` value to represent the icon color.
+
+Read more about [ `currentColor` on MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#currentcolor_keyword).
+
+## Adjust the color using the `color` prop
+
+The color can be adjusted by passing the color prop to the element.
+
+::: sandpack {template=vite-solid showTabs=false editorHeight=295 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```tsx ./App.tsx [active]
+import Smile from 'lucide-solid/icons/smile';
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+## Using parent elements text color value
+
+Because the color of lucide icons uses `currentColor`, the color of the icon depends on the computed `color` of the element, or it inherits it from its parent.
+
+For example, if a parent element's color value is `#fff` and one of the children is a lucide icon, the color of the icon will be rendered as `#fff`. This is browser native behavior.
+
+::: sandpack {template=vite-solid editorHeight=320 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```tsx ./Button.tsx [active]
+import ThumbsUp from 'lucide-solid/icons/thumbs-up';
+
+function LikeButton() {
+ return (
+
+ );
+}
+
+export default LikeButton;
+```
+
+```tsx ./App.tsx
+import Button from "./Button";
+
+export default function App() {
+ return ;
+}
+```
+:::
diff --git a/docs/guide/solid/basics/sizing.md b/docs/guide/solid/basics/sizing.md
new file mode 100644
index 000000000..3108378a7
--- /dev/null
+++ b/docs/guide/solid/basics/sizing.md
@@ -0,0 +1,125 @@
+---
+title: Sizing - Solid
+description: Learn how to adjust the size of icons in your Solid application using the `size` prop or by using CSS.
+---
+
+
+# Sizing
+
+By default, the size of all icons is `24px` by `24px`. The size is adjustable using the `size` prop and CSS.
+
+## Adjusting the icon size using the `size` prop
+
+::: sandpack {template=vite-solid showTabs=false editorHeight=300 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```tsx App.tsx [active]
+import Landmark from 'lucide-solid/icons/landmark';
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+## Adjusting the icon size via CSS
+
+The CSS properties `width` and `height` can be used to adjust the icon size.
+
+::: sandpack {template=vite-solid editorHeight=300 dependencies="lucide-solid"}
+
+```css icon.css [active]
+.my-beer-icon {
+ /* Change this! */
+ width: 64px;
+ height: 64px;
+}
+```
+
+```tsx App.tsx
+import Beer from 'lucide-solid/icons/beer';
+
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+
+```
+:::
+
+### Dynamically change the icon size based on the font size
+
+It is possible to resize icons based on font size. This can be achieved using the `em` unit. See this [MDN article](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size#ems) for more information on the `em` unit.
+
+::: sandpack {template=vite-solid editorHeight=300 dependencies="lucide-solid"}
+
+```css icon.css [active]
+.my-icon {
+ /* Icon size will relative to font-size of .text-wrapper */
+ width: 1em;
+ height: 1em;
+}
+
+.text-wrapper {
+ /* Change this! */
+ font-size: 96px;
+
+ /* layout stuff */
+ display: flex;
+ gap: 0.25em;
+ align-items: center;
+}
+```
+
+```tsx App.tsx
+import Star from 'lucide-solid/icons/star';
+import "./icon.css";
+
+function App() {
+ return (
+
+
+
Yes
+
+ );
+}
+
+export default App;
+```
+
+:::
+
+### Resizing with Tailwind
+
+`size-*` utilities can be used to adjust the size of the icon. See the [Tailwind documentation](https://tailwindcss.com/docs/width#setting-both-width-and-height) for more information on the `size-*` utilities.
+
+::: sandpack {template=vite-solid editorHeight=300 editorWidthPercentage=60 dependencies="lucide-solid" externalResources="https://cdn.tailwindcss.com"}
+
+```tsx App.tsx [active]
+import PartyPopper from 'lucide-solid/icons/party-popper';
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
diff --git a/docs/guide/solid/basics/stroke-width.md b/docs/guide/solid/basics/stroke-width.md
new file mode 100644
index 000000000..8e4e84f96
--- /dev/null
+++ b/docs/guide/solid/basics/stroke-width.md
@@ -0,0 +1,67 @@
+---
+title: Stroke width - Solid
+description: Learn how to adjust the stroke width of icons in your Solid application using the `strokeWidth` prop or adjust the strokeWidth appearance using the `absoluteStrokeWidth` prop.
+---
+
+
+# Stroke width
+
+All icons are designed with SVG elements using strokes.
+These have a default stroke width of `2px`.
+
+The `strokeWidth` can be adjusted to create a different look of the icons.
+
+## Adjusting stroke width with `strokeWidth` prop
+
+::: sandpack {template=vite-solid showTabs=false editorHeight=300 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```tsx App.tsx [active]
+import FolderLock from 'lucide-solid/icons/folder-lock';
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
+
+## Absolute stroke width
+
+When adjusting the `size` prop the size of the stroke width will be relative to the size of the icon, this is the default SVG behavior. The `absoluteStrokeWidth` prop is introduced to adjust this behavior to make the stroke width constant no matter the size of the icon.
+
+This means that when `absoluteStrokeWidth` is enabled and the `size` of the icons is set to `48px` the `strokeWidth` will still be `2px` on the screen.
+
+Note `2px` is the default stroke width for a Lucide icon, this can be adjusted to all sizes.
+
+
+
+### Adjusting stroke width with `absoluteStrokeWidth` prop
+
+Setting `absoluteStrokeWidth` to `true` will make the stroke width absolute.
+
+::: sandpack {template=vite-solid showTabs=false editorHeight=320 editorWidthPercentage=60 dependencies="lucide-solid"}
+
+```tsx App.tsx [active]
+import RollerCoaster from 'lucide-solid/icons/roller-coaster';
+
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
+```
+:::
diff --git a/docs/guide/solid/getting-started.md b/docs/guide/solid/getting-started.md
new file mode 100644
index 000000000..ddd5b0e5a
--- /dev/null
+++ b/docs/guide/solid/getting-started.md
@@ -0,0 +1,82 @@
+---
+title: Getting started - Solid
+description: This guide will help you get started with Lucide in your Solid project.
+---
+
+
+
+# Getting started
+
+
+
+This guide will help you get started with Lucide in your Solid project.
+Make sure you have a Solid environment set up. If you don't have one yet, you can create a new Solid project using Create Solid App, Vite, or any other Solid boilerplate of your choice.
+
+## Installation
+
+::: code-group
+
+```sh [pnpm]
+pnpm add lucide-solid@next
+```
+
+```sh [yarn]
+yarn add lucide-solid@next
+```
+
+```sh [npm]
+npm install lucide-solid@next
+```
+
+```sh [bun]
+bun add lucide-solid@next
+```
+
+:::
+
+## Importing your first icon
+
+Lucide is built with ES Modules, so it's completely tree-shakable.
+
+Each icon can be imported as a Solid component, which renders an inline SVG element. This way, only the icons that are imported into your project are included in the final bundle. The rest of the icons are tree-shaken away.
+
+```jsx
+import { Camera } from 'lucide-solid';
+
+// Usage
+const App = () => {
+ return ;
+};
+
+export default App;
+```
+
+## Props
+
+To customize the appearance of an icon, you can use the following props:
+
+| name | type | default |
+| --------------------- | --------- | ------------ |
+| `size` | *number* | 24 |
+| `color` | *string* | currentColor |
+| `strokeWidth` | *number* | 2 |
+| `absoluteStrokeWidth` | *boolean* | false |
+
+Because icons render as SVG elements, all standard SVG attributes can also be applied as props. See the list of SVG Presentation Attributes on [MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/Presentation).
+
+```jsx
+// Usage
+const App = () => {
+ return ;
+};
+```
+
+More examples and details how to use props, continue the guide:
+
+
+
+
diff --git a/docs/guide/solid/index.md b/docs/guide/solid/index.md
new file mode 100644
index 000000000..c5b2f31d8
--- /dev/null
+++ b/docs/guide/solid/index.md
@@ -0,0 +1,53 @@
+---
+title: Lucide for Solid
+description: Lucide provides a Solid icon component library that makes it easy to integrate icons into your Solid applications. Each icon is available as a standalone Solid component, allowing for seamless integration and customization.
+nextPage:
+ - getting-started
+---
+
+
+
+
+
+
+# Lucide for Solid
+
+Lucide provides a Solid icon component library that makes it easy to integrate icons into your Solid applications.
+Each icon is available as a standalone Solid component, allowing for seamless integration and customization.
+
+List of features:
+- **Easy to Use**: Import icons as Solid components and use them directly in your Solid components with JSX.
+- **Customizable**: Adjust size, color, and other properties via props.
+- **Tree-shakable**: Only the icons you use are included in your final bundle
+- **TypeScript Support**: Fully typed components for better developer experience.
+
+## Overview
+
+
+
+
+
+### Basics
+{{''}}
+
+
+
+
+
+### Advanced
+{{''}}
+
+
+
+
+
+### Resources
+{{''}}
+
+
+
+
diff --git a/docs/guide/solid/migration.md b/docs/guide/solid/migration.md
new file mode 100644
index 000000000..72261e47e
--- /dev/null
+++ b/docs/guide/solid/migration.md
@@ -0,0 +1,20 @@
+# Migration from v0
+
+Brand icons are removed in v1. If you are using any of the following icons, you will need to replace them with a custom SVG or an alternative icon:
+
+- Chromium
+- Codepen
+- Codesandbox
+- Dribbble
+- Facebook
+- Figma
+- Framer
+- Github
+- Gitlab
+- Instagram
+- LinkedIn
+- Pocket
+- RailSymbol (based on the British Rail logo)
+- Slack
+
+We recommend to use the official SVG icons provided by the respective brands, most of them can be found on their websites or in their brand guidelines. Alternatively, you can use the icons from [Simple Icons](https://simpleicons.org/), which provides a large collection of brand icons. Also with links to the official Brand Guidelines and SVG icons.
diff --git a/docs/guide/static/font/color.md b/docs/guide/static/font/color.md
new file mode 100644
index 000000000..94e9e62ab
--- /dev/null
+++ b/docs/guide/static/font/color.md
@@ -0,0 +1,23 @@
+---
+title: Color the Lucide icon font
+description: Learn how to customize the color of Lucide icons in your static projects using CSS. This guide covers how to change icon colors with CSS classes and inline styles for web font implementations.
+---
+# Color the font
+
+Styling the Lucide icon font with CSS is straightforward. You can change the color of the icons using the `color` property in your CSS. This allows you to easily customize the appearance of the icons to match your design.
+
+## Changing Icon Color
+
+To change the color of the icons, simply apply the `color` property to the element that contains the icon. For example, if you want to change the color of an icon to red, you can use the following CSS:
+
+```css
+.icon-house {
+ color: red;
+}
+```
+
+This will change the color of the icon with the class `icon-house` to red. You can use any valid CSS color value, such as hex codes, RGB, or named colors.
+
+## Inheriting Color from Parent Elements
+
+By default, the icons will inherit the color from their parent elements. This means that if you set a color on a parent element, all child icons will automatically take on that color unless you override it with a specific color for the icon. The same as text elements in HTML, the icon font will use the `color` property to determine its color, allowing for easy styling and consistency across your project.
diff --git a/docs/guide/static/font/index.md b/docs/guide/static/font/index.md
new file mode 100644
index 000000000..82764e9da
--- /dev/null
+++ b/docs/guide/static/font/index.md
@@ -0,0 +1,70 @@
+---
+description: Using the web font version of Lucide icons in your project. Learn how to include the stylesheet and use the icons with CSS classes.
+nextPage:
+ - getting-started
+---
+
+# Icon Font
+
+Lucide icons are also available as a web font. The font includes all icons as glyphs, allowing you to use them in your project with CSS classes. This can be a convenient option for projects that prefer using icon fonts.
+
+:::warning Not recommended for high traffic production use
+The Icon font includes all icons, which can significantly increase your app's bundle size and load time. For production environments, we recommend using a bundler with tree-shaking support to include only the icons you actually use. Consider using one of the framework-specific [packages](../../../packages.md).
+:::
+
+## Using the CSS Stylesheet
+
+::: code-group
+
+```css [Vite]
+@import 'lucide-static/font/lucide.css';
+```
+
+```css [Webpack]
+@import "~lucide-static/font/lucide.css";
+```
+
+```html [CDN]
+
+```
+
+```html [Static asset]
+
+```
+
+:::
+
+## Using the Icon Font
+
+Once you have included the stylesheet, you can use the icons in your HTML by applying the appropriate CSS classes. Each icon has a corresponding class name that you can use to display it.
+
+For example, to display the "home" icon, you would use the following HTML:
+
+```html
+
+```
+
+## Example with JavaScript
+
+
+::: sandpack {template=vanilla showTabs=false editorHeight=480 editorWidthPercentage=60 dependencies="lucide-static"}
+
+```html /index.html [active]
+
+
+
+
+
+
+
+
+```
+
+```js /index.js
+import "./styles.css";
+import "lucide-static/font/lucide.css";
+```
+
+:::
diff --git a/docs/guide/static/font/sizing.md b/docs/guide/static/font/sizing.md
new file mode 100644
index 000000000..9f0c32f9b
--- /dev/null
+++ b/docs/guide/static/font/sizing.md
@@ -0,0 +1,19 @@
+---
+title: Size the Lucide icon font
+description: Learn how to customize the color of Lucide icons in your static projects using CSS. This guide covers how to change icon colors with CSS classes and inline styles for web font implementations.
+---
+# Size the font
+
+Styling the Lucide icon font with CSS is straightforward. You can change the color of the icons using the `font-size` property in your CSS. This allows you to easily customize the appearance of the icons to match your design.
+
+## Changing the size
+
+To change the size of the icons, simply apply the `font-size` property to the element that contains the icon. For example, if you want to change the size of an icon to 24px, you can use the following CSS:
+
+```css
+.icon-house {
+ font-size: 24px;
+}
+```
+
+This will change the size of the icon with the class `icon-house` to 24px. You can use any valid CSS size value, such as em, rem, or percentage.
diff --git a/docs/guide/static/getting-started.md b/docs/guide/static/getting-started.md
new file mode 100644
index 000000000..94b403add
--- /dev/null
+++ b/docs/guide/static/getting-started.md
@@ -0,0 +1,50 @@
+
+
+# Getting started
+
+This guide will help you get started with Lucide Static in your project.
+Make sure you have a your environment set up. If you don't have one yet, you can create a new project using Vite, Parcel or any other boilerplate of your choice.
+
+## For what use cases is `lucide-static` suitable?
+
+`lucide-static` is suitable for _very specific use cases_ where you want to use Lucide icons without relying on a JavaScript framework or component system. It's ideal for:
+
+- Projects that use icon fonts with plain CSS or utility-first frameworks
+- Embedding raw SVG files or sprites directly in HTML
+- Using SVGs as CSS background images
+- Importing SVG strings into Node.js environments
+
+::: danger Not recommended for production high performance needs {#production-warning}
+SVG sprites and icon fonts include **all icons**, which can significantly increase your app's bundle size and load time.
+
+For production environments, we recommend using a bundler with tree-shaking support to include only the icons you actually use. Consider using one of the framework-specific [packages](../../packages.md).
+:::
+
+## Installation
+
+
+
+### Package Managers
+
+::: code-group
+
+```sh [pnpm]
+pnpm add lucide-static@next
+```
+
+```sh [yarn]
+yarn add lucide-static@next
+```
+
+```sh [npm]
+npm install lucide-static@next
+```
+
+```sh [bun]
+bun add lucide-static@next
+```
+
+:::
diff --git a/docs/guide/static/index.md b/docs/guide/static/index.md
new file mode 100644
index 000000000..7f7bbcbb1
--- /dev/null
+++ b/docs/guide/static/index.md
@@ -0,0 +1,66 @@
+---
+title: Overview
+nextPage:
+ - getting-started
+---
+
+
+
+
+
+# Lucide Static Assets
+
+Static assets and utilities for Lucide icons that work without JavaScript frameworks. This package provides multiple formats including individual SVG files, SVG sprites, icon fonts, and Node.js utilities for server-side rendering and static site generation.
+
+**What you can accomplish:**
+
+- Use individual SVG files as images or CSS background images
+- Implement icon fonts for CSS-based icon systems
+- Create SVG sprites for efficient icon loading in static sites
+- Import SVG strings in Node.js applications and server-side rendering
+- Build static websites and applications without JavaScript framework dependencies
+
+This package includes the following implementations of Lucide icons:
+
+- Individual SVG files
+- SVG sprite
+- Icon font files
+- A JavaScript library exporting SVG strings
+
+## Overview
+
+
+
+
+
+### SVG Files & Sprite
+{{''}}
+
+
+
+
+
+### Icon Font
+{{''}}
+
+
+
+
+
+### Javascript modules
+{{''}}
+
+
+
+
+
+### Resources
+{{''}}
+
+
+
+
diff --git a/docs/guide/static/js-modules/node.md b/docs/guide/static/js-modules/node.md
new file mode 100644
index 000000000..0799324b4
--- /dev/null
+++ b/docs/guide/static/js-modules/node.md
@@ -0,0 +1,57 @@
+
+
+# Use Lucide in Node.js
+
+You can also import Lucide icons in Node.js projects, with the lucide-static package.
+Each icon is exported as a string containing the SVG markup, which can be used in server-side rendering or static site generation.
+
+::: code-group
+
+```js [ESM]
+import {MessageSquare} from 'lucide-static';
+```
+
+```js [CommonJs]
+const {MessageSquare} = require('lucide-static');
+```
+
+:::
+
+> Note: Each icon name is in PascalCase. You can find the icon names in the [Lucide Icons page](https://lucide.dev/icons).
+
+
+## Example with Node.js
+
+::: sandpack {template=node showTabs=false editorHeight=480 editorWidthPercentage=60 dependencies="lucide-static"}
+
+```js /index.js [active]
+import http from 'http';
+import { MessageSquare } from 'lucide-static';
+
+const server = http.createServer((req, res) => {
+ res.statusCode = 200;
+ res.setHeader('Content-Type', 'text/html');
+
+ res.end(`
+
+
+
+
Lucide Icons
+
This is a Lucide icon ${MessageSquare}
+
+
+
+ `);
+});
+
+const hostname = '127.0.0.1';
+const port = 3000;
+
+server.listen(port, hostname, () => {
+ console.log(`Server running at http://${hostname}:${port}/`);
+});
+```
+
+:::
diff --git a/docs/guide/static/js-modules/web.md b/docs/guide/static/js-modules/web.md
new file mode 100644
index 000000000..c69672f74
--- /dev/null
+++ b/docs/guide/static/js-modules/web.md
@@ -0,0 +1,34 @@
+
+
+# Use Lucide in Web
+
+:::warning Not recommended for high traffic production use
+This library exports each svg as basic strings. We have a more optimized library for web. Which is smaller in size and supports color, size and strokeWidth. See [Lucide](../../lucide/index.md).
+:::
+
+You can also import SVG strings in your web projects, with the lucide-static package. Each icon is exported as a string containing the SVG markup, which can be used in client-side rendering.
+
+::: sandpack {template=vanilla showTabs=false editorHeight=295 editorWidthPercentage=60 dependencies="lucide-static"}
+
+```html /index.html [active]
+
+
+
+
+
+
+
+
+```
+
+```js /index.js
+import "./styles.css";
+import { Smile } from 'lucide-static';
+
+document.getElementById("app").innerHTML = Smile;
+```
+:::
+
+> Note: Each icon name is in PascalCase. You can find the icon names in the [Lucide Icons page](https://lucide.dev/icons).
diff --git a/docs/guide/static/link-as-image.md b/docs/guide/static/link-as-image.md
new file mode 100644
index 000000000..251b3da2e
--- /dev/null
+++ b/docs/guide/static/link-as-image.md
@@ -0,0 +1,89 @@
+---
+description: Learn how to use Lucide icons as images in your project.
+---
+
+
+
+# Link as Image
+
+In some cases, you might want to use Lucide icons as images instead of inline SVGs. This can be useful for performance reasons or when you want to use the icons in contexts where inline SVGs are not supported.
+
+## In HTML
+
+You can link to the SVG files directly in your HTML using the `` tag. The path to the SVG files will depend on how you have set up your project.
+
+::: code-group
+
+```html [Vite]
+
+
+
+
+
+```
+
+```html [Webpack]
+
+
+
+
+
+```
+
+```html [CDN]
+
+
+
+
+
+```
+
+:::
+
+::: warning For CDN users
+Names of icons can change in future releases. Make sure you set an explicit version in the URL to avoid breaking changes.\
+`https://cdn.jsdelivr.net/npm/lucide-static@{version}/icons/smile.svg`
+:::
+
+## In CSS
+
+You can also use the icons as background images in your CSS. This is useful for adding icons to buttons, links, or other elements.
+
+::: code-group
+
+```css [Vite]
+.button {
+ background-image: url('node_modules/lucide-static/icons/smile.svg');
+}
+```
+
+```css [Webpack]
+.button {
+ background-image: url('~/lucide-static/icons/smile.svg');
+}
+```
+
+```css [CDN]
+.button {
+ background-image: url('https://cdn.jsdelivr.net/npm/lucide-static@latest/icons/smile.svg');
+}
+```
+
+:::
+
+::: warning For CDN users
+Names of icons can change in future releases. Make sure you set an explicit version in the URL to avoid breaking changes.\
+`https://cdn.jsdelivr.net/npm/lucide-static@{version}/icons/smile.svg`
+:::
+
+
diff --git a/docs/guide/static/migration.md b/docs/guide/static/migration.md
new file mode 100644
index 000000000..72261e47e
--- /dev/null
+++ b/docs/guide/static/migration.md
@@ -0,0 +1,20 @@
+# Migration from v0
+
+Brand icons are removed in v1. If you are using any of the following icons, you will need to replace them with a custom SVG or an alternative icon:
+
+- Chromium
+- Codepen
+- Codesandbox
+- Dribbble
+- Facebook
+- Figma
+- Framer
+- Github
+- Gitlab
+- Instagram
+- LinkedIn
+- Pocket
+- RailSymbol (based on the British Rail logo)
+- Slack
+
+We recommend to use the official SVG icons provided by the respective brands, most of them can be found on their websites or in their brand guidelines. Alternatively, you can use the icons from [Simple Icons](https://simpleicons.org/), which provides a large collection of brand icons. Also with links to the official Brand Guidelines and SVG icons.
diff --git a/docs/guide/static/svg-sprite.md b/docs/guide/static/svg-sprite.md
new file mode 100644
index 000000000..09747187a
--- /dev/null
+++ b/docs/guide/static/svg-sprite.md
@@ -0,0 +1,108 @@
+---
+description: Learn how to use SVG sprites with Lucide icons in your project, including basic usage and inline options.
+---
+
+# Using the SVG sprite
+
+Learn how to use SVG sprites with Lucide icons in your project, including basic usage and inline options.
+
+:::warning Not recommended for high traffic production use
+The SVG sprite includes all icons, which can significantly increase your app's bundle size and load time. For production environments, we recommend using a bundler with tree-shaking support to include only the icons you actually use. Consider using one of the framework-specific [packages](../../packages.md).
+:::
+
+SVG sprites can be loaded as individual image, or used inline with the `
+`;
+
+exports[`Using lucide icon components > should add a style attribute to the element 1`] = `
+
+
+
+
+
+
+
+
+`;
+
+exports[`Using lucide icon components > should adjust the size, stroke color and stroke width 1`] = `
+
+
+
+
+
+
+
+
+`;
+
+exports[`Using lucide icon components > should pass children to the icon slot 1`] = `
+
+
+
+
+
+
+
+
+ Hello World
+
+
+
+
+`;
+
+exports[`Using lucide icon components > should render an component 1`] = `
+
+
+
+
+
+
+
+
+`;
diff --git a/packages/lucide-vue/tests/__snapshots__/lucide-vue.spec.ts.snap b/packages/vue/tests/__snapshots__/lucide-vue.spec.ts.snap
similarity index 82%
rename from packages/lucide-vue/tests/__snapshots__/lucide-vue.spec.ts.snap
rename to packages/vue/tests/__snapshots__/lucide-vue.spec.ts.snap
index d354ef533..88156ce1b 100644
--- a/packages/lucide-vue/tests/__snapshots__/lucide-vue.spec.ts.snap
+++ b/packages/vue/tests/__snapshots__/lucide-vue.spec.ts.snap
@@ -3,7 +3,7 @@
exports[`Using lucide icon components > should add a class to the element 1`] = `
should add a class to the element 1`] =
should add a class to the element 1`] =
exports[`Using lucide icon components > should add a style attribute to the element 1`] = `
should add a style attribute to the elem
should add a style attribute to the elem
exports[`Using lucide icon components > should adjust the size, stroke color and stroke width 1`] = `
should adjust the size, stroke color and
should adjust the size, stroke color and
exports[`Using lucide icon components > should pass children to the icon slot 1`] = `
should pass children to the icon slot 1`
+
Hello World
+
`;
@@ -175,7 +161,7 @@ exports[`Using lucide icon components > should pass children to the icon slot 1`
exports[`Using lucide icon components > should render an component 1`] = `