2022-02-01 19:26:07 +01:00
---
title : Icon Design Guide
---
# Icon Design Principles
2020-10-25 22:48:03 +01:00
Here are rules that should be followed to keep quality and consistency when making icons for Lucide.
## Summary of the rules we have
2020-10-27 21:48:45 +01:00
1. Icons must be designed on a **24 by 24 pixels** canvas.
2021-10-03 10:14:49 +02:00
2. Icons must have at least **1 pixel padding** within the canvas.
2020-10-27 21:48:45 +01:00
3. Icons must have a **stroke width of 2 pixels** .
4. Icons must use **round joins** .
5. Icons must use **round caps** .
6. Icons must use **centered strokes** .
7. Shapes (such as rectangles) in icons must have **border radius of 2 pixels** .
8. Distinct elements must have **2 pixels of spacing between each other** .
2020-10-25 22:48:03 +01:00
## The Rules Visualized
2020-10-27 21:48:45 +01:00
### 1. Icons must be designed on a 24 by 24 pixels canvas.
2020-10-25 22:48:03 +01:00

2021-10-03 10:14:33 +02:00
### 2. Icons must have at least 1 pixel padding within the canvas.
2020-10-25 22:48:03 +01:00

2020-10-27 21:48:45 +01:00
### 3. Icons must have a stroke width of 2 pixels.
2020-10-25 22:48:03 +01:00

2020-10-27 21:48:45 +01:00
### 4. Icons must use round joins.
2020-10-25 22:48:03 +01:00

2020-10-27 21:48:45 +01:00
### 5. Icons must use round caps.
2020-10-25 22:48:03 +01:00

2020-10-27 21:48:45 +01:00
### 6. Icons must use centered strokes.
2020-10-25 22:48:03 +01:00

2020-10-27 21:48:45 +01:00
### 7. Shapes (such as squares) in icons must have border radius of 2 pixels.
2020-10-25 22:48:03 +01:00

2020-10-27 21:48:45 +01:00
### 8. Distinct elements must have 2 pixels of spacing between each other.
2020-10-25 22:48:03 +01:00

## Code Conventions
Before an icon is added to the library, we like to have readable and optimized svg code.
2023-04-12 21:14:34 +02:00
Never use [`<use>` ](https://developer.mozilla.org/en-US/docs/Web/SVG/Element/use ). While it may sometimes seem like a good way to optimize file size, there's no way to ensure that the referenced element IDs will be unique once the SVGs are embedded in HTML documents.
2020-10-25 22:48:03 +01:00
### Global Attributes
2020-10-27 21:48:45 +01:00
For each icon these attributes are applied, corresponding to the above rules.
2020-10-25 22:48:03 +01:00
```xml
<svg
xmlns= "http://www.w3.org/2000/svg"
width= "24"
height= "24"
viewBox= "0 0 24 24"
fill= "none"
stroke= "currentColor"
stroke-width= "2"
stroke-linecap= "round"
stroke-linejoin= "round"
>
<!-- SVGElements -->
</svg>
```
### Minify paths
Code of paths can get really big.
To reduce file size we like to minify the code.
We recommend to use the [SVGOMG ](https://jakearchibald.github.io/svgomg/ ) to minify paths.
2023-02-16 08:26:29 +01:00
### JSON metadata descriptor
Each icon added must also come with a matching JSON file listing tags and categories for the icon.
Please use the following template:
```json
{
"$schema" : "../icon.schema.json" ,
"tags" : [
"foo" ,
"bar"
],
"categories" : [
"devices"
]
}
```