Iconoir Documentation

repository·main·Indexed 26 days ago

https://github.com/iconoir-icons/iconoir

An open-source library providing over 1600 unique SVG icons designed on a 24x24 pixel grid. Iconoir supports multiple platforms and frameworks, including Web (CSS/JS), React, React Native, Vue, Flutter, Solid.js, Framer, and Swift. It offers dedicated packages such as iconoir-react, iconoir-react-native, @iconoir/vue, iconoir_flutter, and iconoir-solid-js, as well as a CSS CDN for web projects.

Tokens
3.8K
Snippets
21
Records
38
Agent score
88%

What's inside Iconoir

  1. Use Iconoir in Framer

    main

    Iconoir is integrated into Framer. To use the icons in your project:

    1. Open the top menu in Framer.
    2. Navigate to Insert > Graphics > Iconoir.
    3. Once added, you can browse and switch between different icons using the right sidebar in the Framer editor.
  2. Add Iconoir to Xcode via Swift Package Manager

    main

    To add Iconoir-swift to your Xcode project:

    1. Navigate to File > Swift Packages > Add Package Dependency... in Xcode.
    2. Enter the repository URL: https://github.com/iconoir-icons/iconoir-swift.git.
    3. Choose your desired branch or version.
    4. Select your target and click Finish.
  3. Use Iconoir via CSS

    main
    To use icons in a web project via CSS, include the stylesheet from the CDN and use the class naming convention iconoir-{icon-name}. Icons are display: inline-block and inherit the current font size. You can control size and color by adjusting the ::before styles of the element.
  4. Follow object-oriented naming conventions

    main

    Icon names are designed to be object-oriented rather than action-oriented. Avoid using verbs that describe an action unless the icon represents a physical movement.

    Correct (Object-Oriented):

    • user-minus (describes the state/object)

    Incorrect (Action-Oriented):

    • remove-user (describes the action)

    Exception (Physical Actions): Icons representing physical movement or actions can embed the action in the name:

    • walking
    • running
    • vehicle-fast
    • crane-lifting
  5. Understand the Iconoir naming hierarchy

    main

    Iconoir icons follow a specific hierarchical naming structure to ensure consistency. The base pattern is:

    [Object]-[Modifier]-[Container]

    • [Object]: The primary subject of the icon (e.g., user).
    • [Modifier]: A secondary element or unique addition (e.g., -minus, -warning).
    • [Container]: A shape that holds the object (e.g., -square, -circle). Note that if a shape is an integral part of the object itself, it is not treated as a container.

    Example distinction:

    • user-minus: user is the object, minus is the modifier.
    • minus-square: minus is the object, square is the container.
    [Object]-[Modifier]-[Container]