Merge branch 'main' of https://github.com/lucide-icons/lucide into adding-use-cases

.cspell/custom-words.txt

@@ -9,4 +9,3 @@ strikethrough
 touchpad
 ungroup
 toc
-sunlounger

.eslintignore

@@ -0,0 +1,11 @@
+dist
+build
+coverage
+lib
+tests
+node_modules
+.eslintrc.js
+docs/images
+docs/**/examples/
+packages/lucide-react/dynamicIconImports.js
+packages/angular/.angular

.eslintrc.js

@@ -0,0 +1,75 @@
+const DEFAULT_ATTRS = require('./tools/build-icons/render/default-attrs.json');
+
+module.exports = {
+  root: true,
+  env: {
+    browser: true,
+    node: true,
+  },
+  extends: ['airbnb-base', 'prettier'],
+  plugins: ['import', '@html-eslint'],
+  rules: {
+    'no-console': 'off',
+    'no-param-reassign': 'off',
+    'no-shadow': 'off',
+    'no-use-before-define': 'off',
+    'import/no-extraneous-dependencies': [
+      'error',
+      {
+        devDependencies: ['**/*.test.js', '**/*.spec.js', '**/scripts/**'],
+      },
+    ],
+    'import/extensions': [
+      'error',
+      {
+        pattern: {
+          mjs: 'always',
+          json: 'always',
+        },
+      },
+    ],
+  },
+  parserOptions: {
+    tsconfigRootDir: __dirname,
+    project: ['./docs/tsconfig.json', './packages/*/tsconfig.json'],
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+  },
+  overrides: [
+    {
+      files: ['./icons/*.svg'],
+      parser: '@html-eslint/parser',
+      rules: {
+        '@html-eslint/require-doctype': 'off',
+        '@html-eslint/no-duplicate-attrs': 'error',
+        '@html-eslint/no-inline-styles': 'error',
+        '@html-eslint/require-attrs': [
+          'error',
+          ...Object.entries(DEFAULT_ATTRS).map(([attr, value]) => ({
+            tag: 'svg',
+            attr,
+            value: String(value),
+          })),
+        ],
+        '@html-eslint/indent': ['error', 2],
+        '@html-eslint/no-multiple-empty-lines': ['error', { max: 0 }],
+        '@html-eslint/no-extra-spacing-attrs': [
+          'error',
+          {
+            enforceBeforeSelfClose: true,
+          },
+        ],
+        '@html-eslint/require-closing-tags': [
+          'error',
+          {
+            selfClosing: 'always',
+            allowSelfClosingCustom: true,
+          },
+        ],
+        '@html-eslint/element-newline': 'error',
+        '@html-eslint/no-trailing-spaces': 'error',
+        '@html-eslint/quotes': 'error',
+      },
+    },
+  ],
+};

.github/DISCUSSION_TEMPLATE/icon-design.yml

@@ -1,49 +0,0 @@
-title: 'Icon Request: '
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Before submitting an icon request check if it has already been requested. If there is an open request, please add a 👍.
-
-        > [!CAUTION]
-        > New brand logos are **not** allowed, see our official statement: https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md.
-        >
-        > Existing brand icons have been phased out. Consider using https://simpleicons.org, which offers purpose-built SVGs that are also on a 24×24px grid.
-  - type: input
-    id: name
-    attributes:
-      label: Icon name
-      description: What should this icon depict? For multiple icons, provide a comma-separated list.
-    validations:
-      required: true
-  - type: textarea
-    id: use-cases
-    attributes:
-      label: Use cases
-      description: Why do you need this icon? Include at least two real-life use cases per requested icon, avoiding generic descriptions like "it's a car icon".
-      placeholder: e.g. I need a star icon to use in my rating system.
-    validations:
-      required: true
-  - type: textarea
-    id: design-ideas
-    attributes:
-      label: Design ideas
-      description: What should this icon look like? Provide simple, minimalistic icon examples from other sets or your own drafts to help us visualize your request.
-    validations:
-      required: true
-  - type: checkboxes
-    id: checklist
-    attributes:
-      label: Checklist
-      description: Please review the following checklist before submitting your request.
-      options:
-        - label: I have searched if someone has submitted a similar request before and there weren't any.
-          required: true
-        - label: I have searched existing icons to make sure it does not already exist and I didn't find any.
-          required: true
-        - label: I am not requesting a brand logo and the art is not protected by copyright, see more at https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md
-          required: true
-        - label: I am not requesting an icon that includes religious, war/violence related, political imagery or hate symbols.
-          required: true
-        - label: I have provided appropriate use cases for the icon(s) requested.
-          required: true

.github/dependabot.yml

@@ -1,106 +0,0 @@
-version: 2
-
-updates:
-  - package-ecosystem: npm
-    directory: /
-    schedule:
-      interval: weekly
-    groups:
-      react-deps:
-        patterns:
-          - '@testing-library/react'
-          - '@types/prop-types'
-          - '@types/react'
-          - '@vitejs/plugin-react'
-          - 'react'
-          - 'react-dom'
-      vue-deps:
-        patterns:
-          - '@testing-library/vue'
-          - '@vitejs/plugin-vue'
-          - '@vue/test-utils'
-          - 'vue'
-      svelte-deps:
-        patterns:
-          - '@sveltejs/*'
-          - '@testing-library/svelte'
-          - '@tsconfig/svelte'
-          - 'svelte'
-          - 'svelte-check'
-          - 'svelte-preprocess'
-      solid-deps:
-        patterns:
-          - '@babel/*'
-          - '@rollup/plugin-babel'
-          - '@solidjs/testing-library'
-          - 'babel-preset-solid'
-          - 'solid-js'
-          - 'vite-plugin-solid'
-      react-native-deps:
-        patterns:
-          - 'react-native'
-          - 'react-native-svg'
-      angular-deps:
-        patterns:
-          - '@angular/*'
-          - '@angular-eslint/*'
-          - '@vitest/browser-playwright'
-          - 'angular-eslint'
-          - 'ng-packagr'
-          - 'rxjs'
-          - 'tslib'
-      preact-deps:
-        patterns:
-          - '@preact/preset-vite'
-          - '@testing-library/preact'
-          - 'preact'
-      astro-deps:
-        patterns:
-          - '@astrojs/*'
-          - 'astro'
-      testing-deps:
-        patterns:
-          - '@testing-library/*'
-          - '@vitest/*'
-          - 'jest-serializer-html'
-          - 'jsdom'
-          - 'linkedom'
-          - 'vitest'
-      build-deps:
-        patterns:
-          - '@rollup/*'
-          - '@vitejs/*'
-          - 'esbuild'
-          - 'rollup'
-          - 'rollup-plugin-*'
-          - 'typescript'
-          - 'vite'
-          - 'vite-plugin-*'
-      linting-deps:
-        patterns:
-          - '@eslint/*'
-          - '@html-eslint/*'
-          - '@typescript-eslint/*'
-          - 'angular-eslint'
-          - 'cspell'
-          - 'eslint'
-          - 'eslint-*'
-          - 'husky'
-          - 'lint-staged'
-          - 'prettier'
-          - 'prettier-plugin-*'
-      types-deps:
-        patterns:
-          - '@types/*'
-      remaining-deps:
-        patterns:
-          - '*'
-
-  - package-ecosystem: github-actions
-    directory: /
-    schedule:
-      interval: monthly
-    groups:
-      github-actions:
-        patterns:
-          - '*'

.github/instructions/metadata.instructions.md

@@ -13,72 +13,8 @@ The `contributors` property is a required array of GitHub usernames for the peop
 
 The `tags` property is an array of strings that describe the icon and can be used for searching.
 Validate the tags against the `icon.schema.json` to ensure they are correctly formatted and adhere to the defined structure.
-Provide tag suggestions based on the name of the icon and the use cases provided in the PR description. Use the existing tags in the repository as a reference for consistency and to avoid duplicates. Don't suggest words like: 'icon' and preferably use single words. Tags should always be in lowercase, and may also contain spaces (e.g. `magnifying glass`). The name of icon should not be included in the tags, as it is already specified.
+Provide tag suggestions based on the name of the icon and the use cases provided in the PR description. Use the existing tags in the repository as a reference for consistency and to avoid duplicates. Don't suggest words like: 'icon' and preferably use single words. Tags should always be in lowercase and should not contain spaces. The name of icon should not be included in the tags, as it is already specified.
 
-## Categories
+# Categories
 
 The `categories` property is an array of strings that specify the categories to which the icon belongs, such as "devices", "interface", "media", etc. See the `categories` property in the `icon.schema.json` for more details on the allowed values. The categories should be chosen based on the use cases provided in the PR description and the existing categories in the repository. The categories should be relevant to the icon and should help users find the icon when searching for specific types of icons. The name of icon should not be included in the categories, as it is already specified. Suggest categories based on the name of the icon and the use cases provided in the PR description. Use the existing categories in the repository as a reference for consistency and to avoid duplicates. Categories should always be in lowercase and should not contain spaces.
-
-## Use Cases
-
-The `use-cases` property is an array of strings that describe the specific scenarios in which the icon would be used. Each use case should be concise and clearly convey the context in which the icon is applicable. Use the existing use cases in the repository as a reference for consistency and to avoid duplicates.
-
-### Writing icon use-cases
-
-A use-case tells a reader **where and why an icon would be used in a real interface**. Each entry should let someone who has never seen the icon understand what it's for.
-
-### Format
-
-- Write each use-case as a short phrase, not a sentence. Start with a present participle verb: *Representing…*, *Indicating…*, *Marking…*, *Showing…*, *Confirming…*, *Toggling…*, *Categorizing…*, *Searching…*.
-- Keep it to roughly 4–12 words. One clear idea per entry.
-- No trailing period. No leading bullet, number, or dash (the surrounding format supplies that).
-- Give each icon 1–4 use-cases, ordered most-common first. Prefer fewer strong entries over many weak or repetitive ones.
-
-### Voice
-
-- Write from the interface's perspective, describing the function: "Indicating a low battery charge level" — not the requester's story ("I need an icon that shows…").
-- Name the concrete context where useful: *in smart home apps*, *in navigation apps*, *in text editors*, *on maps*. Context is what makes a use-case self-explanatory.
-- Be neutral and factual. No first person, no marketing adjectives ("perfect for", "ideal", "beautiful"), no emoji.
-
-### What to exclude
-
-- **The requester's personal narrative.** "I'm building a SvelteKit UI and need…" → drop the framing, keep the function.
-- **References to other issues, PRs, or icons by ID.** No "As provided in #1865", "complementary to git-branch-plus", "same as above", "see #2055".
-- **Design/implementation chatter.** Bezier offsets, grid alignment, path cuts, "the icon works perfectly" — none of that is a use-case.
-- **Restating the icon's name.** For `microchip`, "microchip" is not a use-case; describe what it represents ("Representing processors, chips, or embedded hardware").
-- **Links, image tags, emoji, and markdown artifacts.**
-- **Meta-commentary.** "Self-explanatory", "lots and lots of use cases", "obvious :)".
-
-### Cross-contamination
-
-When a request covers several icons at once, assign each use-case only to the icon it actually describes. A bullet prefixed with another icon's name belongs to that icon, not this one. Don't let `briefcase-medical`'s meanings leak into `briefcase-business`.
-
-### Variants
-
-Related icons should get **variant-specific** wording, not one shared blurb. `battery-low` → "Indicating a low battery charge level"; `battery-full` → "…full…". `square-arrow-right-enter` → sign in / join; `-exit` → sign out / export. Resist copying the same line across a family.
-
-### Deriving from source material
-
-When mining descriptions, comments, or linked issues:
-
-- Prefer the **stated purpose** over the backstory. Extract the function, discard the anecdote.
-- If a source lists genuinely distinct uses, keep them as separate entries; if it repeats one idea five ways, collapse to one.
-- Merge an intro line with its bullets ("To represent:" + "pottery" → "Representing pottery").
-- If the only signal is noise (a name restatement, a link, "thanks!"), leave the icon without a use-case rather than inventing one.
-- Never fabricate a use-case that isn't supported by the icon's meaning or the source.
-
-## Examples
-
-Good:
-
-- `ambulance` → "Directing users to nearby emergency services in navigation apps"
-- `calendar-sync` → "Representing recurring events, promotions, or limited-time offers"
-- `globe-x` → "Indicating a device or application is offline or unreachable"
-- `heading-2` → "Applying a level-2 heading in text editors"
-
-Poor → fixed:
-
-- ~~"I need a firewall icon :-)"~~ → "Representing firewalls and firewall rules on cybersecurity platforms"
-- ~~"As above"~~ → "Signifying a deal, agreement, or partnership"
-- ~~"microchip"~~ → "Representing processors, chips, or embedded hardware"
-- ~~"Same use cases as the other currency symbols, except Turkish lira"~~ → "Displaying prices or amounts in Turkish lira"

.github/instructions/ux-writing.instructions.md

@@ -1,587 +0,0 @@
----
-applyTo: "docs/*.md"
----
-# UX writing guidelines
-
-Follow these guidelines when writing or editing Lucide documentation, especially Markdown files.
-
-Write for people who are trying to understand a concept, follow a specification, or complete a task. Prioritize clarity, precision, and scannability over personality or decorative prose.
-
-## Be direct and concise
-
-State the important information first. Remove words that do not add meaning.
-
-Prefer short sentences and paragraphs, but do not sacrifice precision just to make text shorter.
-
-**Do:**
-
-> Icons must use a 24 × 24 pixel canvas.
-
-**Don't:**
-
-> When creating a new icon, you should make sure that the canvas you're working with has dimensions of 24 × 24 pixels.
-
-Avoid unnecessary introductions such as:
-
-- "It's important to note that…"
-- "Keep in mind that…"
-- "As you can see…"
-- "In order to…"
-- "It should be noted that…"
-
-State the information directly instead.
-
-## Put the rule before the explanation
-
-When documenting a requirement or recommendation, state it before explaining why it exists.
-
-**Do:**
-
-> Keep at least 1 pixel of space between unrelated elements. This prevents shapes from visually merging at small sizes.
-
-**Don't:**
-
-> Because shapes can visually merge at small sizes, it's important to make sure that unrelated elements have enough space between them.
-
-This makes documentation easier to scan and makes normative requirements easier to identify.
-
-## Explain the reason when it adds value
-
-Explain *why* a rule exists when the reasoning helps contributors apply it to situations that are not explicitly documented.
-
-Do not merely restate the rule.
-
-**Do:**
-
-> Avoid simulated fills. They don't scale consistently with the rest of the icon set.
-
-**Don't:**
-
-> Avoid simulated fills because simulated fills should not be used.
-
-Reasoning is particularly useful for design rules where contributors may need to evaluate unusual cases.
-
-## Use scannable structure
-
-Assume readers will scan the page before reading it in detail.
-
-Use:
-
-- descriptive headings
-- short paragraphs
-- lists for sets of related items
-- examples for rules that benefit from demonstration
-- **bold** for important terms or short emphasis
-- code formatting for filenames, properties, commands, values, and identifiers
-
-Avoid long uninterrupted blocks of text.
-
-Headings should communicate the subject or rule without requiring the surrounding text for context.
-
-**Do:**
-
-> ## Keep 1 pixel of safe space
-
-**Don't:**
-
-> ## Spacing
-
-## Use sentence case
-
-Use sentence case for:
-
-- page titles
-- headings
-- table headings
-- labels
-- example captions
-
-Capitalize proper nouns and branded terms normally.
-
-**Do:**
-
-> ## Use consistent corner radii
-
-**Don't:**
-
-> ## Use Consistent Corner Radii
-
-## Address the reader directly
-
-Use **you** and **your** when referring to something the reader does.
-
-**Do:**
-
-> If your icon contains overlapping shapes, simplify the hidden geometry.
-
-Avoid referring to the reader as "the user," "the contributor," or other third-person terms when direct language is more natural.
-
-However, prefer an imperative when the subject is obvious.
-
-**Prefer:**
-
-> Keep related elements visually grouped.
-
-**Over:**
-
-> You should keep related elements visually grouped.
-
-## Use "we" only when it means the Lucide project or maintainers
-
-First-person plural is acceptable when describing an intentional project decision, convention, or policy.
-
-**Do:**
-
-> We use `kebab-case` for icon names.
-
-> We generally avoid adding brand logos to Lucide.
-
-Do not use "we" merely to make documentation conversational.
-
-**Prefer:**
-
-> Icons use a 2 pixel stroke.
-
-**Over:**
-
-> We use a 2 pixel stroke for our icons.
-
-## Use normative language consistently
-
-Use specific language to communicate how strictly a rule applies.
-
-- **must** — required; violating this is not acceptable
-- **must not** — prohibited
-- **should** — recommended; exceptions may be appropriate
-- **should not** — discouraged; exceptions may be appropriate
-- **can** — possible or permitted
-- **may** — optional or dependent on context
-
-Do not use **should** when something is actually required.
-
-**Do:**
-
-> Icons must use a 24 × 24 pixel canvas.
-
-**Don't:**
-
-> Icons should use a 24 × 24 pixel canvas.
-
-Avoid vague substitutes such as "ideally," "normally," or "preferably" when a more precise normative term applies.
-
-## Prefer active voice
-
-Use active voice unless passive voice makes the subject clearer or avoids unnecessary repetition.
-
-**Do:**
-
-> Align nodes to the pixel grid.
-
-**Don't:**
-
-> Nodes should be aligned to the pixel grid.
-
-Passive voice is acceptable when the actor is irrelevant.
-
-> Deprecated icons are removed in major releases.
-
-## Use positive instructions when possible
-
-Tell readers what to do rather than only what not to do.
-
-**Do:**
-
-> Use a single continuous path when the elements form one continuous shape.
-
-**Less useful:**
-
-> Don't split continuous shapes into unnecessary paths.
-
-Use negative instructions when the prohibition itself is important.
-
-> Don't use simulated fills.
-
-## Be precise about consequences
-
-When explaining why something should or should not be done, describe the actual consequence rather than using vague warnings.
-
-**Do:**
-
-> Keep unrelated elements at least 2 pixels apart. Smaller gaps can disappear when the icon is rendered at small sizes.
-
-**Don't:**
-
-> Be careful when placing elements too close together.
-
-Avoid language that exaggerates consequences or attempts to influence a contributor's decision emotionally.
-
-## Prefer concrete language
-
-Use specific terms instead of vague references.
-
-**Do:**
-
-> The two endpoints must remain inside the 1 pixel safe zone.
-
-**Don't:**
-
-> These should stay within the appropriate area.
-
-Avoid ambiguous references such as:
-
-- this
-- that
-- it
-- things
-- stuff
-- appropriate
-- proper
-- correct
-
-when the intended subject can be named directly.
-
-## Introduce terminology before relying on it
-
-Define Lucide-specific or technical terms when readers may not already know them.
-
-Once defined, use the same term consistently.
-
-**Do:**
-
-> The **safe zone** is the 1 pixel area between the icon artwork and the canvas boundary.
-
-Do not alternate between different terms for the same concept unless the distinction is intentional.
-
-For example, don't alternate between "safe zone," "padding," and "margin" if they refer to the same rule.
-
-## Use abbreviations sparingly
-
-Spell out uncommon abbreviations on first use.
-
-> Scalable Vector Graphics (SVG)
-
-Common technical abbreviations such as HTML, CSS, SVG, API, and URL do not need to be expanded when the intended audience can reasonably be expected to know them.
-
-Avoid Latin abbreviations such as:
-
-- e.g.
-- i.e.
-- etc.
-
-Prefer:
-
-- for example
-- that is
-- and so on
-
-## Use examples deliberately
-
-Use examples when they clarify how to apply a rule.
-
-Keep examples focused on the rule being demonstrated. Avoid introducing unrelated differences that make the comparison harder to understand.
-
-When contrasting examples, use **Do** and **Don't** consistently.
-
-**Do:**
-
-> Use one path for a continuous outline.
-
-**Don't:**
-
-> Split a continuous outline into several overlapping paths.
-
-The explanatory text should describe the principle, not merely narrate what is visible in the example.
-
-## Use links descriptively
-
-Link text should describe the destination or concept.
-
-**Do:**
-
-> See the [Icon Design Specification](./specification) for exact dimensions and spacing requirements.
-
-**Don't:**
-
-> For more information, [click here](./specification).
-
-Avoid generic link text such as:
-
-- click here
-- here
-- this page
-- learn more
-
-when a descriptive label is possible.
-
-## Avoid unnecessary repetition
-
-Do not repeat information already established by a heading, example, or immediately preceding sentence.
-
-**Prefer:**
-
-> ## Keep 1 pixel of safe space
->
-> Keep all artwork within the 22 × 22 pixel live area.
-
-**Over:**
-
-> ## Keep 1 pixel of safe space
->
-> When designing an icon, you should keep 1 pixel of safe space around the icon.
-
-Cross-reference another section instead of duplicating detailed rules that already have a canonical explanation.
-
-## Use contractions in prose
-
-Use natural contractions such as:
-
-- don't
-- can't
-- isn't
-- it's
-- you'll
-
-They make explanatory prose less formal and easier to scan.
-
-Use uncontracted forms when deliberate emphasis is useful.
-
-> Do not change existing icon geometry solely to reduce the number of SVG nodes.
-
-Normative statements using **must not** should not be contracted.
-
-## Use the serial comma
-
-Use the serial (Oxford) comma in lists of three or more items.
-
-**Do:**
-
-> Check the icon's size, stroke width, and spacing.
-
-**Don't:**
-
-> Check the icon's size, stroke width and spacing.
-
-## Use punctuation normally in prose
-
-Use periods for complete sentences.
-
-Periods may be omitted from:
-
-- headings
-- short labels
-- short list items that are not complete sentences
-- captions consisting only of a short phrase
-
-Be consistent within a list.
-
-If list items are complete sentences, end them with periods. If they are fragments, generally omit periods.
-
-## Skip colons in headings
-
-Do not end headings with colons.
-
-**Do:**
-
-> ## Naming conventions
-
-**Don't:**
-
-> ## Naming conventions:
-
-Use a colon normally when introducing a list or explanation in body text.
-
-## Use exclamation points sparingly
-
-Avoid exclamation points in technical documentation unless the context genuinely calls for excitement or celebration.
-
-**Prefer:**
-
-> Your first icon is ready.
-
-**Over:**
-
-> Your first icon is ready!
-
-Do not use exclamation points to make instructions sound friendlier.
-
-## Use ellipses only when they have meaning
-
-Use an ellipsis (`…`) to represent omitted content or an intentionally incomplete statement.
-
-Do not use ellipses decoratively or to make prose sound conversational.
-
-When documenting literal UI text, preserve the punctuation used by the interface.
-
-## Use parentheses for definitions and compact clarification
-
-Use parentheses when they make a definition, abbreviation, or short clarification easier to understand.
-
-> Scalable Vector Graphics (SVG)
-
-Avoid using parentheses for long side notes. Rewrite important information as part of the sentence or as a separate sentence.
-
-## Prefer "and" over ampersands
-
-Use **and** in normal prose.
-
-**Do:**
-
-> Naming and metadata
-
-**Avoid:**
-
-> Naming & metadata
-
-Use an ampersand only when it is part of an official name, literal UI text, code, or another established term.
-
-## Avoid em dashes
-
-Prefer commas, periods, colons, or parentheses when they produce a simpler sentence.
-
-**Prefer:**
-
-> This rule has one exception: existing legacy icons.
-
-**Avoid:**
-
-> This rule has one exception — existing legacy icons.
-
-Use an en dash (`–`) without surrounding spaces for ranges.
-
-> 1–3 pixels
-
-> A–Z
-
-Do not substitute a hyphen for an en dash in prose ranges unless required by a technical syntax.
-
-## Use hyphens correctly
-
-Hyphenate compound modifiers when necessary for clarity.
-
-> 24 × 24 pixel canvas
-
-> 2-pixel-wide gap
-
-> pixel-aligned element
-
-Do not hyphenate a phrase when it functions as a verb.
-
-> Sign off on the design.
-
-> Complete the sign-off.
-
-Do not add hyphens mechanically when the meaning is already clear.
-
-## Use code formatting consistently
-
-Use backticks for literal technical values and identifiers, including:
-
-- filenames and paths
-- commands
-- package names
-- properties and attributes
-- icon names
-- code values
-- SVG elements and attributes
-
-**Do:**
-
-> Add `camera-off` as an alias.
-
-> Set `stroke-width` to `2`.
-
-> Edit `icons/camera.svg`.
-
-Do not use code formatting merely for emphasis.
-
-## Use bold for semantic emphasis
-
-Use **bold** sparingly to highlight a term or distinction that helps readers scan the page.
-
-Do not bold entire sentences or paragraphs.
-
-Prefer bold over italics for general emphasis.
-
-Use *italics* only when conventional, such as when referring to a term as a term or when a specific distinction benefits from it.
-
-## Don't use all caps for emphasis
-
-Do not use blocks of uppercase text for emphasis.
-
-**Don't:**
-
-> NEVER place nodes outside the canvas.
-
-**Do:**
-
-> **Never** place nodes outside the canvas.
-
-Preserve capitalization when documenting literal identifiers or established technical terms.
-
-## Keep lists parallel
-
-Items in the same list should use the same grammatical structure.
-
-**Do:**
-
-- Use a 24 × 24 pixel canvas
-- Keep 1 pixel of safe space
-- Use a 2 pixel stroke
-- Align nodes to the pixel grid
-
-**Don't:**
-
-- Use a 24 × 24 pixel canvas
-- Safe space should be 1 pixel
-- A 2 pixel stroke
-- Nodes are aligned to the pixel grid
-
-Parallel structure makes rules easier to scan and compare.
-
-## Avoid unnecessary filler and enthusiasm
-
-Lucide documentation should sound helpful and confident, not promotional.
-
-Avoid filler such as:
-
-- "Simply…"
-- "Just…"
-- "Obviously…"
-- "Of course…"
-- "Easy…"
-- "Luckily…"
-- "Don't worry…"
-
-These words can be inaccurate or dismissive when the task is not simple for the reader.
-
-Also avoid marketing language such as:
-
-- "powerful"
-- "seamless"
-- "effortless"
-- "amazing"
-- "best-in-class"
-
-unless the word communicates a specific, verifiable distinction.
-
-## Prefer timeless documentation
-
-Avoid wording tied unnecessarily to the current state of development.
-
-**Prefer:**
-
-> Lucide supports custom icon aliases.
-
-**Avoid:**
-
-> Lucide now supports custom icon aliases.
-
-Use time-sensitive language only when the timing itself matters, such as migration notes, deprecations, or release documentation.
-
-## Preserve established Lucide terminology
-
-When editing existing documentation, preserve established Lucide terminology and naming conventions unless there is a clear reason to change them.
-
-Do not invent synonyms merely to avoid repetition. Consistency is more important than stylistic variety in technical documentation.
-
-When terminology differs between the Lucide codebase, API, UI, and documentation, prefer the term used by the relevant canonical specification.

