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
Not recommended for production high performance needs
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.
Installation
Package Managers
pnpm add lucide-static@nextyarn add lucide-static@nextnpm install lucide-static@nextbun add lucide-static@next