# Docs

- V1: Documentation for Solar Icons v1, the previous stable release.
  - [Solar Icons](/docs/v1): Documentation for Solar Icons v1, the current stable release.
  - Getting Started
    - [Installation](/docs/v1/getting-started/installation): Install the package for your framework.
    - [Basic Usage](/docs/v1/getting-started/usage): Import and use Solar Icons in React.
    - [Choosing a Package](/docs/v1/getting-started/choosing-a-package): Compare standard vs. performance-optimized Solar Icon packages.
  - Packages
    - [React Performance](/docs/v1/packages/react-perf): Solar Icons for React, optimized for minimal bundle size.
    - [React](/docs/v1/packages/react): Solar Icons for React. Supports dynamic styles and global configuration.
    - [Svelte](/docs/v1/packages/svelte): Svelte 5 components for Solar Icons.
    - [Solid](/docs/v1/packages/solid): SolidJS components for Solar Icons.
    - [React Native](/docs/v1/packages/react-native): Solar Icons for React Native.
    - [Vue](/docs/v1/packages/vue): Solar Icons for Vue. Supports dynamic styles and global configuration.
    - [Nuxt](/docs/v1/packages/nuxt): Solar Icons Nuxt module. Supports auto-import and global configuration.
    - [Angular](/docs/v1/packages/angular): Signal-based components for Solar Icons. Optimized for Angular 17+ with native tree-shaking.
  - Icon Reference
    - [Icon Categories](/docs/v1/icon-reference/categories): Solar includes the following categories with icons available in six styles.
  - Advanced Usage: Learn how to use Solar Icons in your React projects.
    - [Server-Side Rendering (SSR)](/docs/v1/advanced/server-side-rendering): Use Solar Icons in SSR environments like Next.js or Remix.
    - [Global Configuration](/docs/v1/advanced/global-configuration): Configure default icon styles globally.
  - Community
    - [Contributing](/docs/v1/community/contributing): Learn how to contribute to Solar Icons. Report bugs, suggest features, or submit pull requests.
    - [License](/docs/v1/community/license): MIT-licensed for free personal and commercial use. Solar icons by 480 Design under CC BY 4.0, commercial use allowed with credit.
    - [Changelog](/docs/v1/community/changelog): Full release history for all Solar Icons packages.
- V2: Current version with CSS variables, duotone, and one package per framework.
  - [Solar Icons](/docs/v2): 1,451 icons in 6 styles. One package per framework. CSS variables, duotone, and tree-shakable imports.
  - [Figma Plugin](/docs/v2/figma-plugin): Browse, preview, and insert the complete Solar Icons collection in Figma.
  - Packages
    - [React](/docs/v2/packages/react): SolarProvider, useSolar, CSS variables, duotone, and stroke width for React 18+.
    - [Vue](/docs/v2/packages/vue): SolarProvider, useSolar, CSS variables, duotone, and stroke width for Vue 3.0+.
    - [Svelte](/docs/v2/packages/svelte): SolarProvider, useSolar, CSS variables, duotone, and stroke width for Svelte 5.
    - [SolidJS](/docs/v2/packages/solid): SolarProvider, useSolar, CSS variables, duotone, and stroke width for SolidJS 1.6+.
    - [Angular](/docs/v2/packages/angular): SolarProvider, useSolar, CSS variables, duotone, and stroke width for Angular 17+.
    - [React Native](/docs/v2/packages/react-native): React Context-based SolarProvider, duotone, and stroke width for React Native 0.72+. Requires react-native-svg.
    - [Nuxt](/docs/v2/packages/nuxt): Solar Icons Nuxt module. Auto-import of all icon components with a configurable name prefix.
    - [Static](/docs/v2/packages/static): Static assets and utilities for Solar Icons that work without JavaScript frameworks. This package provides individual SVG files, an SVG sprite, and Node.js utilities for server-side string templating.
    - [JS](/docs/v2/packages/js): Vanilla JavaScript library for dynamic DOM injection of Solar Icons using lightweight ASTs.
  - [AI Tools](/docs/v2/ai-tools): Search, inspect, and use Solar Icons from the terminal, MCP clients, and coding agents.
  - Migration to v2
    - [Migration to v2](/docs/v2/migration-to-v2): Step-by-step guides for upgrading from v1 to v2 for every supported framework.
    - [V2 Codemod](/docs/v2/migration-to-v2/codemod): Preview and apply conservative source migrations from Solar Icons v1 to v2.
    - [React-Perf Migration](/docs/v2/migration-to-v2/react-perf): Migrate from @solar-icons/react-perf to @solar-icons/react v2.
    - [React Migration](/docs/v2/migration-to-v2/react): Migrate from @solar-icons/react to v2. Pick the per-style import path by default, the dynamic path for runtime style switching.
    - [Vue Migration](/docs/v2/migration-to-v2/vue): Migrate from @solar-icons/vue to v2. Pick the per-style import path by default, the dynamic path for runtime style switching.
    - [Svelte Migration](/docs/v2/migration-to-v2/svelte): Upgrade @solar-icons/svelte to v2.
    - [SolidJS Migration](/docs/v2/migration-to-v2/solid): Upgrade @solar-icons/solid to v2.
    - [Angular Migration](/docs/v2/migration-to-v2/angular): Upgrade @solar-icons/angular to v2.
    - [React Native Migration](/docs/v2/migration-to-v2/react-native): Upgrade @solar-icons/react-native to v2.
    - [Nuxt Migration](/docs/v2/migration-to-v2/nuxt): Upgrade @solar-icons/nuxt to v2.
    - [Icon Renames](/docs/v2/migration-to-v2/icon-renames): Icons renamed in v2. Old names are no longer exported.
  - Icon Reference
    - [Categories](/docs/v2/icon-reference/categories): All 1,451 icons organized across 30+ categories.
  - Advanced
    - [Global Styling](/docs/v2/advanced/global-styling): How Solar Icons handles styling, CSS variable cascade, priority rules, provider nesting, and isolated mode.
    - [Accessibility](/docs/v2/advanced/accessibility): ARIA attributes, alt text, and how Solar Icons handles accessibility by default.
    - [Global Configuration](/docs/v2/advanced/global-configuration): Configure default icon styles with SolarProvider and useSolar.
  - Community
    - [Contributing](/docs/v2/community/contributing): Learn how to contribute to Solar Icons. Report bugs, suggest features, or submit pull requests.
    - [License](/docs/v2/community/license): MIT-licensed for free personal and commercial use. Solar icons by 480 Design under CC BY 4.0, commercial use allowed with credit.
    - [Changelog](/docs/v2/community/changelog): Full release history for all Solar Icons packages.