.github/labeler.yml

@@ -30,11 +30,6 @@
       - any-glob-to-any-file:
           - 'icons/*.svg'
 
-🔬 Lab icon:
-  - changed-files:
-      - any-glob-to-any-file:
-          - 'lab/*.svg'
-
 # For changes in the lucide package
 🧳 lucide package:
   - changed-files:

.github/pull_request_template.md

@@ -47,9 +47,7 @@ Common scopes: icons, docs, studio, site, dev
 
 ### Design <!-- ONLY for new icons -->
 <!-- All of these requirements must be fulfilled. -->
-
 - [ ] I've read and followed the [icon design guidelines](https://lucide.dev/contribute/icon-design-guide)
-- [ ] I've made sure that the icons don't [already exist](https://lucide.dev/icons), including the [Lab directory](https://github.com/lucide-icons/lucide/tree/main/lab).
 - [ ] I've made sure that the icons look sharp on low DPI displays.
 - [ ] I've made sure that the icons look consistent with the icon set in size, optical volume and density.
 - [ ] I've made sure that the icons are visually centered.

.github/workflows/angular.yml

@@ -7,16 +7,13 @@ on:
       - tools/build-icons/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -30,9 +27,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/ci.yml

@@ -23,7 +23,13 @@ on:
           - beta
           - alpha
 
-permissions: {}
+permissions:
+  id-token: write # Required for OIDC
+  contents: write
+
+# This is added to make sure we wait until last release is done, this is needed for the font-build process
+concurrency:
+  group: continuous-integration
 
 jobs:
   check-dispatch-gate:
@@ -31,12 +37,10 @@ jobs:
       startsWith(github.event.head_commit.message, 'feat(icons)') &&
       github.event_name != 'workflow_dispatch'
     runs-on: ubuntu-latest
-    permissions:
-      contents: read
     outputs:
       RELEASE_ENVIRONMENT: ${{ steps.environment.outputs.RELEASE_ENVIRONMENT }}
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/checkout@v6
 
       - name: Fetch tags
         run: git fetch --all --tags
@@ -60,14 +64,12 @@ jobs:
     needs: check-dispatch-gate
     environment: ${{ needs.check-dispatch-gate.outputs.RELEASE_ENVIRONMENT }}
     runs-on: ubuntu-latest
-    permissions:
-      contents: write # Required to create the release and tag
     outputs:
       VERSION: ${{ steps.new-version.outputs.NEW_VERSION }}
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -102,7 +104,7 @@ jobs:
           echo '${{ steps.change-log.outputs.CHANGE_LOG }}'
 
       - name: Create Release
-        uses: softprops/action-gh-release@efb35369e0ad2afab669f228072c1b0d510eae64 # v3.0.3
+        uses: softprops/action-gh-release@v1
         with:
           tag_name: ${{ steps.new-version.outputs.NEW_VERSION }}
           name: Version ${{ steps.new-version.outputs.NEW_VERSION }}
@@ -113,19 +115,13 @@ jobs:
     needs: create-release
     uses: './.github/workflows/release.yml'
     secrets: inherit
-    permissions:
-      id-token: write # Required for OIDC (npm provenance)
-      contents: write # Required to upload release assets
     with:
       version: ${{ needs.create-release.outputs.VERSION }}
 
   dispatch-release:
-    if: github.repository == 'lucide-icons/lucide' && github.event_name == 'workflow_dispatch'
+    if: github.event_name == 'workflow_dispatch'
     uses: './.github/workflows/release.yml'
     secrets: inherit
-    permissions:
-      id-token: write # Required for OIDC (npm provenance)
-      contents: write # Required to upload release assets
     with:
       version: ${{ inputs.version }}
       tag: ${{ inputs.tag }}

.github/workflows/close-issue-with-banned-phrases.yml

@@ -3,28 +3,18 @@ name: Close Icon Requests with Brand Terms
 on:
   issues:
     types: [opened]
-  discussion:
-    types: [created]
-
-permissions: {}
-
-env:
-  GH_TOKEN: ${{ github.token }}
 
 jobs:
   block_phrases:
-    if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
     permissions:
-      contents: read
       issues: write
-      discussions: write
     steps:
       - name: Checkout repository
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        uses: actions/checkout@v6
 
       - name: Load stopwords from JSON & check issue title & body
-        if: github.event_name == 'issues' && contains(github.event.issue.labels.*.name, '🙌 icon request')
+        if: contains(github.event.issue.labels.*.name, '🙌 icon request')
         run: |
           ISSUE_TITLE=$(jq -r '.issue.title' "$GITHUB_EVENT_PATH")
           ISSUE_BODY=$(jq -r '.issue.body // ""' "$GITHUB_EVENT_PATH")
@@ -37,8 +27,6 @@ jobs:
             if echo "$ISSUE_TITLE" | grep -iqE "$SAFE_KEY|$SAFE_VALUE" || \
               { [ -n "$ICON_NAME_SECTION" ] && echo "$ICON_NAME_SECTION" | grep -iqE "$SAFE_KEY|$SAFE_VALUE"; }; then
 
-              URL_ENCODED_VALUE=$(jq -rn --arg val "$VALUE" '$val|@uri')
-
               gh issue close ${{ github.event.issue.number }} \
                 --reason "not planned" \
                 --comment "It looks like this request is about **${VALUE}**, which is a brand logo.
@@ -47,7 +35,7 @@ jobs:
 
           [Click here to read our official statement about brand logos in Lucide.](https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md)
 
-          You can [search for similar issues.](https://github.com/lucide-icons/lucide/issues?q=is%3Aissue+${URL_ENCODED_VALUE})
+          You can [search for similar issues.](https://github.com/lucide-icons/lucide/issues?q=is%3Aissue+${VALUE})
 
           We’re always happy to help on [Discord](https://discord.gg/EH6nSts)."
 
@@ -56,55 +44,5 @@ jobs:
             fi
           done
 
-      - name: Load stopwords from JSON & check discussion title & body
-        if: github.event_name == 'discussion' && github.event.discussion.category.slug == 'icon-design'
-        run: |
-          DISCUSSION_TITLE=$(jq -r '.discussion.title' "$GITHUB_EVENT_PATH")
-          DISCUSSION_BODY=$(jq -r '.discussion.body // ""' "$GITHUB_EVENT_PATH")
-          ICON_NAME_SECTION=$(printf '%s\n' "$DISCUSSION_BODY" | awk '/### Icon name/{flag=1; next} /^### /{flag=0} flag')
-
-          jq -r 'to_entries[] | "\(.key) \(.value)"' brand-stopwords.json | while read -r KEY VALUE; do
-            SAFE_KEY=$(printf '%s\n' "$KEY" | sed 's/[][\.^$*]/\\&/g')
-            SAFE_VALUE=$(printf '%s\n' "$VALUE" | sed 's/[][\.^$*]/\\&/g')
-
-            if echo "$DISCUSSION_TITLE" | grep -iqE "$SAFE_KEY|$SAFE_VALUE" || \
-              { [ -n "$ICON_NAME_SECTION" ] && echo "$ICON_NAME_SECTION" | grep -iqE "$SAFE_KEY|$SAFE_VALUE"; }; then
-
-              URL_ENCODED_VALUE=$(jq -rn --arg val "$VALUE" '$val|@uri')
-              DISCUSSION_NODE_ID=$(jq -r '.discussion.node_id' "$GITHUB_EVENT_PATH")
-              COMMENT_BODY="It looks like this request is about **${VALUE}**, which is a brand logo.
-
-          Lucide **does not accept** brand logos, and we do not plan to add them in the future. This is due to a combination of **legal restrictions**, **design consistency concerns**, and **practical maintenance reasons**.
-
-          [Click here to read our official statement about brand logos in Lucide.](https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md)
-
-          You can [search for similar discussions.](https://github.com/lucide-icons/lucide/discussions/categories/icon-design?discussions_q=category%253A%22Icon+design%22+${URL_ENCODED_VALUE})
-
-          We’re always happy to help on [Discord](https://discord.gg/EH6nSts)."
-
-              # Add comment to discussion
-              gh api graphql -f query='
-                mutation($discussionId: ID!, $body: String!) {
-                  addDiscussionComment(input: {discussionId: $discussionId, body: $body}) {
-                    comment { id }
-                  }
-                }' -f discussionId="$DISCUSSION_NODE_ID" -f body="$COMMENT_BODY"
-
-              # Close discussion
-              gh api graphql -f query='
-                mutation($discussionId: ID!) {
-                  closeDiscussion(input: {discussionId: $discussionId}) {
-                    discussion { closed }
-                  }
-                }' -f discussionId="$DISCUSSION_NODE_ID"
-
-              # Lock discussion
-              gh api graphql -f query='
-                mutation($lockableId: ID!, $reason: LockReason) {
-                  lockLockable(input: {lockableId: $lockableId, lockReason: $reason}) {
-                    lockedRecord { locked }
-                  }
-                }' -f lockableId="$DISCUSSION_NODE_ID" -f reason="SPAM"
-              exit 0
-            fi
-          done
+env:
+  GH_TOKEN: ${{ github.token }}

.github/workflows/close-stale-prs.yml

@@ -3,16 +3,13 @@ on:
   schedule:
     - cron: '45 1 * * *'
 
-permissions: {}
-
 jobs:
   stale:
-    if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
     permissions:
       pull-requests: write
     steps:
-      - uses: actions/stale@4391f3da665fdf50b6810c1a66712fb9ba21aa93 # v11.0.0
+      - uses: actions/stale@v9
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           stale-pr-message: This PR is stale because it has been open 45 days with no activity. Remove stale label or comment or this will be closed in 5 days.

.github/workflows/comment-icon-preview.yml

@@ -6,22 +6,15 @@ on:
     types:
       - completed
 
-permissions: {}
-
 jobs:
   upload:
     runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      actions: read # Required to download the artifact from the triggering run
-      pull-requests: write
     if: >
-      github.repository == 'lucide-icons/lucide' &&
       github.event.workflow_run.event == 'pull_request' &&
       github.event.workflow_run.conclusion == 'success'
     steps:
       - name: 'Download artifact'
-        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+        uses: actions/github-script@v7
         with:
           script: |
             let allArtifacts = await github.rest.actions.listWorkflowRunArtifacts({
@@ -49,7 +42,7 @@ jobs:
         id: pr-number
 
       - name: Find Comment
-        uses: peter-evans/find-comment@b30e6a3c0ed37e7c023ccd3f1db5c6c0b0c23aad # v4.0.0
+        uses: peter-evans/find-comment@v2
         id: pr-comment
         with:
           issue-number: ${{ steps.pr-number.outputs.number }}
@@ -57,7 +50,7 @@ jobs:
           body-includes: Added or changed icons
 
       - name: Create or update comment
-        uses: peter-evans/create-or-update-comment@e8674b075228eee787fea43ef493e45ece1004c9 # v5.0.0
+        uses: peter-evans/create-or-update-comment@v3
         with:
           comment-id: ${{ steps.pr-comment.outputs.comment-id }}
           issue-number: ${{ steps.pr-number.outputs.number }}

.github/workflows/icons.yml

@@ -9,16 +9,13 @@ on:
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -32,9 +29,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/labeler.yml

@@ -2,15 +2,12 @@ name: 'Pull Request Labeler'
 on:
   - pull_request_target
 
-permissions: {}
-
 jobs:
   triage:
-    if: github.repository == 'lucide-icons/lucide'
     permissions:
       contents: read
       pull-requests: write
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: actions/labeler@bf12e9b00b37c5c0ca2b87b79b2daf7891dbda13 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: actions/labeler@v5

.github/workflows/lint-code.yml

@@ -1,18 +1,17 @@
-name: Linting PR code
+name: Linting PR
 
 on:
   pull_request:
-
-permissions:
-  contents: read
+    paths-ignore:
+      - icons/*.svg
 
 jobs:
   lint-code:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lint-pr-title.yml

@@ -1,4 +1,4 @@
-name: Linting PR title
+name: Linting PR
 
 on:
   pull_request:
@@ -7,16 +7,12 @@ on:
       - edited
       - reopened
 
-permissions:
-  contents: read
-  pull-requests: read # Required to read the PR title
-
 jobs:
   lint-pr-title:
     name: PR Title Lint
     runs-on: ubuntu-latest
     steps:
-      - uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
+      - uses: amannn/action-semantic-pull-request@v5
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:

.github/workflows/linting-icons.yml

@@ -7,9 +7,6 @@ on:
   pull_request:
     paths:
       - 'icons/*'
-      - 'lab/*'
-
-permissions: {}
 
 jobs:
   lint-filenames:
@@ -19,54 +16,27 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
-          cache: 'pnpm'
           node-version-file: 'package.json'
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
       - name: Get changed files
         id: changed-files
-        uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6
+        uses: tj-actions/changed-files@v46
         with:
-          files: |
-            icons/*
-            lab/*
+          files: icons/*
 
       - name: Generate annotations
         run: node ./scripts/lintFilenames.mts
         env:
           CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
 
-  check-lab-icons:
-    name: Check Lab Icons
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
-        with:
-          cache: 'pnpm'
-          node-version-file: 'package.json'
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Check lab icons do not already exist in icons
-        run: node ./scripts/checkLabIcons.mts
-
   lint-aliases:
     name: Check Uniqueness of Aliases
     runs-on: ubuntu-latest
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/checkout@v6
       - name: Check Uniqueness of Aliases
         run: "! cat <(printf \"%s\\n\" icons/*.json | while read -r name; do basename \"$name\" .json; done) <(jq -cr 'select(.aliases) | .aliases[] | if type==\"string\" then . else .name end' icons/*.json) | sort | uniq -c | grep -ve '^\\s*1 '"

.github/workflows/lucide-astro.yml

@@ -11,16 +11,13 @@ on:
       - tools/build-icons/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v2
+      - uses: actions/setup-node@v6
         with:
           node-version-file: 'package.json'
           cache: 'pnpm'
@@ -34,9 +31,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v3
+      - uses: pnpm/action-setup@v2
+      - uses: actions/setup-node@v3.8.1
         with:
           node-version-file: 'package.json'
           cache: 'pnpm'

.github/workflows/lucide-font.yml

@@ -9,16 +9,13 @@ on:
       - tools/build-font/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   lucide-font:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -33,7 +30,7 @@ jobs:
         run: pnpm build:font
 
       - name: 'Upload to Artifacts'
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@v4
         with:
           name: lucide-font
           path: lucide-font

.github/workflows/lucide-lab.yml

@@ -1,31 +0,0 @@
-name: Lucide Lab checks
-
-on:
-  pull_request:
-    paths:
-      - lab/**
-      - packages/lab/**
-      - packages/shared/**
-      - tools/build-icons/**
-      - tools/rollup-plugins/**
-      - pnpm-lock.yaml
-
-permissions:
-  contents: read
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
-        with:
-          cache: 'pnpm'
-          node-version-file: 'package.json'
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Build
-        run: pnpm --filter @lucide/lab build

.github/workflows/lucide-preact.yml

@@ -12,16 +12,13 @@ on:
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   lucide-preact:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-react-native.yml

@@ -12,16 +12,13 @@ on:
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -35,9 +32,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-react.yml

@@ -7,25 +7,19 @@ on:
   pull_request:
     paths:
       - packages/lucide-react/**
-      - integrations/lucide-react/**
       - packages/shared/**
       - tools/build-icons/**
       - tools/rollup-plugins/**
       - scripts/generateNextJSAliases.mjs
-      - package.json
-      - pnpm-workspace.yaml
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -39,9 +33,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -51,22 +45,3 @@ jobs:
 
       - name: Test
         run: pnpm --filter lucide-react test
-
-  integration:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
-        with:
-          cache: 'pnpm'
-          node-version-file: 'package.json'
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Install Chromium
-        run: pnpm --filter @lucide/integration-react-vite exec playwright install --with-deps chromium
-
-      - name: Run integration checks
-        run: pnpm test:integrations:react

.github/workflows/lucide-shared.yml

@@ -9,16 +9,13 @@ on:
       - packages/shared/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-solid.yml

@@ -12,16 +12,13 @@ on:
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -35,9 +32,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-static.yml

@@ -7,16 +7,13 @@ on:
       - tools/build-icons/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   lucide-static:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-svelte-5.yml

@@ -12,16 +12,13 @@ on:
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -35,9 +32,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -51,9 +48,9 @@ jobs:
   typecheck:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-vue.yml

@@ -6,22 +6,19 @@ on:
       - next
   pull_request:
     paths:
-      - packages/vue/**
+      - packages/lucide-vue/**
       - packages/shared/**
       - tools/build-icons/**
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -35,9 +32,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide.yml

@@ -11,16 +11,13 @@ on:
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -34,9 +31,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/pull-request-icon-preview.yml

@@ -5,30 +5,27 @@ on:
     paths:
       - 'icons/*.svg'
 
-permissions: {}
-
 jobs:
   generate-changed-icons-comment:
     name: Generate Changed Icons Comment
-    if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
     permissions:
       contents: read
       pull-requests: write
 
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version-file: 'package.json'
 
       - name: Get changed files
         id: changed-files
-        uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6
+        uses: tj-actions/changed-files@v46
         with:
           files: icons/*.svg
 
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/setup-node@v6
       - name: Install svgson for code preview (safer and faster than installing all deps)
         run: npm install svgson@5.3.1 --force
 
@@ -43,7 +40,7 @@ jobs:
         env:
           CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
 
-      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+      - uses: actions/upload-artifact@v4
         with:
           name: pr_number
           path: pr/

.github/workflows/pull-request-metadata-suggestions.yml

@@ -5,12 +5,9 @@ on:
     paths:
       - 'icons/*.json'
 
-permissions: {}
-
 jobs:
   pull-request-metadata-suggestions:
     name: Pull Request Metadata Suggestions
-    if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -19,11 +16,11 @@ jobs:
     steps:
       #  We checkout the main branch of main repository for security reasons.
       #  This is to prevent the workflow from running on a forked repository.
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/checkout@v6
         with:
           repository: lucide-icons/lucide
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/release-lab.yml

@@ -1,146 +0,0 @@
-name: Release @lucide/lab
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - lab/**/*.svg
-
-  workflow_dispatch:
-    inputs:
-      release-type:
-        description: Release type
-        required: true
-        default: 'minor'
-        type: choice
-        options:
-          - patch
-          - minor
-          - major
-
-permissions: {}
-
-jobs:
-  create-release:
-    if: github.repository == 'lucide-icons/lucide'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write # Required to create the release and tag
-    outputs:
-      VERSION: ${{ steps.new-version.outputs.NEW_VERSION }}
-      SHOULD_RELEASE: ${{ steps.release-notes.outputs.SHOULD_RELEASE }}
-    steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-        with:
-          fetch-depth: 0 # Required to diff the lab icons against the previous tag
-
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
-        with:
-          cache: 'pnpm'
-          node-version-file: 'package.json'
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Get latest tag
-        id: latest-tag
-        run: |
-          LATEST_TAG=$(git tag --list '@lucide/lab@*' --sort=-v:refname | head -n 1)
-
-          if [ -z "$LATEST_TAG" ]; then
-            echo "::error::No @lucide/lab@* tag found to release from."
-            exit 1
-          fi
-
-          echo "Latest tag: $LATEST_TAG"
-          echo "LATEST_TAG=$LATEST_TAG" >> $GITHUB_OUTPUT
-
-      - name: Create new version
-        id: new-version
-        run: |
-          NEW_VERSION=$(pnpm semver "${LATEST_TAG#@lucide/lab@}" -i "$RELEASE_TYPE")
-
-          echo "New version: $NEW_VERSION"
-          echo "NEW_VERSION=$NEW_VERSION" >> $GITHUB_OUTPUT
-        env:
-          LATEST_TAG: ${{ steps.latest-tag.outputs.LATEST_TAG }}
-          RELEASE_TYPE: ${{ inputs.release-type || 'minor' }}
-
-      - name: Generate release notes
-        id: release-notes
-        run: |
-          NEW_TAG="@lucide/lab@$NEW_VERSION"
-
-          ADDED=$(git diff --name-only --diff-filter=A "$LATEST_TAG" HEAD -- 'lab/*.svg' \
-            | xargs -r -n1 basename | sed 's/\.svg$//' | sort)
-          REMOVED=$(git diff --name-only --diff-filter=D "$LATEST_TAG" HEAD -- 'lab/*.svg' \
-            | xargs -r -n1 basename | sed 's/\.svg$//' | sort)
-
-          if [ -z "$ADDED" ] && [ "$EVENT_NAME" != 'workflow_dispatch' ]; then
-            echo "::notice::No icons were added to ./lab since $LATEST_TAG, skipping release."
-            echo "SHOULD_RELEASE=false" >> $GITHUB_OUTPUT
-            exit 0
-          fi
-
-          {
-            if [ -n "$ADDED" ]; then
-              printf '## New icons\n\n'
-              printf '%s\n' "$ADDED" | sed 's|.*|- `&`|'
-              printf '\n'
-            fi
-
-            if [ -n "$REMOVED" ]; then
-              printf '## Removed icons\n\nThese graduated to the core icon set.\n\n'
-              printf '%s\n' "$REMOVED" | sed 's|.*|- `&`|'
-              printf '\n'
-            fi
-
-            printf '**Full changelog**: https://github.com/lucide-icons/lucide/compare/%s...%s\n' "$LATEST_TAG" "$NEW_TAG"
-          } > lab-release-notes.md
-
-          cat lab-release-notes.md
-          echo "SHOULD_RELEASE=true" >> $GITHUB_OUTPUT
-        env:
-          LATEST_TAG: ${{ steps.latest-tag.outputs.LATEST_TAG }}
-          NEW_VERSION: ${{ steps.new-version.outputs.NEW_VERSION }}
-          EVENT_NAME: ${{ github.event_name }}
-
-      - name: Create Release
-        if: steps.release-notes.outputs.SHOULD_RELEASE == 'true'
-        uses: softprops/action-gh-release@efb35369e0ad2afab669f228072c1b0d510eae64 # v3.0.3
-        with:
-          tag_name: '@lucide/lab@${{ steps.new-version.outputs.NEW_VERSION }}'
-          name: '@lucide/lab@${{ steps.new-version.outputs.NEW_VERSION }}'
-          body_path: lab-release-notes.md
-          make_latest: 'false' # Never displace the core icon release as "Latest"
-
-  publish:
-    if: github.repository == 'lucide-icons/lucide' && needs.create-release.outputs.SHOULD_RELEASE == 'true'
-    runs-on: ubuntu-latest
-    needs: create-release
-    permissions:
-      id-token: write # Required for OIDC (npm provenance)
-      contents: read
-    steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
-        with:
-          cache: 'pnpm'
-          node-version-file: 'package.json'
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Set new version
-        run: pnpm version ${{ needs.create-release.outputs.VERSION }} --filter @lucide/lab --fail-if-no-match --no-git-tag-version
-
-      - name: Build
-        run: pnpm --filter @lucide/lab build
-
-      - name: Publish
-        run: pnpm --filter @lucide/lab publish --access public --no-git-checks --ignore-scripts --tag latest
-        env:
-          NPM_CONFIG_PROVENANCE: true

.github/workflows/release.yml

@@ -16,7 +16,9 @@ on:
         default: 'latest'
         type: string
 
-permissions: {}
+permissions:
+  id-token: write # Required for OIDC
+  contents: write
 
 jobs:
   prepare:
@@ -24,6 +26,7 @@ jobs:
     runs-on: ubuntu-latest
     outputs:
       VERSION: ${{ steps.get_version.outputs.VERSION }}
+
     steps:
       - name: Get the version
         id: get_version
@@ -57,9 +60,9 @@ jobs:
             '@lucide/vue',
           ]
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -90,14 +93,10 @@ jobs:
       contents: read
 
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          name: lucide-font
-          path: lucide-font
-
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: actions/download-artifact@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -123,12 +122,10 @@ jobs:
     if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
     needs: prepare
-    permissions:
-      contents: read
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: pnpm/action-setup@0977fd99725f1db4007ccb2928dbb4e90d06cc86 # v6.0.10
-      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -145,7 +142,7 @@ jobs:
           BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
 
       - name: 'Upload to Artifacts'
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        uses: actions/upload-artifact@v4
         with:
           name: lucide-font
           path: lucide-font
@@ -155,21 +152,18 @@ jobs:
     runs-on: ubuntu-latest
     needs: [prepare, lucide-font]
     permissions:
-      contents: write # Required to upload the release assets
+      id-token: write # Required for OIDC
+      contents: write
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          name: lucide-font
-          path: lucide-font
-
+      - uses: actions/checkout@v6
+      - uses: actions/download-artifact@v4
       - name: Zip font and icons
         run: |
           zip -r lucide-font-${{ needs.prepare.outputs.VERSION }}.zip lucide-font
           zip -r lucide-icons-${{ needs.prepare.outputs.VERSION }}.zip icons
 
       - name: Release zip and fonts
-        uses: softprops/action-gh-release@efb35369e0ad2afab669f228072c1b0d510eae64 # v3.0.3
+        uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ needs.prepare.outputs.VERSION }}
 

.github/workflows/repo-journal.yml

@@ -4,17 +4,14 @@ on:
   # Run this workflow every Monday at 07:00 UTC
   schedule:
     - cron: '0 7 * * 1'
-
 permissions:
   contents: read
-
 jobs:
   weekly-summary:
-    if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
     steps:
       - name: Set up Node.js environment
-        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        uses: actions/setup-node@v4
         with:
           node-version: 24
 

.github/workflows/request-review.yml

@@ -1,27 +1,25 @@
-name: Request Review
+name: 'Request Review'
 on:
-  pull_request:
+  pull_request_target:
     types: [opened]
     paths:
       - icons/*.svg
 
-permissions: {}
-
 jobs:
   request-review:
-    if: github.repository == 'lucide-icons/lucide' && github.event.pull_request.draft == false
+    if: github.event.pull_request.draft == false
     runs-on: ubuntu-latest
     permissions:
       contents: read
       pull-requests: write
     steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
           ref: refs/pull/${{ github.event.pull_request.number }}/merge
       - name: Get changed files
         id: changed-files
-        uses: tj-actions/changed-files@9426d40962ed5378910ee2e21d5f8c6fcbf2dd96 # v47.0.6
+        uses: tj-actions/changed-files@v41
         with:
           files: icons/*.svg
       - run: |

.gitignore

@@ -3,10 +3,9 @@
 .next
 .obsidian
 .now
-.cache
+.idea
 .env
 node_modules
-.pnpm-store
 dist
 build
 sandbox
@@ -14,10 +13,6 @@ stash
 coverage
 stats
 *.log
-*.tsbuildinfo
-integrations/**/.react-router
-integrations/**/.vitest-attachments
-integrations/**/__screenshots__
 outlined
 lucide-font
 packages/**/src/icons/*.js
@@ -28,9 +23,6 @@ packages/**/src/aliases.ts
 !packages/**/src/aliases/index.ts
 packages/**/src/utils/*.ts
 !packages/shared/src/utils/*.ts
-!packages/shared/src/build/
-!packages/shared/src/build/*.ts
-packages/shared/src/build/types.d.ts
 packages/**/src/dynamicIconImports.ts
 packages/**/DynamicIcon.d.ts
 packages/**/dynamicIconImports.js
@@ -62,10 +54,8 @@ docs/.vitepress/data/iconDetails
 docs/.vitepress/data/relatedIcons.json
 docs/.vitepress/data/brandStopwords.json
 docs/.vitepress/data/iconPopularity
-docs/.vitepress/data/lab/iconNodes
-docs/.vitepress/data/lab/iconMetaData.ts
-docs/.vitepress/data/lab/iconPopularity
 docs/.vercel
 docs/.nitro
 docs/public/og/**
 !docs/public/og/general.png
+.gitignore

.prettierignore

@@ -19,13 +19,6 @@ packages/lucide-static/icon-nodes.json
 packages/lucide-static/font
 packages/svelte/.svelte-kit
 
-# integration test artifacts and generated routes
-integrations/**/.react-router
-integrations/**/next-env.d.ts
-integrations/**/routeTree.gen.ts
-integrations/**/.vitest-attachments
-integrations/**/__screenshots__
-
 # lucide-svelte
 packages/svelte/src/icons/*.svelte
 packages/svelte/.svelte-kit

.vscode/settings.json

@@ -1,5 +1,5 @@
 {
-  "cSpell.words": ["devs", "linecap", "linejoin", "preact", "Preact"],
+  "cSpell.words": ["devs", "preact", "Preact"],
   "eslint.enable": true,
   "eslint.validate": ["javascript", "svg"],
   "svg.preview.background": "editor"

CONTRIBUTING.md

@@ -30,7 +30,7 @@ Read it here: [ICON_GUIDELINES](https://lucide.dev/contribute/icon-design-guide)
 
 #### Lucide Studio
 
-For formatting and adjusting SVG icons, [@jguddas](https://github.com/jguddas) made a great tool called [Lucide Studio](https://studio.lucide.dev/?utm_source=lucide.dev&utm_medium=contributing-guide). It is a web-based SVG editor that allows you to edit and adjust icons in the Lucide style. You can use it to create new icons or modify existing ones.
+For formatting and adjusting SVG icons, [@jguddas](https://github.com/jguddas) made a great tool called [Lucide Studio](https://studio.lucide.dev/). It is a web-based SVG editor that allows you to edit and adjust icons in the Lucide style. You can use it to create new icons or modify existing ones.
 
 #### Editor guides
 

brand-stopwords.json

@@ -56,6 +56,7 @@
   "kubernetes": "Kubernetes",
   "leetcode": "LeetCode",
   "leet-code": "LeetCode",
+  "line": "LINE",
   "linkedin": "LinkedIn",
   "lua": "Lua",
   "mariadb": "MariaDB",
@@ -68,7 +69,7 @@
   "nestjs": "NestJS",
   "netflix": "Netflix",
   "netlify": "Netlify",
-  "nextjs": "Next.js",
+  "next": "Next.js",
   "nodejs": "Node.js",
   "notion": "Notion",
   "nostr": "Nostr",
@@ -104,8 +105,7 @@
   "shopify": "Shopify",
   "skype": "Skype",
   "slack": "Slack",
-  "snapchat": "Snapchat",
-  "solidjs": "SolidJS",
+  "solid": "SolidJS",
   "soundcloud": "SoundCloud",
   "spotify": "Spotify",
   "sqlite": "SQLite",
@@ -144,5 +144,6 @@
   "xbox": "Xbox",
   "yarn": "Yarn",
   "youtube": "YouTube",
-  "zig": "Zig"
+  "zig": "Zig",
+  "zoom": "Zoom"
 }

categories/emoji.json

@@ -1,5 +1,5 @@
 {
   "$schema": "../category.schema.json",
   "title": "Emoji",
-  "icon": "face-slightly-smiling"
+  "icon": "smile"
 }

docs/.vitepress/api/lab/icon-details/index.get.ts

@@ -1,25 +0,0 @@
-import { eventHandler, setResponseHeader } from 'h3';
-import iconMetaData from '../../../data/lab/iconMetaData';
-import iconPopularity from '../../../data/lab/iconPopularity';
-import iconNodes from '../../../data/lab/iconNodes';
-
-export default eventHandler((event) => {
-  setResponseHeader(event, 'Access-Control-Allow-Origin', '*');
-
-  return Object.fromEntries(
-    Object.entries(iconMetaData).map(([iconName, iconData]) => {
-      // Remove $schema from the response
-      delete iconData['$schema'];
-
-      return [
-        iconName,
-        {
-          name: iconName,
-          iconNode: iconNodes[iconName],
-          popularity: iconPopularity[iconName]?.count ?? 0,
-          ...iconData,
-        },
-      ];
-    }),
-  );
-});

docs/.vitepress/api/lab/icon-metadata/index.get.ts

@@ -1,14 +0,0 @@
-import { eventHandler, setResponseHeader } from 'h3';
-import iconMetaData from '../../../data/lab/iconMetaData';
-
-export default eventHandler((event) => {
-  setResponseHeader(event, 'Cache-Control', 'public, max-age=86400');
-  setResponseHeader(event, 'Access-Control-Allow-Origin', '*');
-
-  for (const iconDetail in iconMetaData) {
-    // Remove $schema from the response
-    delete iconMetaData[iconDetail]['$schema'];
-  }
-
-  return iconMetaData;
-});

docs/.vitepress/api/lab/icon-nodes/index.get.ts

@@ -1,30 +0,0 @@
-import { eventHandler, getQuery, setResponseHeader } from 'h3';
-import iconNodes from '../../../data/lab/iconNodes';
-type IconNodeWithKeys = [elementName: string, attrs: Record<string, string> & { key?: string }][];
-
-export default eventHandler((event) => {
-  const query = getQuery(event);
-
-  const withUniqueKeys = query.withUniqueKeys === 'true';
-
-  setResponseHeader(event, 'Cache-Control', 'public, max-age=86400');
-  setResponseHeader(event, 'Access-Control-Allow-Origin', '*');
-
-  if (withUniqueKeys) {
-    return iconNodes;
-  }
-
-  return Object.entries(iconNodes).reduce((acc, [name, iconNode]) => {
-    if (withUniqueKeys) {
-      return [name, iconNode];
-    }
-
-    const newIconNode = (iconNode as IconNodeWithKeys).map(([name, { key, ...attrs }]) => {
-      return [name, attrs];
-    });
-
-    acc[name] = newIconNode;
-
-    return acc;
-  }, {});
-});

docs/.vitepress/config.ts

@@ -4,7 +4,6 @@ import { groupIconMdPlugin, groupIconVitePlugin } from 'vitepress-plugin-group-i
 import sidebar from './sidebar';
 import snackPlayer from './markdown/snackPlayer';
 import sandpackPlugin from './markdown/sandpack';
-import examplePlugin from './markdown/example';
 import { readFile } from 'node:fs/promises';
 import { resourcesSidebar } from './sidebar/resources';
 import llmstxt from 'vitepress-plugin-llms';
@@ -32,7 +31,6 @@ export default defineConfig({
     config(md) {
       md.use(groupIconMdPlugin);
       md.use(snackPlayer);
-      md.use(examplePlugin);
       md.use(sandpackPlugin, {
         defaultFiles: {
           '/styles.css': {
@@ -98,7 +96,7 @@ export default defineConfig({
         text: 'Resources',
         items: [
           ...resourcesSidebar[0].items,
-          { text: 'Contributing icons', link: '/contribute/icons/' },
+          { text: 'Design icons', link: '/contribute/icon-design-guide' },
         ],
       },
       { text: 'Packages', link: '/packages' },

docs/.vitepress/data/companiesData.json

@@ -46,5 +46,21 @@
       "light": "/company-logos/open-collective-light.svg",
       "dark": "/company-logos/open-collective-dark.svg"
     }
+  },
+  {
+    "name": "Super",
+    "url": "https://super.so",
+    "image": {
+      "light": "/company-logos/super-light.svg",
+      "dark": "/company-logos/super-dark.svg"
+    }
+  },
+  {
+    "name": "Noodle",
+    "url": "https://noodle.run/",
+    "image": {
+      "light": "/company-logos/noodle-light.svg",
+      "dark": "/company-logos/noodle-dark.svg"
+    }
   }
 ]

docs/.vitepress/lib/SvgPreview/Backdrop.tsx

@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { Fragment } from 'react';
 
 interface BackdropProps {
   src: string;

docs/.vitepress/lib/SvgPreview/GapViolationHighlight.tsx

@@ -3,6 +3,7 @@ import pathToPoints from './path-to-points';
 import { Path, PathProps } from './types';
 
 export const GapViolationHighlight = ({
+  radius,
   stroke,
   strokeWidth,
   strokeOpacity,

docs/.vitepress/lib/SvgPreview/index.tsx

@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { Fragment } from 'react';
 import { PathProps, Path } from './types';
 import getPaths, { assert } from './utils';
 import { GapViolationHighlight } from './GapViolationHighlight.tsx';
@@ -293,7 +293,7 @@ const Radii = ({
   ...props
 }: { paths: Path[] } & PathProps<
   'strokeWidth' | 'stroke' | 'strokeDasharray' | 'strokeOpacity',
-  never
+  any
 >) => {
   return (
     <g
@@ -361,12 +361,12 @@ const Radii = ({
 const Handles = ({
   paths,
   ...props
-}: { paths: Path[] } & PathProps<'strokeWidth' | 'stroke' | 'strokeOpacity', never>) => (
+}: { paths: Path[] } & PathProps<'strokeWidth' | 'stroke' | 'strokeOpacity', any>) => (
   <g
     className="svg-preview-handles-group"
     {...props}
   >
-    {paths.map(({ prev, next, cp1, cp2 }, i) => (
+    {paths.map(({ c, prev, next, cp1, cp2 }, i) => (
       <React.Fragment key={i}>
         {cp1 && <path d={`M${prev.x} ${prev.y} ${cp1.x} ${cp1.y}`} />}
         {cp1 && (

docs/.vitepress/lib/SvgPreview/path-to-points.ts

@@ -12,9 +12,7 @@ function pathToPoints({ d, prev, next }: Path, interval = 1) {
       points.push(commander.getPointAtLength(i));
     }
     points.push(next);
-  } catch (err) {
-    console.warn(`Failed to convert path to points for d="${d}": ${err}`);
-  }
+  } catch (err) {}
   return points;
 }
 

docs/.vitepress/lib/SvgPreview/utils.ts

@@ -55,7 +55,7 @@ export const getCommands = (src: string) =>
     .flatMap(({ d, name }, idx) =>
       new SVGPathData(d)
         .toAbs()
-        // @ts-expect-error `commands` is typed as a union of command types svgson does not narrow
+        // @ts-ignore
         .commands.map((c, cIdx) => ({ ...c, id: idx, idx: cIdx, name })),
     );
 
@@ -242,7 +242,7 @@ const getPaths = (src: string) => {
         break;
       }
       default: {
-        // @ts-expect-error every command type is handled above, so `c` is not `never` here
+        // @ts-ignore
         assertNever(c);
       }
     }

docs/.vitepress/lib/codeExamples/createCodeExamples.ts

@@ -13,11 +13,11 @@ const getIconCodes = (): CodeExampleType => {
       title: 'Vanilla',
       code: `\
 <script>
-import { createIcons, $PascalCase } from 'lucide';
+import { createIcons, $CamelCase } from 'lucide';
 
 createIcons({
   icons: {
-    $PascalCase
+    $CamelCase
   }
 });
 </script>

docs/.vitepress/lib/helpers.ts

@@ -9,9 +9,11 @@ export const hash = (string: string, seed = 5381) => {
   let i = string.length;
 
   while (i) {
+    // eslint-disable-next-line no-bitwise, no-plusplus
     seed = (seed * 33) ^ string.charCodeAt(--i);
   }
 
+  // eslint-disable-next-line no-bitwise
   return (seed >>> 0).toString(36).substr(0, 6);
 };
 

docs/.vitepress/markdown/example.ts

@@ -1,204 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { dirname, isAbsolute, resolve } from 'node:path';
-import type MarkdownIt from 'markdown-it';
-import type { RenderRule } from 'markdown-it/lib/renderer.mjs';
-import container from 'markdown-it-container';
-
-type ContainerArgs = [typeof container, string, { render: RenderRule }];
-
-const parseInfo = (info: string, marker: string) => info.trim().slice(marker.length).trim();
-
-const stripWrappingQuotes = (value: string) => {
-  const quote = value[0];
-
-  if ((quote === '"' || quote === "'") && value.at(-1) === quote) {
-    return value.slice(1, -1);
-  }
-
-  return value;
-};
-
-const isRawSvgUrl = (url: string) => {
-  const [filePath, query = ''] = url.split('?');
-  const params = new URLSearchParams(query);
-
-  return filePath.endsWith('.svg') && params.get('raw') === 'true';
-};
-
-const isImageUrl = (value: string) => {
-  const [filePath] = value.split('?');
-
-  return /\.(avif|gif|jpe?g|png|svg|webp)$/i.test(filePath);
-};
-
-const resolveMarkdownPath = (env: Record<string, unknown>) =>
-  (env.path as string | undefined) ??
-  (env.file as string | undefined) ??
-  (env.realPath as string | undefined);
-
-const renderImage = (
-  url: string,
-  env: Record<string, unknown>,
-  escapeAttr: (value: string) => string,
-) => {
-  if (!isRawSvgUrl(url)) {
-    return `<img class="example-guidance__image" src="${escapeAttr(url)}" alt="" loading="lazy">`;
-  }
-
-  const [filePath] = url.split('?');
-  const markdownPath = resolveMarkdownPath(env);
-  const resolvedPath = isAbsolute(filePath)
-    ? resolve(process.cwd(), `.${filePath}`)
-    : resolve(markdownPath ? dirname(markdownPath) : process.cwd(), filePath);
-  const svg = readFileSync(resolvedPath, 'utf8');
-  const replacedSvg = svg
-    .replaceAll(/(#000(000)?|black)/g, 'currentColor')
-    .replaceAll(' stroke="#D8D8D9"', 'style="stroke: currentColor; stroke-opacity: .25;"');
-
-  return `<div class="example-guidance__image example-guidance__image--raw">${replacedSvg}</div>`;
-};
-
-const renderPreview = (
-  value: string,
-  env: Record<string, unknown>,
-  escapeHtml: (value: string) => string,
-  renderInline: (value: string) => string,
-) => {
-  if (isImageUrl(value)) {
-    return renderImage(value, env, escapeHtml);
-  }
-
-  return `<div class="example-guidance__text">${renderInline(value)}</div>`;
-};
-
-const hasTopLevelContent = (tokens: Parameters<RenderRule>[0], index: number) => {
-  let guidanceDepth = 0;
-
-  for (let i = index + 1; i < tokens.length; i += 1) {
-    const token = tokens[i];
-
-    if (token.type === 'container_example_close') {
-      return false;
-    }
-
-    if (token.type === 'container_do_open' || token.type === 'container_dont_open') {
-      guidanceDepth += 1;
-      continue;
-    }
-
-    if (token.type === 'container_do_close' || token.type === 'container_dont_close') {
-      guidanceDepth -= 1;
-      continue;
-    }
-
-    if (guidanceDepth === 0) {
-      return true;
-    }
-  }
-
-  return false;
-};
-
-const hasGuidance = (tokens: Parameters<RenderRule>[0], index: number) => {
-  for (let i = index + 1; i < tokens.length; i += 1) {
-    const token = tokens[i];
-
-    if (token.type === 'container_example_close') {
-      return false;
-    }
-
-    if (token.type === 'container_do_open' || token.type === 'container_dont_open') {
-      return true;
-    }
-  }
-
-  return false;
-};
-
-const isFirstGuidance = (tokens: Parameters<RenderRule>[0], index: number) => {
-  for (let i = index - 1; i >= 0; i -= 1) {
-    const token = tokens[i];
-
-    if (token.type === 'container_example_open') {
-      return true;
-    }
-
-    if (token.type === 'container_do_open' || token.type === 'container_dont_open') {
-      return false;
-    }
-  }
-
-  return true;
-};
-
-const getExampleOpenIndex = (tokens: Parameters<RenderRule>[0], index: number) => {
-  for (let i = index; i >= 0; i -= 1) {
-    if (tokens[i].type === 'container_example_open') {
-      return i;
-    }
-  }
-
-  return index;
-};
-
-export default function examplePlugin(md: MarkdownIt) {
-  const escapeHtml = md.utils.escapeHtml;
-
-  const createExampleContainer = (): ContainerArgs => [
-    container,
-    'example',
-    {
-      render(tokens, idx) {
-        const token = tokens[idx];
-
-        if (token.nesting === 1) {
-          const hasContent = hasTopLevelContent(tokens, idx);
-          const guidanceOnlyClass = hasContent ? '' : ' example-block--guidance-only';
-          const contentOpen = hasContent ? '<div class="example-block__content">\n' : '';
-
-          return `<section class="example-block${guidanceOnlyClass}">\n${contentOpen}`;
-        }
-
-        const exampleOpenIndex = getExampleOpenIndex(tokens, idx);
-        const contentClose =
-          hasTopLevelContent(tokens, exampleOpenIndex) && !hasGuidance(tokens, exampleOpenIndex)
-            ? '</div>\n'
-            : '';
-
-        return `${contentClose}</section>\n`;
-      },
-    },
-  ];
-
-  const createGuidanceContainer = (type: 'do' | 'dont'): ContainerArgs => [
-    container,
-    type,
-    {
-      render(tokens, idx, _options, env) {
-        const token = tokens[idx];
-
-        if (token.nesting === 1) {
-          const exampleOpenIndex = getExampleOpenIndex(tokens, idx);
-          const preview = stripWrappingQuotes(parseInfo(token.info, type));
-          const media = renderPreview(preview, env, escapeHtml, md.renderInline.bind(md));
-          const contentClose =
-            hasTopLevelContent(tokens, exampleOpenIndex) && isFirstGuidance(tokens, idx)
-              ? '</div>\n'
-              : '';
-          const label =
-            type === 'do'
-              ? `<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" class="lucide lucide-check-icon lucide-check"><path d="M20 6 9 17l-5-5"/></svg> Do`
-              : `<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" class="lucide lucide-x-icon lucide-x"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg> Don't`;
-
-          return `${contentClose}<figure class="example-guidance example-guidance--${type}">${media}<figcaption class="example-guidance__caption"><div class="example-guidance__label">${label}</div>\n`;
-        }
-
-        return '</figcaption></figure>\n';
-      },
-    },
-  ];
-
-  md.use(...createExampleContainer());
-  md.use(...createGuidanceContainer('do'));
-  md.use(...createGuidanceContainer('dont'));
-}

docs/.vitepress/markdown/sandpack.ts

@@ -1,6 +1,5 @@
 import type MarkdownIt from 'markdown-it';
 import type { RenderRule } from 'markdown-it/lib/renderer.mjs';
-import type Token from 'markdown-it/lib/token.mjs';
 import container from 'markdown-it-container';
 import sandpackTheme from '../theme/sandpackTheme.json';
 
@@ -22,10 +21,14 @@ export default function sandpackPlugin(md: MarkdownIt, pluginOptions: SnackParam
     throw new Error('MarkdownIt instance is required for sandpackPlugin');
   }
   const escapeHtml = md?.utils?.escapeHtml;
+  const defaultFence =
+    md.renderer.rules.fence ||
+    ((tokens, idx, options, env, self) => self.renderToken(tokens, idx, options));
 
-  const renderSandbox = (tokenList: Token[], index: number) => {
-    const renderFunc = (tokens: Token[], idx: number) => {
+  const renderSandbox = (tokenList: any[], index: number) => {
+    const renderFunc = (tokens: any[], idx: number) => {
       if (tokens[idx].nesting === 1) {
+        const fileAttr: string[] = [];
         const attrs = Object.fromEntries(tokens[idx].attrs || []);
 
         const files: Record<
@@ -44,7 +47,7 @@ export default function sandpackPlugin(md: MarkdownIt, pluginOptions: SnackParam
         ) {
           if (tokens[i].type === 'fence' && tokens[i].tag === 'code') {
             const info = tokens[i].info ?? '';
-            const [, fileName, params = ''] = info.split(' ');
+            const [lang, fileName, params = ''] = info.split(' ');
 
             const active = params.includes('[active]');
             const hidden = params.includes('[hidden]');
@@ -54,9 +57,15 @@ export default function sandpackPlugin(md: MarkdownIt, pluginOptions: SnackParam
             if (fileName && code) {
               files[fileName] = {
                 code,
-                ...(active && { active: true }),
-                ...(hidden && { hidden: true }),
               };
+
+              if (active) {
+                (files[fileName] as any).active = true;
+              }
+
+              if (hidden) {
+                (files[fileName] as any).hidden = true;
+              }
             }
           }
         }
@@ -113,7 +122,7 @@ export default function sandpackPlugin(md: MarkdownIt, pluginOptions: SnackParam
     return renderFunc(tokenList, index);
   };
 
-  function createCodeGroup(): ContainerArgs {
+  function createCodeGroup(md: MarkdownIt): ContainerArgs {
     return [
       container,
       'sandpack',
@@ -125,5 +134,5 @@ export default function sandpackPlugin(md: MarkdownIt, pluginOptions: SnackParam
     ];
   }
 
-  md.use(...createCodeGroup());
+  md.use(...createCodeGroup(md));
 }

docs/.vitepress/markdown/snackPlayer.ts

@@ -73,6 +73,7 @@ export default function snackPlayerPlugin(md: MarkdownIt) {
       'react-native-safe-area-context' + (params.dependencies ? `,${params.dependencies}` : '');
     const platform = params.platform ?? 'web';
     const supportedPlatforms = params.supportedPlatforms ?? 'ios,android,web';
+    const theme = params.theme ?? 'light';
     const preview = params.preview ?? 'true';
     const loading = params.loading ?? 'lazy';
     const deviceAppearance = params.deviceAppearance ?? 'dark';
@@ -87,7 +88,7 @@ export default function snackPlayerPlugin(md: MarkdownIt) {
       ` data-snack-dependencies="${escapeHtml(dependencies)}"` +
       ` data-snack-platform="${escapeHtml(platform)}"` +
       ` data-snack-supported-platforms="${escapeHtml(supportedPlatforms)}"` +
-      // ` data-snack-theme="${escapeHtml(params.theme ?? 'light')}"` +
+      // ` data-snack-theme="${escapeHtml(theme)}"` +
       ` data-snack-preview="${escapeHtml(preview)}"` +
       ` data-snack-loading="${escapeHtml(loading)}"` +
       ` data-snack-device-appearance="${escapeHtml(deviceAppearance)}"` +

docs/.vitepress/sidebar/resources.ts

@@ -11,91 +11,41 @@ export const resourcesSidebar = [
         link: '/community',
       },
       {
-        text: 'Code of conduct',
+        text: 'Code of Conduct',
         link: '/code-of-conduct',
       },
       {
         text: 'Brand logo statement',
         link: '/brand-logo-statement',
       },
-    ],
-  },
-  {
-    text: 'Contribute',
-    items: [
       {
-        text: 'Contribution guide',
-        link: '/contribute/',
+        text: 'Contributing',
+        link: '/contribute',
       },
     ],
   },
   {
-    text: 'Contributing icons',
+    text: 'Designing icons',
     items: [
       {
-        text: 'Getting started',
-        link: '/contribute/icons/',
+        text: 'Icon Design Principles',
+        link: '/contribute/icon-design-guide',
       },
       {
-        text: 'Design language',
-        link: '/contribute/icons/design-principles',
-        desc: 'Learn the visual principles that shape Lucide icons with side-by-side examples.',
+        text: 'Designing in Illustrator',
+        link: '/contribute/illustrator-guide',
       },
       {
-        text: 'Design specification',
-        link: '/contribute/icons/specification',
-        desc: 'Review the technical requirements every Lucide icon must meet.',
+        text: 'Designing in Inkscape',
+        link: '/contribute/inkscape-guide',
       },
       {
-        text: 'Naming conventions',
-        link: '/contribute/icons/naming-conventions',
-        desc: 'Learn how to choose clear, consistent, and predictable names for Lucide icons.',
+        text: 'Designing in Figma',
+        link: '/contribute/figma-guide',
       },
       {
-        text: 'Metadata conventions',
-        link: '/contribute/icons/metadata-conventions',
-        desc: 'Learn how to write use cases, tags, categories, aliases, and other icon metadata.',
-        items: [
-          {
-            text: 'Use case guide',
-            link: '/contribute/icons/metadata-conventions/use-case-guide',
-            desc: '',
-          },
-          {
-            text: 'Tag guide',
-            link: '/contribute/icons/metadata-conventions/tag-guide',
-            desc: '',
-          },
-        ],
-      },
-      {
-        text: 'SVG conventions',
-        link: '/contribute/icons/code-conventions',
-        desc: 'Learn how to structure and write Lucide SVG files.',
-      },
-      {
-        text: 'Design software guides',
-        collapsed: false,
-        desc: 'Learn how to design and export Lucide icons with common vector tools.',
-        items: [
-          {
-            text: 'Adobe Illustrator',
-            link: '/contribute/icons/illustrator-guide',
-            desc: '',
-          },
-          {
-            text: 'Inkscape',
-            link: '/contribute/icons/inkscape-guide',
-          },
-          {
-            text: 'Figma',
-            link: '/contribute/icons/figma-guide',
-          },
-          {
-            text: 'Affinity Designer',
-            link: '/contribute/icons/affinity-designer-guide',
-          },
-        ],
+        text: 'Designing in Affinity Designer',
+        link: '/contribute/affinity-designer-guide',
       },
     ],
   },

docs/.vitepress/theme/components/icons/CategoryList.data.ts

@@ -1,3 +1,4 @@
+import { getAllData } from '../../../lib/icons';
 import { getAllCategoryFiles, mapCategoryIconCount } from '../../../lib/categories';
 import iconsMetaData from '../../../data/iconMetaData';
 

docs/.vitepress/theme/components/icons/IconPreview.vue

@@ -84,7 +84,7 @@ const base64InnerSvg = computed(() => {
       </g>
     </svg>
     <a
-      :href="`https://studio.lucide.dev/edit?value=${encodeURIComponent(base64InnerSvg)}&name=${name}&utm_source=lucide.dev&utm_medium=icon-detail-preview`"
+      :href="`https://studio.lucide.dev/edit?value=${encodeURIComponent(base64InnerSvg)}&name=${name}`"
       target="_blank"
       rel="noopener noreferrer"
       class="studio-button"

docs/.vitepress/theme/composables/useExternalLibs.ts

@@ -16,7 +16,7 @@ export const externalLibContext = {
 };
 
 const externalLibIconNodesAPI = {
-  lab: `${import.meta.env.DEV ? 'http://localhost:3000' : ''}/api/lab/icon-details`,
+  lab: 'https://lab.lucide.dev/api/icon-details',
 };
 
 export function useExternalLibs(): ExternalLibContext {
@@ -32,15 +32,13 @@ export function useExternalLibs(): ExternalLibContext {
           newExternalIconNodes[lib] = savedIconNodes[lib];
         } else {
           const response = await fetch(externalLibIconNodesAPI[lib]);
-          const iconDetails = await response.json();
+          const iconNodes = await response.json();
 
-          if (iconDetails) {
-            newExternalIconNodes[lib] = Object.values(iconDetails).map((iconEntity: IconEntity) => {
-              return {
-                ...iconEntity,
-                externalLibrary: lib,
-              };
-            });
+          if (iconNodes) {
+            newExternalIconNodes[lib] = Object.values(iconNodes).map((iconEntity: IconEntity) => ({
+              ...iconEntity,
+              externalLibrary: lib,
+            }));
           }
         }
       }

docs/.vitepress/theme/composables/useIconStyle.ts

@@ -1,3 +1,5 @@
+/* eslint-disable no-console */
+
 import { ref, inject, Ref } from 'vue';
 
 export const ICON_STYLE_CONTEXT = Symbol('style');

docs/.vitepress/theme/style.css

@@ -183,140 +183,3 @@ html {
   background: transparent;
   border: none;
 }
-
-.custom-block.success {
-  border-color: transparent;
-  color: var(--vp-c-text-1);
-  background-color: var(--vp-c-success-soft);
-}
-/* Example guidance blocks */
-.example-block {
-  margin: 32px 0;
-}
-
-.example-block__title {
-  margin: 0 0 12px;
-  font-size: 20px;
-  line-height: 1.4;
-}
-
-.example-block > :first-child {
-  margin-top: 0;
-}
-
-.example-block > :last-child {
-  margin-bottom: 0;
-}
-
-.example-block__content > :first-child {
-  margin-top: 0;
-}
-
-.example-block__content > :last-child {
-  margin-bottom: 0;
-}
-
-.example-guidance__image {
-  display: block;
-  width: 100%;
-  height: auto;
-  background-color: var(--vp-c-bg-soft);
-  border-bottom: 4px solid var(--vp-c-divider);
-  border-top-left-radius: 16px;
-  border-top-right-radius: 16px;
-  overflow: hidden;
-}
-
-.example-guidance__image--raw svg {
-  display: block;
-  width: 100%;
-  height: auto;
-}
-
-.example-guidance__text {
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-  align-items: center;
-  justify-content: center;
-  min-height: 160px;
-  padding: 24px;
-  background-color: var(--vp-c-bg-alt);
-  border-bottom: 1px solid var(--vp-c-divider);
-  border-top-left-radius: 16px;
-  border-top-right-radius: 16px;
-  color: var(--vp-c-text-1);
-  font-size: 20px;
-  line-height: 1.4;
-  text-align: center;
-  text-wrap: balance;
-}
-
-.example-guidance__text svg.lucide {
-  flex-shrink: 0;
-  display: inline-block;
-  vertical-align: -6px;
-}
-
-.example-guidance__caption {
-  color: var(--vp-c-text-1);
-}
-
-.example-guidance__caption > p {
-  margin: 0;
-  padding: 0 16px 16px;
-}
-
-.example-guidance__label {
-  display: flex;
-  gap: 8px;
-  padding: 12px;
-  margin: 0 0 16px;
-  background-color: var(--example-guidance-label-bg);
-  color: var(--vp-c-neutral-inverse);
-  border-bottom-left-radius: 16px;
-  border-bottom-right-radius: 16px;
-}
-
-.example-guidance--do {
-  --example-guidance-label-bg: var(--vp-c-success-1);
-}
-
-.example-guidance--dont {
-  --example-guidance-label-bg: var(--vp-c-danger-1);
-}
-
-@media (min-width: 640px) {
-  .example-block {
-    display: grid;
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-    gap: 24px;
-  }
-
-  .example-block__content {
-    grid-column: 1 / -1;
-  }
-
-  .example-guidance {
-    margin: 0;
-  }
-}
-
-@media (min-width: 960px) {
-  .example-block {
-    grid-template-columns: minmax(0, 0.9fr) repeat(2, minmax(0, 1fr));
-  }
-
-  .example-block--guidance-only {
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-  }
-
-  .example-block__content {
-    grid-column: 1;
-  }
-
-  .example-guidance {
-    grid-column: auto;
-    grid-row: auto;
-  }
-}

docs/.vitepress/types.d.ts

@@ -6,13 +6,13 @@ declare module '*.vue' {
 }
 
 declare module '*.data.ts' {
-  const data: unknown;
+  const data: any;
 
   export { data };
 }
 
 declare module '*.data' {
-  const data: unknown;
+  const data: any;
 
   export { data };
 }
@@ -75,7 +75,7 @@ declare global {
           doNotShowAfterSubmit?: boolean;
           customFormUrl?: string; // when you want to load the form via it's custom domain URL
           hiddenFields?: {
-            [key: string]: unknown;
+            [key: string]: any;
           };
           onOpen?: () => void;
           onClose?: () => void;

docs/community.md

@@ -29,7 +29,7 @@ Contribution in form of code or new icons is always welcome, but you can also he
 
 ### Design New Icons
 
-If you have design skills, consider contributing new icons to the Lucide library. Check out our [icon design guide](/contribute/icons/design-principles.md) for tips and guidelines on creating icons that fit the Lucide style.
+If you have design skills, consider contributing new icons to the Lucide library. Check out our [icon design guide](/contribute/icon-design-guide.md) for tips and guidelines on creating icons that fit the Lucide style.
 
 ### Contribute Code
 

docs/contribute/affinity-designer-guide.md

@@ -0,0 +1,18 @@
+---
+title: Affinity Designer Template Guide
+---
+
+# Affinity Designer Template Guide
+
+This guide describes how to use the Affinity Designer template for Lucide.
+
+## General Workflow
+
+>Attention: By default, Affinity Designer sets the unit for stroke to points. Make sure that it is set to pixel. To do this, open `Preferences > User Interface`. Under `Decimal Places for Unit Types`, uncheck `Show Lines in points`.
+
+1. Download and open the [Affinity Designer template](https://github.com/lucide-icons/lucide/blob/main/docs/public/templates/affinity_designer.aftemplate).
+2. Follow the [Icon Design Principles](icon-design-guide.md) while you use the template (to ensure integrity with the Lucide icon pack).
+3. Export the file as SVG (`File > Export`). Make sure that _Rastering_ is set to _Nothing_, _Export text as curves_ is checked (hopefully, you won't need this), _Use hex colors_ is checked, and _Flatten transforms_ is checked.
+
+	 ![SVG export options in Affinity Designer](../images/affinity-designer-export-options.png?raw=true)
+4. Optimize the exported SVG file further with [SVGOMG](https://jakearchibald.github.io/svgomg/) or [`svgo`](https://github.com/svg/svgo) (using `svgo --multipass exported_icon.svg`).

docs/contribute/figma-guide.md

@@ -0,0 +1,51 @@
+---
+title: Figma Template Guide
+---
+
+# Figma Template Guide
+
+This guide shows the steps to setup Figma for creating icons that conform to the Featherity design guidelines.
+
+## Setting Up The Frame
+When you create a new document in Figma, the document. Each individual icon you want to create, has to be created in a separate frame.
+
+To do this, create a frame of 24x24 pixels.
+
+1. Click the frame button (or press `F`)
+2. Draw a 24x24 frame (or edit it afterwards from the design window)
+
+In this newly created frame, you will create your icon. If you want, you can change the name of your frame to the name of the icon you are going to create. Then it will be exported as `FRAME-NAME.svg`.
+
+## Create Your icon
+To design your icon in the style of Feather Icons, you need to adjust a few settings in Figma.
+
+Draw in your new frame with the pen tool. You can open it with the window at the top, or with the shortcut `P`. Once you click in your frame, you can adjust the settings for the pen tool in the design-window on the right.
+
+Set the following:
+1. Vector
+   1. Corner radius: 2px
+2. Stroke
+   1. Stroke width: 2px
+   2. Stroke alignment: center
+
+![Figma Stroke Options](../images/figma-stroke-options.png)
+
+## Export Or Copy Your Icon
+Once you have completed your icon, you can export it.
+
+1. Select the frame
+2. Open the *Export* tab on the right
+3. Set the file type as SVG
+4. Press export
+
+Or you can also copy its source as SVG.
+
+1. Select the frame
+2. Right click it
+3. Click on *Copy/Paste as*
+4. Click on *Copy as SVG*
+
+That's it. You just made your first icon. Congratulations!
+
+## Figma Tips
+1. The [Icon Design Guidelines](icon-design-guide.md) dictate that you keep 2px spacing between detached elements. In Figma, you can easily check this with: `⌥` Option (MacOS) or `Alt` (Windows).

docs/contribute/icon-design-guide.md

@@ -0,0 +1,199 @@
+---
+description: Guidelines and best practices for designing icons for the Lucide icon library.
+---
+# Icon Design Guide
+
+Guidelines and best practices for designing icons for the Lucide icon library.
+
+## Icon Design Principles
+
+Here are rules that should be followed to keep quality and consistency when making icons for Lucide.
+
+### 1. Icons must be designed on a **24 by 24 pixels** canvas.
+
+![24px-24px](../images/24px-24px.svg?raw=true "24px-24px")
+
+### 2. Icons must have at least **1 pixel padding** within the canvas.
+
+![1px-padding](../images/1px-padding.svg?raw=true "1px-padding")
+
+### 3. Icons must have a **stroke width of 2 pixels**.
+
+![2px-stroke](../images/2px-stroke.svg?raw=true "2px-stroke")
+
+### 4. Icons must use **round joins**.
+
+![round-joints](../images/round-joints.svg?raw=true "round-joints")
+
+### 5. Icons must use **round caps**.
+
+![round-caps](../images/round-caps.svg?raw=true "round-caps")
+
+### 6. Icons must use **centered strokes**.
+
+![centered-strokes](../images/centered-strokes.svg?raw=true "centered-strokes")
+
+### 7. Shapes (such as rectangles) must have a **border radius of**
+
+#### A. **2 pixels** if they are at least 8 pixels in size
+
+![2px-border-radius](../images/2px-border-radius.svg?raw=true "2px-border-radius")
+
+#### B. **1 pixel** if they are smaller than 8 pixels in size
+
+![1px-border-radius](../images/1px-border-radius.svg?raw=true "1px-border-radius")
+
+### 8. Distinct elements must have **2 pixels of spacing between each other**
+
+![2px-element-spacing](../images/2px-element-spacing.svg?raw=true '2px-element-spacing')
+
+![2px-element-spacing-connected](../images/2px-element-spacing-connected.svg?raw=true '2px-element-spacing-connected')
+
+![2px-element-spacing-abrupt-cut](../images/2px-element-spacing-abrupt-cut.svg?raw=true '2px-element-spacing-abrupt-cut')
+
+### 9. Icons should have a similar optical volume to `circle` and `square`.
+
+![optical-volume-ideal](../images/optical-volume-ideal.svg?raw=true "optical-volume-ideal")
+
+![optical-volume-low](../images/optical-volume-low.svg?raw=true "optical-volume-low")
+
+![optical-volume-high](../images/optical-volume-high.svg?raw=true "optical-volume-high")
+
+**Tip:** place your icon next to the circle or square icon and blur them both; your icon should not feel much darker than the base shape.
+
+### 10. Icons should be visually centered by their center of gravity.
+
+![visually-centered](../images/visually-centered.svg?raw=true "visually-centered")
+
+![visually-centered-bad](../images/visually-centered-bad.svg?raw=true "visually-centered-bad")
+
+**Tip:** place your icon both above/below and next to the square or circle icon and check if it feels off center. Symmetrical icons should always be aligned to the center.
+
+### 11. Icons should have similar visual density and level of detail.
+
+![density-ideal](../images/density-ideal.svg?raw=true "density-ideal")
+
+![density-high](../images/density-high.svg?raw=true "density-high")
+
+**Tip:** try to make abstractions to dense elements. Blur your icon, and when blurred it should not feel overly dark.
+
+### 12. Continuous curves should join smoothly.
+
+![curvature-smooth](../images/curvature-smooth.svg?raw=true "curvature-smooth")
+
+![curvature-uneven](../images/curvature-uneven.svg?raw=true "curvature-uneven")
+
+**Tip:** make sure to use arcs or quadratic curves. When using cubic curves control points should have mirrored angles for smooth curves.
+
+### 13. Icons should aim to be pixel perfect so that they will be sharp on low DPI displays.
+
+![pixel-perfection-ideal](../images/pixel-perfection-ideal.svg?raw=true "pixel-perfection-ideal")
+
+![pixel-perfection-bad](../images/pixel-perfection-bad.svg?raw=true "pixel-perfection-bad")
+
+**Tip:** whenever possible align elements and arc centers to the grid.
+
+### 14. Icons should share common shapes
+
+You should try to create consistent groups and variants, reuse and try to create uniformity.
+Consistency inside groups and variants has a lower priority than the rules above.
+
+**Example:** All `-off` icons should look the same unless it for example violates the optical volume rule.
+
+**Tip:** Try to not move the base shape to enable better use in a toggle context.
+
+## Naming conventions
+
+1. Icon names use lower kebab case.\
+   For example: `arrow-up` instead of `Arrow Up`.
+
+2. Icon names use International English names, as opposed to local variants.\
+   For example:  `color` instead of `colour`.
+
+3. Icons should be named for what they depict rather than their use case or what they represent.\
+   For example: `floppy-disk` instead of `save` and `circle-slash` rather than `ban`.
+
+4. Icons that are part of a group are named `<group>-<variant>`.\
+   For example: `badge-plus` is based on `badge`.
+
+5. Icon names for alternate icons should represent what makes the alternate unique instead of being numbered.\
+   For example: `send-horizontal` instead of `send-2`.
+
+6. Names containing numerals are not allowed, unless the number itself is represented in the icon.\
+   For example: `arrow-down-0-to-1` contains both numerals.
+
+7. Icons depicting multiple elements (e.g. a person and a circle) of different sizes must list these elements in decreasing order of size.\
+   For example: if the circle is bigger, it should be `circle-person`, if the person is bigger, it should be `person-circle`.
+
+8. Icons depicting multiple elements of roughly equal sizes (e.g. a `ruler` and a `pencil`) must list these elements front to back in case one element is in front of the other, otherwise in English reading order (top to bottom, left to right).\
+   For example: if the `pencil` is either in front of, above or left of `ruler`, it should be `pencil-ruler`, otherwise, it should be `ruler-pencil`.
+
+9. Icons depicting some sort of variation of an element must use the `[element]-[modifier]` naming scheme, with modifiers being applied to each element respectively.\
+   For example: a dashed circle must be named `circle-dashed`, not `dashed-circle`, and in coordination with the previous guidelines, a dashed circle containing a broken heart would be named `circle-dashed-heart-broken`, due to the heart being smaller than the circle.
+
+## Code Conventions
+
+Before an icon is added to the library, we like to have readable and optimized SVG code.
+
+### Global Attributes
+
+For each icon these attributes are applied, corresponding to the above rules.
+
+```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
+
+The code of paths can sometimes get quite large. To reduce file size we like to minify the code.
+We recommend to use [Lucide Studio](https://studio.lucide.dev/) to tidy paths to 3 points of precision.
+
+### Allowed elements
+
+SVG files may only contain simple path and shape elements, which may not have any attributes other than sizing and spacing.\
+In practice only the following elements and attributes are allowed:
+* `<path d>`
+* `<line x1 x2>`
+* `<polygon points>`
+* `<polyline points>`
+* `<circle cx cy r>`
+* `<ellipse cx cy rx ry>`
+* `<rect x y width height rx>`
+
+This also means that no transforms, filters, fills or explicit strokes are allowed.
+
+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.
+
+## 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",
+  "contributors": [
+    "github-username",
+    "another-github-username"
+  ],
+  "tags": [
+    "foo",
+    "bar"
+  ],
+  "categories": [
+    "devices"
+  ]
+}
+```

docs/contribute/icons/affinity-designer-guide.md

@@ -1,19 +0,0 @@
----
-description: Learn how to use the Affinity Designer template for Lucide.
----
-
-# Affinity Designer template guide
-
-This guide explains how to use the Affinity Designer template for Lucide.
-
-## Workflow
-
-> Affinity Designer uses points for strokes by default. Change strokes to pixels before drawing. Open `Preferences > User Interface`, then under `Decimal Places for Unit Types`, uncheck `Show Lines in points`.
-
-1. Download and open the [Affinity Designer template](https://github.com/lucide-icons/lucide/blob/main/docs/public/templates/affinity_designer.aftemplate).
-2. Follow the [design language](design-principles.md) while designing your icon.
-3. Export the file as SVG with `File > Export`. Set rasterization to _Nothing_, check _Export text as curves_, check _Use hex colors_, and check _Flatten transforms_.
-
-   ![SVG export options in Affinity Designer](../../images/affinity-designer-export-options.png?raw=true)
-
-4. Optimize the exported SVG with [Lucide Studio](https://studio.lucide.dev/).

docs/contribute/icons/code-conventions.md

@@ -1,91 +0,0 @@
----
-description: Learn about allowed SVG elements and attributes, optimization, and other code conventions.
----
-
-# SVG conventions
-
-Before you add an icon to Lucide, make sure its SVG is readable and optimized.
-
-## Global attributes
-
-Each icon uses these root SVG attributes:
-
-```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
-
-Path data can get large. Minify it to keep SVG files small.
-
-Use [Lucide Studio](https://studio.lucide.dev/?utm_source=lucide.dev&utm_medium=design-guide) to tidy paths to 3 decimal places.
-
-## Allowed elements
-
-SVG files may only contain simple path and shape elements. These elements may only use sizing and position attributes.
-
-Only these elements and attributes are allowed:
-
-- `<path d>`
-- `<line x1 y1 x2 y2>`
-- `<polygon points>`
-- `<polyline points>`
-- `<circle cx cy r>`
-- `<ellipse cx cy rx ry>`
-- `<rect x y width height rx>`
-
-Do not use transforms, filters, fills, or explicit stroke colors.
-
-Never use [`<use>`](https://developer.mozilla.org/en-US/docs/Web/SVG/Element/use). It can reduce file size, but referenced IDs may conflict when SVGs are embedded in HTML.
-
-## Metadata file
-
-Each icon must also have a matching JSON file with contributors, use cases, tags, and categories.
-
-See [metadata conventions](./metadata-conventions/) for details.
-
-## Validation
-
-Before submitting SVG changes, format and validate the icon files:
-
-```sh
-pnpm run lint:icons
-```
-
-You can automatically format SVG files with Prettier:
-
-```sh
-pnpm run lint:icons-fix
-```
-
-To check icon names, categories, metadata, and SVG structure together, run:
-
-```sh
-pnpm run lint:icons:all
-```
-
-## Checklist
-
-Before opening a pull request, confirm that:
-
-- The SVG uses the standard `24 × 24` viewBox.
-- The SVG uses `fill="none"` and `stroke="currentColor"`.
-- Stroke width, line caps, and line joins match the Lucide defaults.
-- Paths are tidy and use appropriate numeric precision.
-- The SVG uses only allowed elements and attributes.
-- The SVG does not use transforms, filters, fills, explicit strokes, or `<use>`.
-- The icon has a matching JSON metadata file.
-- `pnpm run lint:icons` passes.
-- `pnpm run lint:json:icons` passes.

docs/contribute/icons/design-principles.md

@@ -1,368 +0,0 @@
----
-description: Learn the visual principles that make Lucide icons consistent and recognizable.
----
-
-# Lucide design language
-
-Lucide is a consistent icon set, not a collection of unrelated icons. Every icon should feel like it belongs with the rest of the library.
-
-This guide explains the visual rules behind Lucide icons and how to use them when designing new icons.
-
-For the full rule list, see the [icon design specification](./specification)
-
-## 1. Use a 24 × 24-pixel canvas
-
-Icons **must** be designed on a 24 × 24-pixel canvas.
-
-:::: example
-::: do ../../images/24px-24px.svg?raw=true
-Use a **24 × 24 pixel** canvas.
-:::
-::: dont ../../images/24px-24px-violation.svg?raw=true
-Don't use a canvas that is larger, smaller, or not square.
-:::
-::::
-
-## 2. Keep a 1-pixel safe zone
-
-Icons **must** have at least 1 pixel of padding between their strokes and the edge of the canvas.
-
-:::: example
-::: do ../../images/1px-padding.svg?raw=true
-Keep at least **1 pixel of padding** around the icon.
-:::
-::: dont ../../images/1px-padding-violation.svg?raw=true
-Don't place strokes at the edge of the canvas. They may get clipped.
-:::
-::::
-
-## 3. Use 2-pixel strokes
-
-Strokes **must** be 2 pixels wide.
-
-:::: example
-::: do ../../images/2px-stroke.svg?raw=true
-Use a **2-pixel stroke width**.
-:::
-::: dont ../../images/2px-stroke-violation.svg?raw=true
-Don't use **thicker or thinner** strokes, or **mix stroke widths**.
-:::
-::::
-
-## 4. Use round line joins
-
-Strokes **must** use round line joins.
-
-:::: example
-::: do ../../images/round-joints.svg?raw=true
-Use **round line joins**.
-:::
-::: dont ../../images/round-joints-violation.svg?raw=true
-Don't use **miter or bevel** line joins.
-:::
-::::
-
-::: tip
-Round joins do not replace corner rounding. Most sharp corners still need a radius.
-:::
-
-## 5. Use round line caps
-
-Open paths **must** use round line caps.
-
-:::: example
-::: do ../../images/round-caps.svg?raw=true
-Use **round line caps** on open paths.
-:::
-::: dont ../../images/round-caps-violation.svg?raw=true
-Don't use **butt or square** line caps.
-:::
-::::
-
-## 6. Use centered strokes
-
-Strokes **must** be centered on their paths.
-
-:::: example
-::: do ../../images/centered-strokes.svg?raw=true
-Keep strokes **centered** on their paths.
-:::
-::: dont ../../images/centered-strokes-violation.svg?raw=true
-Don't use **inside or outside** strokes. They change how line joins appear, creating sharp inner corners.
-:::
-::::
-
-## 7. Use consistent corner radii
-
-Almost every sharp corner **should** be rounded.
-
-:::: example
-::: do ../../images/border-radius-correct.svg?raw=true
-Use **rounded corners**.
-:::
-::: dont ../../images/border-radius-violation.svg?raw=true
-Don't use **sharp corners**.
-:::
-::::
-
-Corner radius depends on the size of the element and the angle. For 90° angles:
-
-:::: example
-::: do ../../images/2px-border-radius.svg?raw=true
-Use a **2-pixel corner radius** for shapes that are at least 8 pixels wide or tall.
-:::
-::: do ../../images/1px-border-radius.svg?raw=true
-Use a **1-pixel corner radius** for shapes smaller than 8 pixels.
-:::
-::::
-
-There are exceptions:
-
-:::: example
-::: do ../../images/border-radius-90deg.svg?raw=true
-Diagonal lines that meet at a right angle usually need a **2.41 pixel** radius (1+√2) to stay aligned to the grid.
-:::
-::: do ../../images/border-radius-arbitrary.svg?raw=true
-Even **very sharp corners** usually need a small amount of rounding. The exact amount depends on the shape.
-:::
-::::
-
-Avoid rounding corners **where multiple lines meet**.
-
-:::: example
-::: do ../../images/border-radius-line-join.svg?raw=true
-Keep corners sharp where multiple lines meet so the icon scales well.
-:::
-::: dont ../../images/border-radius-line-join-violation.svg?raw=true
-Don't round corners where more than two lines meet. This can make the icon scale poorly.
-:::
-::::
-
-## 8. Keep at least 2 pixels between elements
-
-Distinct elements **must** have at least 2 pixels of visual spacing between them.
-
-:::: example
-::: do ../../images/2px-element-spacing.svg?raw=true
-Keep **2 pixels of spacing** between distinct elements.
-:::
-::: dont ../../images/1px-element-spacing.svg?raw=true
-Don't use gaps smaller than **2 pixels** between distinct elements.
-:::
-::::
-
-This also applies inside shapes. Most inner gaps **should** be at least 2 pixels wide.
-
-:::: example
-::: do ../../images/2px-inner-spacing.svg?raw=true
-Keep at least **2 pixels of spacing** inside shapes.
-:::
-::: dont ../../images/1px-inner-spacing.svg?raw=true
-Don't use inner gaps smaller than **2 pixels**.
-:::
-::::
-
-You can test this by placing a **2-pixel-wide circle** inside your shape.
-
-:::: example
-::: do ../../images/2px-inner-gap.svg?raw=true
-If a 2-pixel-wide circle fits **without overlapping**, the gap is **wide enough**.
-:::
-::: dont ../../images/1px-inner-gap.svg?raw=true
-If the circle **overlaps** the shape, the gap should be **wider**.
-:::
-::::
-
-The 2 pixel spacing also applies when elements visually connect or intersect.
-
-:::: example
-::: dont ../../images/2px-element-spacing-connected.svg?raw=true
-Don't connect elements without keeping **2 pixels of spacing**.
-:::
-::: dont ../../images/2px-element-spacing-abrupt-cut.svg?raw=true
-Don't use **abrupt cuts** where one element meets another.
-:::
-::::
-
-## 9. Aim for consistent visual weight
-
-Icons should have a similar visual weight when viewed alongside each other.
-
-:::: example
-
-::: do ../../images/visual-weight-consistent.svg?raw=true
-Match the visual weight of `circle` and `square`.
-:::
-
-::: dont ../../images/visual-weight-uneven.svg?raw=true
-The first icon is **too large**. The last one is **too small**.
-:::
-
-::::
-
-::: tip
-The amount and placement of strokes affect how heavy an icon looks. An icon with many close strokes can look heavier than a simpler icon, even with the same stroke width.
-
-Place your icon next to `circle` or `square`, then blur both icons. Your icon should not look much lighter or darker than the reference icon.
-:::
-
-## 10. Balance icons visually
-
-Icons should look centered and balanced within the canvas.
-
-:::: example
-::: do ../../images/visually-centered-do.svg?raw=true
-Keep your icons visually centered.
-:::
-::: dont ../../images/visually-centered-dont.svg?raw=true
-This icon feels shifted toward the top left.
-:::
-::::
-
-:::: example
-::: do ../../images/visually-centered-symmetrical-do.svg?raw=true
-Symmetrical icons should remain geometrically centered.
-:::
-::: dont ../../images/visually-centered-symmetrical-dont.svg?raw=true
-Don't place symmetrical icons off-center for no good reason.
-:::
-::::
-
-::: tip
-Geometric centering does not always look centered. Asymmetrical shapes may need a small adjustment.
-
-Compare your icon with `circle` or `square` side by side and stacked vertically. If it looks shifted, adjust it.
-:::
-
-## 11. Keep density low
-
-Lucide icons should have a similar level of detail.
-
-:::: example
-::: do ../../images/density-optimal.svg?raw=true
-Simplify complex subjects, but keep the features that make them recognizable.
-:::
-::: dont ../../images/density-too-dense.svg?raw=true
-Don't add extra details that make the design feel crowded.
-:::
-::::
-
-::: tip
-
-Dense areas and close strokes can make an icon look heavier than nearby icons.
-
-View the icon at its intended size and blur it. Areas that turn dark may have too much detail.
-
-:::
-
-## 12. Use smooth, simple curves
-
-Curves should be smooth and as simple as the shape allows.
-
-:::: example
-::: do ../../images/curvature-smooth.svg?raw=true
-Prefer **simple arcs** and **quadratic curves** where possible.
-:::
-::: dont ../../images/curvature-uneven.svg?raw=true
-Don't use **uneven or unnecessarily complex** curves.
-:::
-::::
-
-::: tip
-When you need cubic Bézier curves, align their control points to avoid visible bumps.
-
-Avoid extra control points. They make shapes harder to edit and can create small flaws.
-:::
-
-## 13. Design for the pixel grid
-
-Lucide icons should look sharp at small sizes, including on low-density displays.
-
-:::: example
-::: do ../../images/pixel-perfection-ideal.svg?raw=true
-Align coordinates, arc centers, and other geometric elements to the pixel grid when possible.
-:::
-::: dont ../../images/pixel-perfection-bad.svg?raw=true
-Don't place geometry off the pixel grid without a visual reason.
-:::
-::::
-
-:::: example
-::: do ../../images/pixel-perfection-subelement-do.svg?raw=true
-Also **align subelements** to the pixel grid.
-:::
-::: dont ../../images/pixel-perfection-subelement-dont.svg?raw=true
-Don't place subelements off-grid. They may become blurry on low-density displays.
-:::
-::::
-
-:::: example
-::: do ../../images/pixel-perfection-diagonals-do.svg?raw=true
-In general try to **align every diagonal line** to the pixel grid.
-:::
-::: dont ../../images/pixel-perfection-diagonals-dont.svg?raw=true
-Avoid placing diagonal lines off-grid. They will appear blurry and optically wider on low-density displays.
-:::
-::::
-
-::: tip
-Pixel alignment should support the icon. Do not let it harm shape recognition, smooth curves, or visual balance.
-:::
-
-## 14. Reuse established shapes
-
-When creating a variant, keep the base icon geometry unless the new idea needs a change.
-
-:::: example
-::: do ../../images/established-shapes-base-do.svg?raw=true
-Reuse existing base icons **exactly as they appear**.
-:::
-::: dont ../../images/established-shapes-base-dont.svg?raw=true
-Don't change the **geometry, placement, or orientation** of base shapes.
-:::
-::::
-
-Related icons should share shapes and visual patterns when possible.
-
-:::: example
-::: do ../../images/established-shapes-sub-do.svg?raw=true
-Reuse elements from existing icons **without change**.
-:::
-::: dont ../../images/established-shapes-sub-dont.svg?raw=true
-Don't redesign **existing elements**.
-:::
-::::
-
-Common modifiers and elements should look consistent across the library.
-
-:::: example
-::: do ../../images/established-shapes-consistency-do.svg?raw=true
-Keep add-ons consistent in **placement and size**.
-:::
-::: dont ../../images/established-shapes-consistency-dont.svg?raw=true
-Don't use **irregular placement or size** compared to existing icons.
-:::
-::::
-
-::: tip
-Preserving the base shape makes related icons work better when users switch between them.
-
-Consistency with an existing icon should not override clarity, balance, or readability. Adjust the shape when needed.
-:::
-
-## Summary
-
-When designing a Lucide icon:
-
-1. **Use a 24 × 24 pixel canvas** with at least **1 pixel of safe zone**.
-2. **Use 2 pixel centered strokes** with **round caps and joins**.
-3. **Round sharp corners** using consistent radii appropriate for their size and geometry.
-4. **Keep at least 2 pixels of spacing** between distinct elements and, where possible, inside shapes.
-5. **Match the visual weight** of `circle` and `square`.
-6. **Center icons visually**, accounting for visual weight.
-7. **Keep visual density low** and remove unnecessary detail.
-8. **Use smooth, simple curves** without unnecessary control points.
-9. **Align geometry to the pixel grid** where possible.
-10. **Reuse established shapes** from existing Lucide icons.
-
-When these guidelines conflict, prioritize **clarity, visual balance, and consistency** with the rest of Lucide.

docs/contribute/icons/figma-guide.md

@@ -1,60 +0,0 @@
----
-description: Learn how to create Lucide icons in Figma.
----
-
-# Figma template guide
-
-This guide shows how to set up Figma for Lucide icons.
-
-## Set up the frame
-
-Create each icon in its own frame.
-
-Use a `24 × 24` pixel frame.
-
-1. Click the frame button, or press `F`.
-2. Draw a `24 × 24` frame, or set the size in the right sidebar.
-
-Design the icon inside this frame. Name the frame after the icon so Figma exports it as `frame-name.svg`.
-
-## Create your icon
-
-Set up the stroke before drawing.
-
-Draw in the frame with the pen tool. Open it from the toolbar or press `P`. After you start drawing, adjust the vector settings in the right sidebar.
-
-Set the following:
-
-1. Vector
-   1. Corner radius: 2px
-2. Stroke
-   1. Stroke width: 2px
-   2. Stroke alignment: center
-
-![Figma stroke options](../../images/figma-stroke-options.png)
-
-## Export or copy your icon
-
-When your icon is ready, export it.
-
-1. Select the frame.
-2. Open the _Export_ section in the right sidebar.
-3. Set the file type to SVG.
-4. Click _Export_.
-
-You can also copy the SVG source.
-
-1. Select the frame.
-2. Right-click it.
-3. Choose _Copy/Paste as_.
-4. Choose _Copy as SVG_.
-
-You now have an SVG to prepare for contribution.
-
-## Optimize your icon
-
-You can optimize the exported SVG with [Lucide Studio](https://studio.lucide.dev/).
-
-## Check spacing in Figma
-
-The [design language](design-principles.md) requires at least 2 pixels of spacing between separate elements. In Figma, hold `Option` on macOS or `Alt` on Windows to check spacing.

docs/contribute/icons/illustrator-guide.md

@@ -1,27 +0,0 @@
----
-description: Learn how to use the Adobe Illustrator template for Lucide.
----
-
-# Adobe Illustrator template guide
-
-This guide explains how to use the Adobe Illustrator template for Lucide.
-
-> Templates can fall out of date. Check the [design language](design-principles.md) before you start.
-
-## Workflow
-
-The Illustrator template follows the [design language](design-principles.md).
-
-1. Download and open the [Illustrator template](https://github.com/lucide-icons/lucide/blob/main/docs/public/templates/illustrator_template.ai).
-
-2. Remove the content from the example logo layer (`Draw`) and start drawing.
-
-3. Check that your icon follows the [design language](design-principles.md).
-
-4. Before export, remove unnecessary layers, especially `Padding` and `Grid`.
-
-5. Export the file with `Export > Export As...`, then save it as SVG. Use these SVG options:
-
-   ![SVG export options in Illustrator](../../images/illustrator-svg-options.png?raw=true 'SVG export options in Illustrator')
-
-6. Optimize your SVG with [Lucide Studio](https://studio.lucide.dev/)

docs/contribute/icons/index.md

@@ -1,35 +0,0 @@
----
-description: Guidelines and instructions for contributing icons to Lucide
----
-
-<script setup>
-import OverviewLink from '../../.vitepress/theme/components/base/OverviewLink.vue';
-import OverviewLinkGrid from '../../.vitepress/theme/components/base/OverviewLinkGrid.vue';
-import { resourcesSidebar } from '../../.vitepress/sidebar/resources.ts';
-</script>
-
-# Designing icons for Lucide
-
-Every icon should feel like it belongs with the rest of Lucide.
-
-This guide explains how to design and prepare icons for Lucide.
-
-## What this guide covers
-
-<OverviewLinkGrid>
-  <OverviewLink v-for="item in resourcesSidebar[2].items.slice(1, -1)" :key="item.link" :href="item.link" :title="item.text" :desc="item.desc"/>
-</OverviewLinkGrid>
-
-## Use your preferred design tool
-
-You can design Lucide icons with any vector editor that can export SVG.
-
-Use these step-by-step guides for common tools:
-
-<OverviewLinkGrid>
-  <OverviewLink v-for="item in resourcesSidebar[2].items.at(-1).items" :key="item.link" :href="item.link" :title="item.text" :desc="item.desc"/>
-</OverviewLinkGrid>
-
-These guides explain how to set up your document, follow the Lucide rules, and export a usable SVG.
-
-Regardless of which tool you use, the same design and SVG requirements apply.

docs/contribute/icons/inkscape-guide.md

@@ -1,42 +0,0 @@
----
-description: Learn how to create Lucide icons in Inkscape.
----
-
-# Inkscape setup guide
-
-This guide shows how to set up Inkscape for Lucide icons.
-
-## Set up the canvas
-
-Inkscape creates new documents with a default canvas size. Change it to `24 × 24` pixels:
-
-1. Open the Document Properties dialog with `File > Document Properties`.
-2. On the _Page Size_ tab, under _Custom Size_, set units to `px` and set width and height to `24`.
-   ![Setting page size](../../images/page-size.png?raw=true 'Setting page size')
-3. On the _Grid_ tab, select `Rectangular Grid` and click _New Grid_.
-   ![Setting grid properties](../../images/grid-1.png?raw=true 'Setting grid properties')
-4. Set grid units to `px`, then set `Spacing X` and `Spacing Y` to `1`.
-   ![Setting grid properties](../../images/grid-2.png?raw=true 'Setting grid properties')
-5. Close the Document Properties dialog.
-6. To center the canvas in the viewport, select `View > Zoom > Drawing`.
-
-## Set up paths
-
-1. Create a path or shape.
-2. With the path selected, press `Ctrl+Shift+F` to open the Stroke and Fill panel.
-   ![Stroke style properties](../../images/strokes.png?raw=true 'Setting grid properties')
-3. On the _Stroke Style_ tab:
-   - Set stroke width to `2px`.
-   - Select the rounded join type.
-   - Select the rounded cap type.
-4. For rectangles, select the rectangle and set `Rx` and `Ry` to `2px` in the toolbar.
-   ![Rectangle radius properties](../../images/corner-radius.png?raw=true 'Rectangle radius properties')
-
-## Save a file
-
-1. When you are ready, click _Save As_ and choose _Optimized SVG_ as the file type.
-   ![Save as](../../images/save-as.png?raw=true 'Save as')
-
-## Optimize your icon
-
-As a final step, optimize your SVG with [Lucide Studio](https://studio.lucide.dev/).

docs/contribute/icons/metadata-conventions/index.md

@@ -1,169 +0,0 @@
----
-description: Learn how to write clear and consistent metadata for Lucide icons.
----
-
-<script setup>
-import OverviewLink from '../../../.vitepress/theme/components/base/OverviewLink.vue';
-import OverviewLinkGrid from '../../../.vitepress/theme/components/base/OverviewLinkGrid.vue';
-</script>
-
-# Metadata conventions
-
-Every Lucide icon has a matching JSON metadata file. Metadata credits contributors, groups icons, improves search, and explains where an icon is useful.
-
-Use this guide when you add a new icon or review existing metadata.
-
-## Metadata file location
-
-Each icon metadata file must live next to its SVG file in the `icons` directory.
-
-The JSON file must use the same base name as the SVG file:
-
-- `home.svg` -> `home.json`
-- `arrow-up.svg` -> `arrow-up.json`
-- `square-parking.svg` -> `square-parking.json`
-
-All icon metadata files must pass `icon.schema.json`.
-
-## Required fields
-
-Every icon metadata file must include:
-
-- `$schema`
-- `contributors`
-- `use-cases`
-- `tags`
-- `categories`
-
-A minimal metadata file looks like this:
-
-```json
-{
-  "$schema": "../icon.schema.json",
-  "contributors": ["github-username", "another-github-username"],
-  "use-cases": ["Representing example items in an interface"],
-  "tags": ["foo", "bar"],
-  "categories": ["devices"]
-}
-```
-
-## Contributors
-
-The `contributors` field lists GitHub usernames for people who created or meaningfully changed the icon.
-
-### Contributor rules
-
-1. If you create a new icon based on existing ones, add all contributors from all base icons.
-2. Add a username when someone made a significant change to the icon design.
-3. Do not add people for minor review comments, metadata-only edits, or unrelated discussion.
-
-## Use cases
-
-The `use-cases` field explains where and why someone would use the icon in an interface.
-
-Use cases should be short phrases, not full sentences. Start with an `-ing` verb, such as:
-
-- Representing [concept]
-- Indicating [state]
-- Marking [item]
-- Showing [information]
-- Toggling [setting]
-
-### Use case rules
-
-- Keep each use case focused on one idea
-- Keep entries concise and specific
-- Write from the interface's perspective
-- Describe real usage, not the icon name or appearance
-- Add context when it clarifies meaning
-- Do not end with punctuation
-- Do not add Markdown or emoji
-- Do not add implementation details or pull request references
-
-<OverviewLinkGrid>
-  <OverviewLink href="./use-case-guide.md" title="Use case guide" desc="Learn the best practices for writing use cases"/>
-</OverviewLinkGrid>
-
-## Tags
-
-The `tags` field is a list of search terms for the icon.
-
-Tags should describe concepts, synonyms, related terms, and common contexts.
-
-Check existing tags before adding new ones. This keeps search consistent and avoids duplicates.
-
-### Tag rules
-
-- Use lowercase tags.
-- Prefer single words where possible.
-- Multi-word tags are allowed when they are clearer, such as `magnifying glass`.
-- Do not include the icon name as a tag.
-- Do not add generic tags like `icon`.
-- Do not add unrelated concepts just to increase search coverage.
-
-For example, `mail-search` can use tags like `email`, `message`, `letter`, `find`, and `filter`, but not `mail`, `search` or `mail search`.
-
-<OverviewLinkGrid>
-  <OverviewLink href="./tag-guide.md" title="Tag guide" desc="Learn the best practices for writing tags"/>
-</OverviewLinkGrid>
-
-## Categories
-
-The `categories` field groups icons by broad use.
-
-Categories must come from the allowed category list in `icon.schema.json`.
-
-Choose categories based on what the icon represents and where people use it. Check similar icons first.
-
-### Category rules
-
-- Use only categories allowed by `icon.schema.json`.
-- Use lowercase category names.
-- Do not invent new categories in icon metadata.
-- Choose relevant categories only.
-
-## Variants and related icons
-
-Related icons should have related metadata, but do not copy use cases blindly.
-
-Write metadata for the specific variant:
-
-- `battery-low` -> `Indicating a low battery charge level`
-- `battery-full` -> `Indicating a full battery charge level`
-- `square-arrow-right-enter` -> sign in, enter, or join contexts
-- `square-arrow-right-exit` -> sign out, exit, or export contexts
-
-When a request covers several icons, assign each use case only to the icon it describes. Do not copy metadata to icons it does not describe.
-
-## Aliases
-
-Some icons can include an optional `aliases` field for alternate names.
-
-Only add aliases when an icon has been renamed from a non-compliant name.
-
-## Validation
-
-Before submitting metadata changes, validate the icon JSON files:
-
-```sh
-pnpm run lint:json:icons
-```
-
-You can also format changed files with Prettier:
-
-```sh
-pnpm exec prettier "icons/*.json" --check
-```
-
-## Checklist
-
-Before opening a pull request, confirm that:
-
-- The JSON file name matches the SVG file name.
-- The file includes all required fields.
-- Contributors are GitHub usernames.
-- Use cases describe real interface usage.
-- Tags are lowercase and useful for search.
-- Categories are allowed by `icon.schema.json`.
-- Metadata is specific to the icon and its variants.
-- `pnpm run lint:json:icons` passes.

docs/contribute/icons/metadata-conventions/tag-guide.md

@@ -1,131 +0,0 @@
----
-description: Learn the best practices for writing tags for Lucide icons.
----
-
-<script setup>
-import { batteryLow, calendar, droplet, hospital, mail, mailSearch, search, type } from '~/.vitepress/data/iconNodes';
-import LucideIcon from '~/.vitepress/theme/components/base/LucideIcon.vue';
-</script>
-
-# Tag guide
-
-This guide shows how to write useful search tags for Lucide icons.
-
-Tags help people find icons by concept, synonym, context, or common wording.
-
-## Use lowercase tags
-
-Tags should always be lowercase.
-
-:::: example
-::: do <LucideIcon :iconNode="mail" /> email
-Lowercase tags **match the style** used across the icon library.
-:::
-::: dont <LucideIcon :iconNode="mail" /> Email
-Capitalized tags create **inconsistent metadata** without improving search.
-:::
-::::
-
-## Prefer short tags
-
-Use one clear word when it is enough. Use multi-word tags when the phrase is clearer.
-
-:::: example
-::: do <LucideIcon :iconNode="search" /> search
-This is **short, common, and easy to find**.
-:::
-::: dont <LucideIcon :iconNode="search" /> searching through files & folders
-This reads like a **use case**, not a tag.
-:::
-::::
-
-## Use multi-word tags when needed
-
-Some ideas are only clear as a phrase. But keep those phrases short.
-
-:::: example
-::: do <LucideIcon :iconNode="droplet" /> blood type
-The phrase is **clearer** than either word on its own.
-:::
-::: dont <LucideIcon :iconNode="droplet" /> blood type medical label
-This combines **several search concepts** into one long tag.
-:::
-::::
-
-## Add synonyms and common wording
-
-Tags can include words people are likely to search for, even if they are not in the icon name.
-
-:::: example
-::: do <LucideIcon :iconNode="mail" /> email
-This helps users find `mail` icons using a **common synonym**.
-:::
-::: dont <LucideIcon :iconNode="mail" /> electronic postal message delivery
-This is unlikely search wording and **adds noise**.
-:::
-::::
-
-## Do not repeat the icon name
-
-The icon name is already searchable. Tags should add other ways to find it.
-
-:::: example
-::: do <LucideIcon :iconNode="mailSearch" /> message filter
-This adds a **related concept** for `mail-search` without duplicating the name.
-:::
-::: dont <LucideIcon :iconNode="mailSearch" /> mail search
-This **repeats the icon name** and does not improve discovery.
-:::
-::::
-
-## Avoid generic tags
-
-Tags should describe the icon, not say that it is an icon.
-
-:::: example
-::: do <LucideIcon :iconNode="calendar" /> event
-This points to a **specific idea** users might search for.
-:::
-::: dont <LucideIcon :iconNode="calendar" /> icon
-**Every entry is an icon**, so this tag does not help anyone find the right one.
-:::
-::::
-
-## Keep tags relevant
-
-Do not add loose terms just to make an icon appear in more searches.
-
-:::: example
-::: do <LucideIcon :iconNode="hospital" /> emergency room
-This is **relevant** for an icon that marks emergency room locations.
-:::
-::: dont <LucideIcon :iconNode="hospital" /> doctor nurse pharmacy
-These terms may be **nearby concepts**, but they do not all describe the same icon.
-:::
-::::
-
-## Match the specific variant
-
-Related icons can share family terms, but variant tags should describe what is different.
-
-:::: example
-::: do <LucideIcon :iconNode="batteryLow" /> depleted
-This distinguishes `battery-low` from **other battery icons**.
-:::
-::: dont <LucideIcon :iconNode="batteryLow" /> charged
-This describes `battery-full` better than `battery-low`.
-:::
-::::
-
-## Use existing tags as a reference
-
-Check similar icons before adding new tags. Reusing existing terms keeps search predictable.
-
-:::: example
-::: do <LucideIcon :iconNode="type" /> typography
-This matches existing text-formatting icons and keeps **related icons** together in search.
-:::
-::: dont <LucideIcon :iconNode="type" /> fontography
-Inventing a new term makes the icon harder to find and less consistent with related metadata.
-:::
-::::

docs/contribute/icons/metadata-conventions/use-case-guide.md

@@ -1,142 +0,0 @@
----
-description: Learn the best practices for writing use cases for Lucide icons.
----
-
-<script setup>
-import { batteryLow, creditCard, crop, handshake, heading2, microchip, search, squareParking, triangleAlert, wifiOff } from '~/.vitepress/data/iconNodes';
-import LucideIcon from '~/.vitepress/theme/components/base/LucideIcon.vue';
-</script>
-
-# Use case guide
-
-This guide shows how to write clear use cases for Lucide icons.
-
-## Write from the interface's perspective
-
-Describe what the interface tells the user. Do not write from the contributor's point of view.
-
-:::: example
-::: do <LucideIcon :iconNode="wifiOff" /> Indicating a device is offline or unreachable
-This describes the **role the icon plays in an interface**.
-:::
-::: dont <LucideIcon :iconNode="wifiOff" /> I need an icon for my offline device screen
-This explains the **contributor's situation**, not the icon's purpose.
-:::
-::::
-
-## Describe real usage, not the icon name
-
-A use case should explain what the icon means in context. Do not repeat the icon name or only describe the drawing.
-
-:::: example
-::: do <LucideIcon :iconNode="microchip" /> Representing processors, chips, or embedded hardware
-This explains `microchip` **without repeating the name**.
-:::
-::: dont <LucideIcon :iconNode="microchip" /> it's a microchip icon
-This **duplicates the icon name** and does not explain where the icon would be used.
-:::
-::::
-
-## Add context when it clarifies meaning
-
-Some icons have broad meanings. Add context when it makes the use case clearer.
-
-:::: example
-::: do <LucideIcon :iconNode="heading2" /> Applying a level-2 heading in text editors
-The phrase explains both the **action and the product area**.
-:::
-::: dont <LucideIcon :iconNode="heading2" /> Applying a heading
-This is less useful because it **omits the level and context**.
-:::
-::::
-
-## Keep each use case focused
-
-Each entry should cover one clear idea. Split different meanings into separate entries.
-
-:::: example
-::: do <LucideIcon :iconNode="squareParking" /> Marking parking locations on maps
-This is **short, clear, and focused** on one interface function.
-:::
-::: dont <LucideIcon :iconNode="squareParking" /> Marking parking, transport, maps, cars, garages, and places
-This reads like a **tag list** and **mixes several ideas**.
-:::
-::::
-
-## Write variant-specific use cases
-
-For related icons, describe what makes each variant different.
-
-:::: example
-::: do <LucideIcon :iconNode="batteryLow" /> Indicating a low battery charge level
-This is specific to `battery-low` and **sets it apart** from other battery icons.
-:::
-::: dont <LucideIcon :iconNode="batteryLow" /> Representing battery status
-This is **too generic** and could apply to **every battery variant**.
-:::
-::::
-
-## Avoid pull request references
-
-Use cases should make sense after the pull request is merged.
-
-:::: example
-::: do <LucideIcon :iconNode="handshake" /> Signifying a deal, agreement, or partnership
-This keeps the **useful meaning** without depending on **outside context**.
-:::
-::: dont <LucideIcon :iconNode="handshake" /> Same as above in #1234
-This **depends on a discussion** readers **may never see**.
-:::
-::::
-
-## Keep entries concise
-
-Use cases should usually be 4 to 12 words. Prefer a short phrase over a long explanation.
-
-:::: example
-::: do <LucideIcon :iconNode="search" /> Searching files by name or content
-This is **short enough** to scan and **specific enough** to understand.
-:::
-::: dont <LucideIcon :iconNode="search" /> This icon can be used when users want to search through all of their files and folders to find something
-This is **too long** and reads like **product copy instead of metadata**.
-:::
-::::
-
-## Do not end with punctuation
-
-Use cases are metadata phrases, not full sentences.
-
-:::: example
-::: do <LucideIcon :iconNode="creditCard" /> Confirming a successful payment
-This matches the **phrase style** used across icon metadata.
-:::
-::: dont <LucideIcon :iconNode="creditCard" /> Confirming a successful payment.
-The period adds **unnecessary punctuation** and makes entries inconsistent.
-:::
-::::
-
-## Avoid markdown and emoji
-
-Use plain text only. Formatting belongs in documentation, not metadata values.
-
-:::: example
-::: do <LucideIcon :iconNode="triangleAlert" /> Warning users about a destructive action
-This works in search, generated pages, and other places that use metadata.
-:::
-::: dont <LucideIcon :iconNode="triangleAlert" /> <span>**Warning** users about a destructive action ⚠️</span>
-Markdown and emoji can **show up in generated UI** and make metadata **harder to reuse**.
-:::
-::::
-
-## Avoid implementation details
-
-Use cases should describe meaning, not how the SVG was made.
-
-:::: example
-::: do <LucideIcon :iconNode="crop" /> Representing cropped or trimmed content
-This explains the icon's **interface meaning**.
-:::
-::: dont <LucideIcon :iconNode="crop" /> Showing a rectangle with two path cuts and adjusted Bezier handles
-This describes **construction details** that do not help people find or understand the icon.
-:::
-::::

docs/contribute/icons/naming-conventions.md

@@ -1,238 +0,0 @@
----
-description: Learn how to choose clear and consistent names for Lucide icons.
----
-
-<script setup>
-import {
-  arrowDown01,
-  badgeCheck,
-  badgePlus,
-  ban,
-  boneFracture,
-  circleDashed,
-  circleFadingArrowUp,
-  circleUser,
-  clock3,
-  heartCrack,
-  moonStar,
-  notepadTextDashed,
-  pencilRuler,
-  rulerDimensionLine,
-  save,
-  sendHorizontal,
-  squareDashed,
-  sunSnow,
-  userRound,
-} from '~/.vitepress/data/iconNodes';
-import LucideIcon from '~/.vitepress/theme/components/base/LucideIcon.vue';
-const pencilRulerHorizontal = [
-  ["path",{"d":"M10 16v-3","key":"1sz6hv"}],
-  ["path",{"d":"M14 16v-3","key":"1rh0ni"}],
-  ["path",{"d":"M16 2.999v5.98","key":"q5wnuh"}],
-  ["path",{"d":"M18 16v-3","key":"gc63g1"}],
-  ["path",{"d":"M19.005 2.994A3 3 0 0122 5.984a3 3 0 01-2.986 2.99l-11.777.017a2 2 0 01-.943-.25l-4.03-2.274a.5.5 0 010-.934l4.03-2.274a2 2 0 01.944-.247z","key":"1bk0ej"}],
-  ["path",{"d":"M6 16v-3","key":"h6yyjy"}],
-  ["rect",{"x":"2","y":"13","width":"20","height":"8","rx":"2","key":"ct2kk9"}]
-];
-const pencilRulerVertical = [
-  ["path",{"d":"M16 10h-3","key":"4p2xpj"}],
-  ["path",{"d":"M16 14h-3","key":"1xsqil"}],
-  ["path",{"d":"M16 18h-3","key":"12gup7"}],
-  ["path",{"d":"M16 6h-3","key":"1o5sfa"}],
-  ["path",{"d":"M2.995 19.005a1 1 0 105.98.01L8.99 7.236a2 2 0 00-.25-.943l-2.274-4.03a.5.5 0 00-.934 0L3.26 6.294a2 2 0 00-.248.944z","key":"rw57er"}],
-  ["path",{"d":"M3 16h5.979","key":"kkz6vb"}],
-  ["rect",{"x":"13","y":"2","width":"8","height":"20","rx":"2","key":"qzgro9"}]
-];
-</script>
-
-# Naming conventions
-
-Learn how to choose clear, consistent names for Lucide icons.
-
-This page covers word order, modifiers, variants, related icons, and other rules that keep icon names predictable.
-
-Use this when naming a new icon or reviewing a proposed name.
-
-## 1. Use lowercase kebab-case
-
-Icon names **must** use lowercase kebab-case.
-
-:::: example
-::: do `arrow-up-0-1`
-Use lowercase kebab-case.
-:::
-::: dont `Arrow Up 0-1` or `arrowUp01`
-Avoid other naming schemes.
-:::
-::::
-
-## 2. Use American English
-
-Icon names **must** use American English, not local variants.
-
-:::: example
-::: do <span>`color`, `maximize`, `center`</span>
-:::
-::: dont <span>`colour`, `maximise`, `centre`</span>
-:::
-::::
-
-## 3. Name icons for what they depict
-
-Icon names **must** describe what the icon shows, not how someone might use it.
-
-:::: example
-::: do <LucideIcon :iconNode="save" /> `floppy-disk`
-The icon **shows** a floppy disk.
-:::
-::: dont <LucideIcon :iconNode="save" /> `save`
-Save is a use case.
-:::
-::::
-
-:::: example
-::: do <LucideIcon :iconNode="ban" /> `circle-slash`
-The icon **shows** a circle with a slash across it.
-:::
-::: dont <LucideIcon :iconNode="ban" /> `ban`
-Ban is an action.
-:::
-::::
-
-::: tip
-An icon can mean different things in different products. Naming icons by appearance keeps names clear and independent from use cases.
-:::
-
-## 4. Name related icons consistently
-
-Icons that belong to the same group **must** use the `<group>-<variant>` naming scheme.
-
-The group name comes first. The variant comes after it.
-
-:::: example
-::: do <span><LucideIcon :iconNode="badgePlus" /> + <LucideIcon :iconNode="badgeCheck" /></span> <span>`badge-plus` & `badge-check`</span>
-`badge` is the group.
-:::
-::: dont <span><LucideIcon :iconNode="badgePlus" /> + <LucideIcon :iconNode="badgeCheck" /></span> <span>`plus-badge` & `check-badge`</span>
-`plus` and `check` are not the group.
-:::
-::::
-
-## 5. Describe alternate icons
-
-Alternate versions of an icon **must** be named for what makes them visually different. Do **not** use numbers just to separate one version from another.
-
-:::: example
-::: do <LucideIcon :iconNode="sendHorizontal" /> `send-horizontal`
-The icon depicts a horizontal "send" symbol.
-:::
-::: dont <LucideIcon :iconNode="sendHorizontal" /> <span>`send-2` or `send-alt`</span>
-"send number 2" and "alternative send" are not clear names.
-:::
-::::
-
-## 6. Only use numerals when depicted
-
-Icon names **must not** include numbers unless the icon shows the number.
-
-:::: example
-::: do <LucideIcon :iconNode="arrowDown01" /> `arrow-down-0-1`
-The arrow points from 0 to 1.
-:::
-::: dont <LucideIcon :iconNode="sendHorizontal" /> `send-2`
-The icon does not show the number 2.
-:::
-::::
-
-:::: example
-::: do <LucideIcon :iconNode="clock3" /> `clock-3`
-The hands point to 3 o'clock.
-:::
-::: dont <LucideIcon :iconNode="userRound" /> `user-3`
-The icon does not show the number 3.
-:::
-::::
-
-Do not use numbers to separate similar icons.
-
-## 7. Order elements by size
-
-When an icon shows multiple elements of different sizes, order their names from largest to smallest.
-
-For an icon containing a circle and a person:
-
-:::: example
-::: do <LucideIcon :iconNode="moonStar" /> `moon-star`
-The `moon` is larger than the `star`.
-:::
-::: dont <LucideIcon :iconNode="circleUser" /> `person-circle`
-The `person` is **not** larger than the `circle`.
-:::
-::::
-
-## 8. Order equally sized elements by position
-
-When an icon depicts multiple elements of roughly equal size, their names **must** be ordered according to their visual position.
-
-If elements overlap, name them from front to back.
-
-If they do not overlap, name them in English reading order: top to bottom, then left to right.
-
-:::: example
-::: do <LucideIcon :iconNode="pencilRuler" /> `pencil-ruler`
-The `pencil` is **in front** of the `ruler`, so it comes first.
-:::
-::: do <LucideIcon :iconNode="rulerDimensionLine" /> `ruler-dimension-line`
-The ruler is below the dimension line, but it is **larger**, so it comes first.
-:::
-::::
-
-:::: example
-::: do <LucideIcon :iconNode="sunSnow" /> `sun-snow`
-The `sun` is **left of** the `snowflake`, so it comes first.
-:::
-::: dont <LucideIcon :iconNode="pencilRulerHorizontal" /> `ruler-pencil`
-The `ruler` is **below** the `pencil`, so `pencil-ruler` is the correct name.
-:::
-::::
-
-## 9. Place modifiers after the element they describe
-
-Modifiers **must** come after the element they describe: `<element>-<modifier>`.
-
-:::: example
-::: do <LucideIcon :iconNode="heartCrack" /> `heart-broken`
-The icon shows a heart that is **cracked**.
-:::
-::: dont <LucideIcon :iconNode="boneFracture" /> `broken-bone`
-The icon shows a bone that is **broken**, so name it `bone-broken`.
-:::
-::::
-
-When an icon has multiple modified elements, each modifier **must** follow the element it describes.
-
-:::: example
-::: do <LucideIcon :iconNode="circleFadingArrowUp" /> `circle-fading-arrow-up`
-The icon shows a **fading** circle with an arrow pointing **up** inside it.
-
-`circle` comes first because it is larger than `arrow`. `fading` follows `circle` because it modifies the circle. `up` follows `arrow` because it modifies the arrow.
-:::
-::: dont <LucideIcon :iconNode="notepadTextDashed" /> `notepad-text-dashed`
-This icon shows a dashed notepad with text inside, so name it `notepad-dashed-text`.
-
-`notepad` comes first because it is larger than `text`. `dashed` follows `notepad` because it modifies the notepad. `text` follows both because `dashed` does not modify `text`.
-:::
-::::
-
-## Summary
-
-When naming an icon:
-
-1. **Describe what you see**, not what the icon could mean.
-2. **Use American English** and **lowercase kebab-case**.
-3. **Keep related icons together** with `<group>-<variant>`.
-4. **Describe what makes an alternate unique** instead of numbering it.
-5. **Only use numerals when they are depicted** in the icon.
-6. **Order elements from largest to smallest**.
-7. If elements are roughly the same size, order them **front to back**, or otherwise in **English reading order**.
-8. **Place modifiers after the element they describe**: `<element>-<modifier>`.

docs/contribute/icons/specification.md

@@ -1,95 +0,0 @@
----
-description: Rules Lucide icons must follow.
----
-
-# Icon design specification
-
-This page lists the rules Lucide icons must follow.
-
-For examples and guidance, see the [Lucide design language](./design-principles).
-
-## Requirement levels
-
-These terms show how strictly each rule applies:
-
-- **Must** and **must not** mark required rules.
-- **Should** and **should not** mark rules that can flex when needed to make a better icon.
-
-Any exception should be intentional and fit the [Lucide design language](./design-principles).
-
-## Canvas
-
-1. Icons **must** use a 24 × 24-pixel canvas.
-2. The canvas **must** be square.
-3. Icon strokes **must** remain at least 1 pixel from the edge of the canvas.
-
-## Strokes
-
-1. Strokes **must** be 2 pixels wide.
-2. Strokes **must** use round line joins.
-3. Open paths **must** use round line caps.
-4. Strokes **must** be centered on their paths.
-
-## Corners
-
-1. Sharp corners **should** be rounded unless the geometry of the icon requires otherwise.
-2. Elements at least 8 pixels wide or tall **should** use a 2-pixel corner radius for 90° corners.
-3. Elements smaller than 8 pixels **should** use a 1-pixel corner radius for 90° corners.
-4. Diagonal lines meeting at a 90° angle **should** use a radius that preserves pixel-grid alignment. This radius is typically approximately 2.41 pixels.
-5. Acute corners **should** use an appropriate amount of rounding based on their geometry.
-6. Corners where multiple lines meet **should** remain sharp when rounding would cause the icon to render inconsistently at different sizes.
-
-## Spacing
-
-1. Distinct elements **must** have at least 2 pixels of visual separation.
-2. Gaps between distinct elements **must not** be smaller than 2 pixels.
-3. Inner gaps **should** be at least 2 pixels wide.
-4. Spacing **should** remain visually consistent where elements connect or intersect.
-5. Elements **should not** terminate with an abrupt cut where another element visually continues or intersects them.
-
-## Visual weight
-
-1. Icons **should** have a visual weight similar to the `circle` and `square` icons.
-2. Icons **should not** appear substantially larger, smaller, heavier, or lighter than comparable Lucide icons.
-
-## Alignment and balance
-
-1. Icons **should** be visually centered within the canvas.
-2. Asymmetrical icons **may** be moved slightly off center so they look visually centered.
-3. Symmetrical icons **should** be geometrically centered.
-
-## Visual density
-
-1. Icons **should** have a level of detail similar to other Lucide icons.
-2. Details **should** be simplified when they cause an icon to appear substantially denser than comparable icons.
-3. Details that are not necessary for recognition **should** be omitted.
-
-## Curves
-
-1. Continuous curves **should** have smooth curvature.
-2. Curves **should not** contain unintended or abrupt changes in curvature.
-3. Arcs and quadratic Bézier curves **should** be preferred where they can accurately represent the intended geometry.
-4. Cubic Bézier curves **may** be used where necessary.
-5. Control points of adjoining cubic Bézier curves **should** be aligned where required to maintain continuous curvature.
-6. Curves **should not** contain unnecessary control points.
-
-## Pixel alignment
-
-1. Coordinates **should** align to the pixel grid where possible.
-2. Centers of arcs and other geometric elements **should** align to the pixel grid where possible.
-3. Off-grid geometry **may** be used when required for visual balance, recognizable geometry, or smooth curvature.
-4. Pixel alignment **should not** take precedence over the visual quality of the icon.
-
-## Shared geometry
-
-1. Variants of an existing icon **should** preserve the geometry, placement, and orientation of the base icon.
-2. Elements that already exist in other Lucide icons **should** reuse established geometry where applicable.
-3. Related icons **should** use consistent representations of shared elements.
-4. Common modifiers and add-ons **should** use consistent geometry, size, and placement across related icons.
-5. Existing geometry **may** be modified when necessary to satisfy other Lucide design language rules.
-
-## Priority of requirements
-
-When two non-required rules conflict, choose visual clarity and consistency with the Lucide design language.
-
-Rules marked **must** or **must not** can only be broken when the project defines an explicit exception.

docs/contribute/illustrator-guide.md

@@ -0,0 +1,31 @@
+---
+title: Illustrator Template Guide
+---
+
+# Illustrator Template Guide
+
+This Guide explains how to properly use the Adobe Illustrator Template for Lucide.
+
+>Attention: Even though it is unlikely the template can be outdated or not 100% correct. Please check the Icon Design Guide before you start working with the template to ensure integrity with the Lucide icon pack.
+
+## General Workflow
+
+The Illustrator template is created following guidelines from the [Icon Design Guide](icon-design-guide.md).
+
+**Workflow:**
+
+1. Download and open the [Illustrator template](https://github.com/lucide-icons/lucide/blob/main/docs/public/templates/illustrator_template.ai).
+
+2. You can now remove the content from the example logo layer ("Draw") and start creating.
+
+3. Verify that you follow the [Icon Design Guidelines](icon-design-guide.md).
+
+4. Before you export the file as an SVG make sure to check that you followed the guidelines and remove all unnecessary layers (especially "Padding" and "Grid").
+
+5. Export the file with the export menu under: `Export > Export As..` then save the file as SVG. Select the following options in the SVG Options dialog:
+
+![SVG export options in Illustrator](../images/illustrator-svg-options.png?raw=true "Setting Page Size")
+
+After that, double check that the [code conventions and SVG global attributes](icon-design-guide.md#code-conventions) are correct.
+
+7. Minify paths with [SVGOMG](https://jakearchibald.github.io/svgomg/).

docs/contribute/inkscape-guide.md

@@ -0,0 +1,41 @@
+---
+title: Icon Design Guide
+---
+
+# Inkscape Setup Guide
+
+This guide shows the steps to setup Inkscape for creating icons that conform to the Lucide design
+guidelines.
+
+## Setting up The Canvas
+
+When opening a new document, Inkscape will create a canvas of a default size.  To change the size to 24x24:
+
+1. Open the Document Properties dialog (File -> Document Properties).
+2. On the “Page Size” tab, under “Custom Size” set the Units to `px` and set both Height and Width to 24.
+![Setting Page Size](../images/page-size.png?raw=true "Setting Page Size")
+3. On the “Grid” tab, select `Rectangular Grid` and click “New Grid”.
+![Setting Grid Properties](../images/grid-1.png?raw=true "Setting Grid Properties")
+4. Set the Grid Units to `px` and set Spacing X and Spacing Y both to 1.
+![Setting Grid Properties](../images/grid-2.png?raw=true "Setting Grid Properties")
+5. Close the Document Properties dialog.
+6. To center the canvas in the viewport, select View -> Zoom -> Drawing.
+
+## Setting up The Paths
+
+1. Create a path or shape.
+2. With the path selected, open the Stroke and Fill panel by pressing `Ctrl+Shift+F` on your keyboard.
+![Stroke Style Properties](../images/strokes.png?raw=true "Setting Grid Properties")
+3. On the “Stroke Style” tab:
+   * Set Stroke Width to `2px`.
+   * Select the rounded join type.
+   * Select the rounded cap type.
+4. If the shape is a rectangle, select the rectangle and in the top of the screen below the menu bar, set `Rx` and `Ry` to `2px`.
+![Rectangle Radius Properties](../images/corner-radius.png?raw=true "Rectangle Radius Properties")
+
+## Saving A File
+
+1. When ready to save the file, click Save As and select “Optimized SVG” as the file type.
+![Save As](../images/save-as.png?raw=true "Save as")
+2. After clicking Save, to conform with the other icons in the package, set Pretty Printing to use spaces and set the indentation depth to 2.
+![Optimize](../images/optimize-settings.png?raw=true "Optimize")

docs/guide/angular/advanced/with-lucide-lab.md

@@ -12,10 +12,6 @@ import Sandpack from '~/.vitepress/theme/components/editors/SandpackAngular.vue'
 
 While they aren't provided as standalone components, they can be still be passed to the `LucideIcon` component the same way as official icons:
 
-::: info Limitation
-Only custom icons that follow Lucide's [code conventions](../../../contribute/icons/code-conventions.md#code-conventions) are supported.
-:::
-
 ### Directly as LucideIconData
 
 ::: sandpack {template=angular showTabs=false editorHeight=400 editorWidthPercentage=60 dependencies="@lucide/angular,@lucide/lab"}

docs/icons/lab/[name].paths.ts

@@ -1,26 +1,24 @@
-import iconNodes from '../../.vitepress/data/lab/iconNodes';
-import iconPopularity from '../../.vitepress/data/lab/iconPopularity';
-import iconMetaData from '../../.vitepress/data/lab/iconMetaData';
-import { type IconEntity } from '../../.vitepress/theme/types';
+import { IconEntity } from '../../.vitepress/theme/types';
 
 export default {
   paths: async () => {
-    return (Object.entries(iconNodes) as unknown as IconEntity[]).map(([name, iconNode]) => {
-      const iconDetails = iconMetaData[name];
+    try {
+      const iconDetailsResponse = await fetch('https://lab.lucide.dev/api/icon-details');
+      const iconDetails = (await iconDetailsResponse.json()) as Record<string, IconEntity>;
 
-      delete iconDetails['$schema'];
+      return Object.values(iconDetails).map((iconEntity) => {
+        const params = {
+          externalLibrary: 'lab',
+          ...iconEntity,
+        };
 
-      const params = {
-        name,
-        iconNode,
-        externalLibrary: 'lab',
-        popularity: iconPopularity[name]?.count ?? 0,
-        ...iconDetails,
-      };
-
-      return {
-        params,
-      };
-    });
+        return {
+          params,
+        };
+      });
+    } catch (error) {
+      console.error('Error fetching icon details:', error);
+      return [];
+    }
   },
 };

docs/images/1px-element-spacing.svg

@@ -1,69 +0,0 @@
-<svg width="240" height="240" viewBox="0 0 240 240" fill="none" xmlns="http://www.w3.org/2000/svg">
-<g clip-path="url(#clip0_1939_21540)">
-<path d="M0 10H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M10 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 20H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M20 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 30H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M30 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 40H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M40 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 50H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M50 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 60H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M60 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 70H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M70 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 80H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M80 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 90H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M90 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 100H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M100 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 110H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M110 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 120H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M120 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 130H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M130 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 140H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M140 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 150H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M150 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 160H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M160 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 170H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M170 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 180H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M180 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 190H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M190 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 200H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M200 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 210H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M210 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 220H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M220 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 230H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M230 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-</g>
-<path d="M200 80H100C88.9543 80 80 88.9543 80 100V200C80 211.046 88.9543 220 100 220H200C211.046 220 220 211.046 220 200V100C220 88.9543 211.046 80 200 80Z" stroke="black" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
-<path d="M160 50V40C160 29 151 20 140 20H40C29 20 20 29 20 40V140C20 151 29 160 40 160H50" stroke="black" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
-<rect x="70" y="123" width="74" height="10" transform="rotate(90 70 123)" fill="url(#paint0_linear_1939_21540)"/>
-<rect x="123" y="60" width="74" height="10" fill="url(#paint1_linear_1939_21540)"/>
-<defs>
-<linearGradient id="paint0_linear_1939_21540" x1="70" y1="127.25" x2="144" y2="127.25" gradientUnits="userSpaceOnUse">
-<stop stop-color="#DD0031" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#DD0031"/>
-<stop offset="1" stop-color="#DD0031" stop-opacity="0"/>
-</linearGradient>
-<linearGradient id="paint1_linear_1939_21540" x1="123" y1="64.25" x2="197" y2="64.25" gradientUnits="userSpaceOnUse">
-<stop stop-color="#DD0031" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#DD0031"/>
-<stop offset="1" stop-color="#DD0031" stop-opacity="0"/>
-</linearGradient>
-<clipPath id="clip0_1939_21540">
-<rect width="240" height="240" fill="white"/>
-</clipPath>
-</defs>
-</svg>

docs/images/1px-inner-gap.svg

@@ -1,5 +0,0 @@
-<svg width="120" height="120" viewBox="0 0 120 120" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M0 10H120M0 20H120M0 30H120M5 0V120M0 40H120M15 0V120M0 50H120M25 0V120M0 60H120M35 0V120M0 70H120M45 0V120M0 80H120M55 0V120M0 90H120M65 0V120M0 100H120M75 0V120M0 110H120M85 0V120M95 0V120M105 0V120M115 0V120" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M35 89.9999L84.9998 59.9999L35 29.9999V89.9999Z" stroke="black" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
-<circle cx="52" cy="60" r="10" fill="#DD0031" fill-opacity="0.2" stroke="#DD0031" stroke-dasharray="1 1"/>
-</svg>

docs/images/1px-inner-spacing.svg

@@ -1,86 +0,0 @@
-<svg width="240" height="240" viewBox="0 0 240 240" fill="none" xmlns="http://www.w3.org/2000/svg">
-<g clip-path="url(#clip0_1940_23527)">
-<path d="M0 10H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M10 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 20H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M20 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 30H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M30 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 40H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M40 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 50H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M50 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 60H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M60 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 70H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M70 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 80H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M80 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 90H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M90 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 100H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M100 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 110H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M110 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 120H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M120 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 130H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M130 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 140H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M140 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 150H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M150 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 160H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M160 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 170H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M170 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 180H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M180 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 190H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M190 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 200H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M200 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 210H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M210 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 220H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M220 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 230H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M230 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-</g>
-<path d="M79.9999 150V55C79.9999 46.7157 86.7157 40 94.9999 40C103.284 40 110 46.7157 110 55V105V35C110 26.7157 116.716 20 125 20C133.284 20 140 26.7157 140 35V100V55C140 46.7157 146.716 40 155 40C163.284 40 170 46.7157 170 55V110V75C170 66.7157 176.716 60 185 60C193.284 60 200 66.7157 200 75V154.75C200 190.786 170.786 220 134.75 220C112.5 220 91.1612 211.161 75.4282 195.428L37.4999 157.5C30.5964 150.596 30.5964 139.404 37.4999 132.5C44.4035 125.596 55.5964 125.596 62.4999 132.5L89.9999 160" stroke="black" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
-<rect x="47.917" y="132.154" width="74" height="15.4386" transform="rotate(45 47.917 132.154)" fill="url(#paint0_linear_1940_23527)"/>
-<rect x="190" y="66" width="74" height="10" transform="rotate(90 190 66)" fill="url(#paint1_linear_1940_23527)"/>
-<rect x="160" y="49" width="74" height="10" transform="rotate(90 160 49)" fill="url(#paint2_linear_1940_23527)"/>
-<rect x="130" y="36" width="74" height="10" transform="rotate(90 130 36)" fill="url(#paint3_linear_1940_23527)"/>
-<rect x="100" y="49" width="74" height="10" transform="rotate(90 100 49)" fill="url(#paint4_linear_1940_23527)"/>
-<defs>
-<linearGradient id="paint0_linear_1940_23527" x1="47.917" y1="138.716" x2="121.917" y2="138.716" gradientUnits="userSpaceOnUse">
-<stop stop-color="#DD0031" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#DD0031"/>
-<stop offset="1" stop-color="#DD0031" stop-opacity="0"/>
-</linearGradient>
-<linearGradient id="paint1_linear_1940_23527" x1="190" y1="70.25" x2="264" y2="70.25" gradientUnits="userSpaceOnUse">
-<stop stop-color="#DD0031" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#DD0031"/>
-<stop offset="1" stop-color="#DD0031" stop-opacity="0"/>
-</linearGradient>
-<linearGradient id="paint2_linear_1940_23527" x1="160" y1="53.25" x2="234" y2="53.25" gradientUnits="userSpaceOnUse">
-<stop stop-color="#DD0031" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#DD0031"/>
-<stop offset="1" stop-color="#DD0031" stop-opacity="0"/>
-</linearGradient>
-<linearGradient id="paint3_linear_1940_23527" x1="130" y1="40.25" x2="204" y2="40.25" gradientUnits="userSpaceOnUse">
-<stop stop-color="#DD0031" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#DD0031"/>
-<stop offset="1" stop-color="#DD0031" stop-opacity="0"/>
-</linearGradient>
-<linearGradient id="paint4_linear_1940_23527" x1="100" y1="53.25" x2="174" y2="53.25" gradientUnits="userSpaceOnUse">
-<stop stop-color="#DD0031" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#DD0031"/>
-<stop offset="1" stop-color="#DD0031" stop-opacity="0"/>
-</linearGradient>
-<clipPath id="clip0_1940_23527">
-<rect width="240" height="240" fill="white"/>
-</clipPath>
-</defs>
-</svg>

docs/images/1px-padding-violation.svg

@@ -1,67 +0,0 @@
-<svg width="244" height="184" viewBox="0 0 244 184" fill="none" xmlns="http://www.w3.org/2000/svg">
-<g clip-path="url(#clip0_1946_25554)">
-<path d="M62 37H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M67 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 42H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M72 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 47H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M77 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 52H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M82 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 57H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M87 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 62H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M92 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 67H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M97 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 72H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M102 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 77H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M107 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 82H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M112 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 87H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M117 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 92H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M122 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 97H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M127 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 102H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M132 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 107H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M137 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 112H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M142 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 117H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M147 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 122H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M152 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 127H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M157 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 132H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M162 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 137H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M167 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 142H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M172 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M62 147H182" stroke="#D8D8D9" stroke-width="0.25"/>
-<path d="M177 32V152" stroke="#D8D8D9" stroke-width="0.25"/>
-</g>
-<mask id="mask0_1946_25554" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="42" y="12" width="160" height="160">
-<path d="M202 172H42V12H202V172ZM62 32V152H182V32H62Z" fill="#D9D9D9"/>
-</mask>
-<g mask="url(#mask0_1946_25554)">
-<path d="M67.025 109.508C71.455 109.519 75.2044 112.41 76.5079 116.403L121.576 136.912C121.704 136.97 121.842 137 121.982 137C122.121 137 122.258 136.97 122.385 136.913L167.39 116.438C168.677 112.446 172.406 109.544 176.83 109.509C182.353 109.465 186.865 113.907 186.909 119.43C186.932 122.436 186.082 125.384 184.46 127.916C182.845 130.436 180.535 132.435 177.808 133.67L177.808 133.671L130.657 155.123C130.653 155.124 130.648 155.126 130.644 155.128C127.923 156.362 124.97 157 121.982 157C118.994 157 116.041 156.362 113.32 155.128C113.316 155.126 113.311 155.125 113.306 155.123L66.0455 133.616C66.025 133.606 66.0048 133.597 65.9844 133.587C63.2939 132.341 61.0182 130.349 59.4263 127.85C57.8345 125.35 56.9928 122.447 57 119.484L57.004 119.226C57.1542 113.822 61.5884 109.495 67.025 109.508ZM176.83 82.0063C182.353 81.9627 186.865 86.4046 186.909 91.9272C186.932 94.9333 186.082 97.8822 184.46 100.414C182.845 102.934 180.535 104.933 177.808 106.168L130.657 127.621C130.653 127.623 130.648 127.625 130.644 127.626C127.923 128.86 124.97 129.498 121.982 129.498C118.994 129.498 116.041 128.86 113.32 127.626C113.316 127.624 113.311 127.622 113.306 127.62L66.0455 106.114C66.0251 106.104 66.0048 106.095 65.9844 106.085C63.2939 104.839 61.0182 102.847 59.4263 100.348C57.8345 97.8479 56.9927 94.9442 57 91.9814L57.004 91.7236C57.1541 86.3203 61.5884 81.9929 67.025 82.0063C71.4548 82.0174 75.2038 84.9075 76.5074 88.9009L121.576 109.41C121.704 109.468 121.842 109.498 121.982 109.498C122.121 109.498 122.258 109.468 122.385 109.411L167.39 88.936C168.677 84.944 172.406 82.0413 176.83 82.0063ZM121.955 47C121.814 47 121.675 47.0302 121.546 47.0889C121.544 47.09 121.541 47.0911 121.539 47.0923L83.3658 64.479L121.598 81.918L121.602 81.9194C121.73 81.978 121.869 82.0083 122.009 82.0083C122.15 82.0083 122.289 81.9781 122.418 81.9194L122.43 81.9141L160.642 64.5288L122.37 47.0923C122.367 47.0912 122.365 47.0899 122.363 47.0889C122.234 47.0302 122.095 47 121.955 47ZM187 64.5317C187 67.5358 186.127 70.4758 184.487 72.9937C182.868 75.48 180.568 77.4487 177.863 78.6665L130.712 100.118L130.711 100.118C127.979 101.363 125.012 102.008 122.009 102.008C119.002 102.008 116.03 101.362 113.295 100.113V100.112L66.1475 78.6079L66.148 78.6074C63.446 77.3893 61.1496 75.4222 59.5318 72.9385C57.8917 70.4206 57.0191 67.4806 57.0191 64.4766C57.0191 61.4725 57.8917 58.5325 59.5318 56.0146L59.6875 55.7803C61.2965 53.4056 63.5343 51.5227 66.1529 50.3433H66.1524L113.24 28.8955V28.895C115.976 27.6462 118.948 27 121.955 27C124.962 27 127.934 27.6462 130.669 28.895L130.669 28.8955L177.868 50.3984L177.867 50.3989C180.485 51.5783 182.723 53.4606 184.332 55.835L184.487 56.0698L184.639 56.3066C186.181 58.7712 187 61.6215 187 64.5317Z" fill="#DD0031" fill-opacity="0.2" stroke="#DD0031" stroke-width="0.5" stroke-dasharray="0.5 0.5"/>
-</g>
-<path d="M67 92.0063C66.9974 93.0583 67.2963 94.0891 67.8612 94.9762C68.4262 95.8634 69.2335 96.5698 70.1874 97.0117L117.448 118.518C118.873 119.164 120.418 119.498 121.982 119.498C123.546 119.498 125.091 119.164 126.516 118.518L173.667 97.0667C174.64 96.629 175.464 95.9176 176.04 95.019C176.615 94.1205 176.918 93.0737 176.909 92.0063M67 119.508C66.9974 120.56 67.2963 121.591 67.8612 122.478C68.4262 123.366 69.2335 124.072 70.1874 124.514L117.448 146.02C118.873 146.666 120.418 147 121.982 147C123.546 147 125.091 146.666 126.516 146.02L173.667 124.569C174.64 124.131 175.464 123.42 176.04 122.521C176.615 121.623 176.918 120.576 176.909 119.508M126.516 37.992C125.084 37.3383 123.528 37 121.955 37C120.381 37 118.825 37.3383 117.393 37.992L70.2972 59.4437C69.3221 59.8741 68.493 60.579 67.9109 61.4726C67.3289 62.3662 67.019 63.4099 67.019 64.4766C67.019 65.5433 67.3289 66.587 67.9109 67.4806C68.493 68.3742 69.3221 69.0791 70.2972 69.5095L117.448 91.0162C118.88 91.6699 120.436 92.0082 122.009 92.0082C123.583 92.0082 125.139 91.6699 126.571 91.0162L173.722 69.5645C174.697 69.1341 175.526 68.4292 176.108 67.5356C176.69 66.642 177 65.5983 177 64.5316C177 63.4649 176.69 62.4212 176.108 61.5276C175.526 60.634 174.697 59.9291 173.722 59.4987L126.516 37.992Z" stroke="black" stroke-width="10" stroke-linecap="round" stroke-linejoin="round"/>
-<mask id="path-50-inside-1_1946_25554" fill="white">
-<path d="M182 32V152H62V32H182ZM67 147H177V37H67V147Z"/>
-</mask>
-<path d="M182 32V152H62V32H182ZM67 147H177V37H67V147Z" fill="#DD0031" fill-opacity="0.5"/>
-<path d="M182 32H183V31H182V32ZM182 152V153H183V152H182ZM62 152H61V153H62V152ZM62 32V31H61V32H62ZM67 147H66V148H67V147ZM177 147V148H178V147H177ZM177 37H178V36H177V37ZM67 37V36H66V37H67ZM182 32H181V152H182H183V32H182ZM182 152V151H62V152V153H182V152ZM62 152H63V32H62H61V152H62ZM62 32V33H182V32V31H62V32ZM67 147V148H177V147V146H67V147ZM177 147H178V37H177H176V147H177ZM177 37V36H67V37V38H177V37ZM67 37H66V147H67H68V37H67Z" fill="#DD0031" fill-opacity="0.25" mask="url(#path-50-inside-1_1946_25554)"/>
-<defs>
-<clipPath id="clip0_1946_25554">
-<rect width="120" height="120" fill="white" transform="translate(62 32)"/>
-</clipPath>
-</defs>
-</svg>

docs/images/24px-24px-violation.svg

@@ -1,9 +0,0 @@
-<svg width="244" height="88" viewBox="0 0 244 88" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M45.8333 32H27.1667C25.6939 32 24.5 33.1939 24.5 34.6667V53.3333C24.5 54.8061 25.6939 56 27.1667 56H45.8333C47.3061 56 48.5 54.8061 48.5 53.3333V34.6667C48.5 33.1939 47.3061 32 45.8333 32Z" stroke="black" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-<path d="M68.9545 34.7273L63.3295 55.625H61.054L66.679 34.7273H68.9545Z" fill="black"/>
-<path d="M96.6111 40H90.3889C89.898 40 89.5 40.398 89.5 40.8889V47.1111C89.5 47.602 89.898 48 90.3889 48H96.6111C97.102 48 97.5 47.602 97.5 47.1111V40.8889C97.5 40.398 97.102 40 96.6111 40Z" stroke="black" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-<path d="M125.955 34.7273L120.33 55.625H118.054L123.679 34.7273H125.955Z" fill="black"/>
-<path d="M154.5 34H146.5C145.395 34 144.5 34.8954 144.5 36V52C144.5 53.1046 145.395 54 146.5 54H154.5C155.605 54 156.5 53.1046 156.5 52V36C156.5 34.8954 155.605 34 154.5 34Z" stroke="black" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-<path d="M182.955 34.7273L177.33 55.625H175.054L180.679 34.7273H182.955Z" fill="black"/>
-<path d="M215.5 38H199.5C198.395 38 197.5 38.8954 197.5 40V48C197.5 49.1046 198.395 50 199.5 50H215.5C216.605 50 217.5 49.1046 217.5 48V40C217.5 38.8954 216.605 38 215.5 38Z" stroke="black" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-</svg>

docs/images/24px-24px.svg

@@ -1,4 +1,74 @@
-<svg width="244" height="88" viewBox="0 0 244 88" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M91 35H77C75.8954 35 75 35.8954 75 37V51C75 52.1046 75.8954 53 77 53H91C92.1046 53 93 52.1046 93 51V37C93 35.8954 92.1046 35 91 35Z" stroke="black" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
-<path d="M109.7 51V49.4091L114.622 44.3097C115.147 43.7557 115.581 43.2704 115.922 42.8537C116.267 42.4323 116.525 42.0322 116.696 41.6534C116.866 41.2746 116.951 40.8722 116.951 40.446C116.951 39.9631 116.838 39.5464 116.61 39.196C116.383 38.8409 116.073 38.5687 115.68 38.3793C115.287 38.1851 114.844 38.0881 114.352 38.0881C113.831 38.0881 113.377 38.1946 112.988 38.4077C112.6 38.6207 112.302 38.9214 112.093 39.3097C111.885 39.6979 111.781 40.1525 111.781 40.6733H109.686C109.686 39.7879 109.889 39.0137 110.297 38.3509C110.704 37.688 111.262 37.1742 111.973 36.8097C112.683 36.4403 113.49 36.2557 114.395 36.2557C115.308 36.2557 116.113 36.438 116.809 36.8026C117.51 37.1624 118.057 37.6548 118.45 38.2798C118.843 38.9001 119.039 39.6009 119.039 40.3821C119.039 40.9219 118.938 41.4498 118.734 41.9659C118.535 42.482 118.187 43.0573 117.69 43.6918C117.193 44.3215 116.502 45.0862 115.616 45.9858L112.725 49.0114V49.1179H119.274V51H109.7ZM121.348 48.1591V46.3835L127.633 36.4545H129.032V39.0682H128.145L123.649 46.1847V46.2983H132.264V48.1591H121.348ZM128.244 51V47.6193L128.258 46.8097V36.4545H130.339V51H128.244ZM143.411 48.5852L135.243 40.4176L136.586 39.0753L144.753 47.2429L143.411 48.5852ZM136.586 48.5852L135.243 47.2429L143.411 39.0753L144.753 40.4176L136.586 48.5852ZM148.059 51V49.4091L152.981 44.3097C153.507 43.7557 153.94 43.2704 154.281 42.8537C154.627 42.4323 154.885 42.0322 155.055 41.6534C155.225 41.2746 155.311 40.8722 155.311 40.446C155.311 39.9631 155.197 39.5464 154.97 39.196C154.743 38.8409 154.432 38.5687 154.039 38.3793C153.646 38.1851 153.204 38.0881 152.711 38.0881C152.19 38.0881 151.736 38.1946 151.348 38.4077C150.959 38.6207 150.661 38.9214 150.453 39.3097C150.244 39.6979 150.14 40.1525 150.14 40.6733H148.045C148.045 39.7879 148.249 39.0137 148.656 38.3509C149.063 37.688 149.622 37.1742 150.332 36.8097C151.042 36.4403 151.85 36.2557 152.754 36.2557C153.668 36.2557 154.473 36.438 155.169 36.8026C155.869 37.1624 156.416 37.6548 156.809 38.2798C157.202 38.9001 157.399 39.6009 157.399 40.3821C157.399 40.9219 157.297 41.4498 157.093 41.9659C156.895 42.482 156.547 43.0573 156.049 43.6918C155.552 44.3215 154.861 45.0862 153.975 45.9858L151.085 49.0114V49.1179H157.633V51H148.059ZM159.707 48.1591V46.3835L165.993 36.4545H167.392V39.0682H166.504L162.008 46.1847V46.2983H170.623V48.1591H159.707ZM166.603 51V47.6193L166.618 46.8097V36.4545H168.699V51H166.603Z" fill="black"/>
+<svg width="480" height="480" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path fill="#3C3C43" d="M0 0h480v480H0z"/>
+  <g clip-path="url(#a)">
+    <rect x="120" y="120" width="240" height="240" rx="8" fill="#F5F5F5"/>
+    <path d="M120 130h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M130 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 140h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M140 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 150h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M150 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 160h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M160 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 170h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M170 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 180h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M180 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 190h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M190 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 200h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M200 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 210h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M210 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 220h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M220 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 230h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M230 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 240h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M240 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 250h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M250 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 260h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M260 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 270h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M270 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 280h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M280 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 290h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M290 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 300h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M300 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 310h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M310 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 320h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M320 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 330h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M330 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 340h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M340 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M120 350h240" stroke="#D8D8D9" stroke-width=".5"/>
+    <path d="M350 120v240" stroke="#D8D8D9" stroke-width=".5"/>
+</g>
+<g id="embed-lucide-layers" stroke="#3C3C43" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" transform="translate(120 120), scale(10)">
+  <path d="M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z" />
+  <path d="M2 12a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 12" />
+  <path d="M2 17a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 17" />
+</g>
+  <g opacity=".5" stroke="#fff" stroke-width="3">
+    <path d="M120 92v16"/>
+    <path d="M360 92v16"/>
+    <path d="M120 100h240"/>
+  </g>
+  <g opacity=".5" stroke="#fff" stroke-width="3">
+    <path d="M387.922 120h-16"/>
+    <path d="M387.922 360h-16"/>
+    <path d="M379.922 120v240"/>
+  </g>
+  <path d="M203.395 86v-3.435l8.025-7.43a30.442 30.442 0 0 0 1.718-1.784c.47-.528.825-1.046 1.068-1.552a3.851 3.851 0 0 0 .363-1.662c0-.66-.151-1.23-.451-1.707a2.964 2.964 0 0 0-1.233-1.112c-.521-.264-1.112-.396-1.773-.396-.69 0-1.291.14-1.805.419-.514.278-.91.678-1.189 1.2-.279.52-.418 1.14-.418 1.86h-4.525c0-1.475.334-2.756 1.002-3.842.668-1.086 1.603-1.927 2.807-2.521 1.204-.594 2.591-.892 4.161-.892 1.615 0 3.02.286 4.217.859 1.203.565 2.139 1.35 2.807 2.356.668 1.005 1.002 2.157 1.002 3.456 0 .852-.169 1.692-.507 2.521-.33.83-.921 1.75-1.772 2.764-.852 1.005-2.052 2.212-3.6 3.621L210 81.95v.154h9.468V86h-16.073Zm18.701-3.963v-3.754l9.412-14.828h3.237v5.196h-1.916l-5.933 9.39v.176h13.375v3.82h-18.175ZM232.917 86v-5.108l.088-1.662V63.454h4.47V86h-4.558Zm10.574 6.34V69.09h4.624v2.841h.209c.205-.455.503-.917.892-1.387.396-.477.91-.873 1.541-1.189.638-.323 1.431-.484 2.378-.484 1.232 0 2.37.323 3.412.969 1.042.638 1.875 1.603 2.499 2.895.624 1.284.936 2.895.936 4.832 0 1.887-.305 3.48-.914 4.778-.602 1.292-1.424 2.272-2.466 2.94-1.035.66-2.194.99-3.478.99-.911 0-1.685-.15-2.323-.451-.631-.301-1.149-.679-1.552-1.134a5.755 5.755 0 0 1-.925-1.398h-.143v9.049h-4.69Zm4.591-14.794c0 1.005.139 1.882.418 2.63.279.75.682 1.332 1.211 1.75.528.412 1.17.617 1.926.617.764 0 1.409-.209 1.938-.627.528-.426.928-1.013 1.2-1.761.279-.756.418-1.626.418-2.61 0-.976-.136-1.834-.407-2.576-.272-.74-.672-1.32-1.2-1.739-.529-.418-1.178-.627-1.949-.627-.763 0-1.409.202-1.937.605-.521.404-.921.976-1.2 1.717-.279.742-.418 1.615-.418 2.62Zm18.34-8.455 3.104 5.912 3.182-5.912h4.81l-4.898 8.455L277.651 86h-4.789l-3.336-5.846-3.28 5.846h-4.844l5.02-8.454-4.844-8.455h4.844Z" fill="#fff"/>
+  <path d="M392.239 251.5v-3.435l8.025-7.43a30.403 30.403 0 0 0 1.718-1.784c.469-.528.825-1.046 1.067-1.552a3.839 3.839 0 0 0 .364-1.662c0-.661-.151-1.23-.452-1.707a2.96 2.96 0 0 0-1.233-1.111c-.521-.265-1.111-.397-1.772-.397-.69 0-1.292.14-1.805.419-.514.278-.91.678-1.189 1.199-.279.522-.419 1.142-.419 1.861h-4.524c0-1.475.334-2.756 1.002-3.842.667-1.086 1.603-1.927 2.807-2.521 1.203-.594 2.59-.892 4.161-.892 1.615 0 3.02.287 4.216.859 1.204.565 2.14 1.35 2.807 2.356.668 1.005 1.002 2.157 1.002 3.456 0 .852-.169 1.692-.506 2.521-.33.83-.921 1.751-1.773 2.764-.851 1.005-2.051 2.212-3.599 3.621l-3.292 3.226v.154h9.467v3.897h-16.072Zm18.701-3.963v-3.754l9.412-14.828h3.237v5.196h-1.916l-5.934 9.39v.176h13.376v3.82H410.94Zm10.821 3.963v-5.108l.088-1.662v-15.775h4.47V251.5h-4.558Zm10.574 6.341v-23.25h4.623v2.84h.21c.205-.455.502-.917.891-1.387.397-.477.91-.873 1.541-1.189.639-.323 1.432-.484 2.378-.484 1.233 0 2.371.323 3.413.968 1.042.639 1.875 1.604 2.499 2.896.624 1.284.936 2.895.936 4.832 0 1.887-.305 3.479-.914 4.778-.602 1.292-1.424 2.272-2.466 2.939-1.035.661-2.194.991-3.479.991-.91 0-1.684-.15-2.323-.451-.631-.301-1.148-.679-1.552-1.134a5.736 5.736 0 0 1-.924-1.398h-.144v9.049h-4.689Zm4.59-14.796c0 1.006.14 1.883.419 2.631.279.749.682 1.333 1.211 1.751.528.411 1.17.616 1.926.616.763 0 1.409-.209 1.938-.627.528-.426.928-1.013 1.2-1.762.278-.755.418-1.625.418-2.609 0-.976-.136-1.834-.407-2.576-.272-.741-.672-1.321-1.2-1.739-.529-.418-1.178-.627-1.949-.627-.763 0-1.409.201-1.937.605-.521.404-.921.976-1.2 1.717-.279.742-.419 1.615-.419 2.62Zm18.341-8.454 3.104 5.911 3.181-5.911h4.811l-4.899 8.454 5.031 8.455h-4.788l-3.336-5.846-3.281 5.846h-4.843l5.02-8.455-4.844-8.454h4.844Z" fill="#fff"/>
+  <defs>
+    <clipPath id="a">
+      <rect x="120" y="120" width="240" height="240" rx="8" fill="#fff"/>
+    </clipPath>
+  </defs>
 </svg>

docs/images/2px-inner-gap.svg

@@ -1,5 +0,0 @@
-<svg width="120" height="120" viewBox="0 0 120 120" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M0 10H120M0 20H120M0 30H120M5 0V120M0 40H120M15 0V120M0 50H120M25 0V120M0 60H120M35 0V120M0 70H120M45 0V120M0 80H120M55 0V120M0 90H120M65 0V120M0 100H120M75 0V120M0 110H120M85 0V120M95 0V120M105 0V120M115 0V120" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M85.33 54.4001C86.3121 54.9683 87.1274 55.7849 87.6943 56.7678C88.2611 57.7507 88.5595 58.8654 88.5595 60.0001C88.5595 61.1347 88.2611 62.2494 87.6943 63.2323C87.1274 64.2152 86.3121 65.0318 85.33 65.6001L44.68 89.1201C43.6983 89.688 42.5842 89.9871 41.4501 89.9871C40.3159 89.9871 39.2018 89.6881 38.2201 89.1202C37.2384 88.5522 36.4238 87.7355 35.8585 86.7523C35.2931 85.7691 34.997 84.6542 35 83.5201V36.4801C34.998 35.3474 35.2944 34.2342 35.8592 33.2524C36.424 32.2706 37.2375 31.4548 38.2176 30.8872C39.1978 30.3196 40.3102 30.0201 41.4429 30.0188C42.5756 30.0175 43.6886 30.3146 44.67 30.8801L85.33 54.4001Z" stroke="black" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
-<circle cx="55" cy="60" r="10" fill="#41B883" fill-opacity="0.2" stroke="#41B883" stroke-dasharray="1 1"/>
-</svg>

docs/images/2px-inner-spacing.svg

@@ -1,86 +0,0 @@
-<svg width="240" height="240" viewBox="0 0 240 240" fill="none" xmlns="http://www.w3.org/2000/svg">
-<g clip-path="url(#clip0_1940_23515)">
-<path d="M0 10H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M10 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 20H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M20 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 30H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M30 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 40H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M40 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 50H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M50 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 60H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M60 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 70H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M70 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 80H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M80 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 90H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M90 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 100H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M100 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 110H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M110 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 120H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M120 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 130H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M130 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 140H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M140 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 150H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M150 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 160H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M160 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 170H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M170 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 180H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M180 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 190H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M190 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 200H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M200 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 210H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M210 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 220H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M220 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M0 230H240" stroke="#D8D8D9" stroke-width="0.5"/>
-<path d="M230 0V240" stroke="#D8D8D9" stroke-width="0.5"/>
-</g>
-<path d="M180 110V60C180 54.6957 177.893 49.6086 174.142 45.8579C170.391 42.1071 165.304 40 160 40C154.696 40 149.609 42.1071 145.858 45.8579C142.107 49.6086 140 54.6957 140 60M140 100V40C140 34.6957 137.893 29.6086 134.142 25.8579C130.391 22.1071 125.304 20 120 20C114.696 20 109.609 22.1071 105.858 25.8579C102.107 29.6086 100 34.6957 100 40V60M100 60V105M100 60C100 54.6957 97.8929 49.6086 94.1422 45.8579C90.3915 42.1071 85.3044 40 80.0001 40C74.6957 40 69.6086 42.1071 65.8579 45.8579C62.1072 49.6086 60.0001 54.6957 60.0001 60V140M180 80C180 74.6957 182.107 69.6086 185.858 65.8579C189.609 62.1071 194.696 60 200 60C205.304 60 210.391 62.1071 214.142 65.8579C217.893 69.6086 220 74.6957 220 80V140C220 161.217 211.572 181.566 196.569 196.569C181.566 211.571 161.217 220 140 220H120C92.0001 220 75.0001 211.4 60.1001 196.6L24.1001 160.6C20.6594 156.789 18.8159 151.802 18.9513 146.669C19.0867 141.537 21.1905 136.653 24.8273 133.03C28.464 129.406 33.3551 127.319 38.4878 127.202C43.6205 127.085 48.6017 128.946 52.4001 132.4L70.0001 150" stroke="black" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
-<rect x="170" y="49" width="74" height="20" transform="rotate(90 170 49)" fill="url(#paint0_linear_1940_23515)"/>
-<rect x="130" y="36" width="74" height="20" transform="rotate(90 130 36)" fill="url(#paint1_linear_1940_23515)"/>
-<rect x="90" y="60" width="74" height="20" transform="rotate(90 90 60)" fill="url(#paint2_linear_1940_23515)"/>
-<rect x="210" y="70" width="74" height="20" transform="rotate(90 210 70)" fill="url(#paint3_linear_1940_23515)"/>
-<rect x="40.1426" y="134" width="74" height="20" transform="rotate(45 40.1426 134)" fill="url(#paint4_linear_1940_23515)"/>
-<defs>
-<linearGradient id="paint0_linear_1940_23515" x1="170" y1="57.5" x2="244" y2="57.5" gradientUnits="userSpaceOnUse">
-<stop stop-color="#41B883" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#41B883"/>
-<stop offset="1" stop-color="#41B883" stop-opacity="0"/>
-</linearGradient>
-<linearGradient id="paint1_linear_1940_23515" x1="130" y1="44.5" x2="204" y2="44.5" gradientUnits="userSpaceOnUse">
-<stop stop-color="#41B883" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#41B883"/>
-<stop offset="1" stop-color="#41B883" stop-opacity="0"/>
-</linearGradient>
-<linearGradient id="paint2_linear_1940_23515" x1="90" y1="68.5" x2="164" y2="68.5" gradientUnits="userSpaceOnUse">
-<stop stop-color="#41B883" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#41B883"/>
-<stop offset="1" stop-color="#41B883" stop-opacity="0"/>
-</linearGradient>
-<linearGradient id="paint3_linear_1940_23515" x1="210" y1="78.5" x2="284" y2="78.5" gradientUnits="userSpaceOnUse">
-<stop stop-color="#41B883" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#41B883"/>
-<stop offset="1" stop-color="#41B883" stop-opacity="0"/>
-</linearGradient>
-<linearGradient id="paint4_linear_1940_23515" x1="40.1426" y1="142.5" x2="114.143" y2="142.5" gradientUnits="userSpaceOnUse">
-<stop stop-color="#41B883" stop-opacity="0"/>
-<stop offset="0.499255" stop-color="#41B883"/>
-<stop offset="1" stop-color="#41B883" stop-opacity="0"/>
-</linearGradient>
-<clipPath id="clip0_1940_23515">
-<rect width="240" height="240" fill="white"/>
-</clipPath>
-</defs>
-</svg>