Phosphor Icons

A flexible icon family for interfaces, diagrams, presentations

Icon setReactReact NativeVueWeb Components
phosphor-icons/homepagephosphoricons.com @phosphor-icons/react

README

Phosphor Icons


Phosphor is a flexible icon family for interfaces, diagrams, presentations — whatever, really.

- 1,248 icons and counting
- 6 weights: Thin, Light, Regular, Bold, Fill, and Duotone
- Designed at 16 x 16px to read well small and scale up big
- Raw stroke information retained to fine-tune the style

More ways to use at phosphoricons.com.

For developers


Phosphor is available for web, React, Vue, Flutter, Elm, and other frameworks and platforms.

Vanilla Web


- **Simple to use** – We use a similar approach as many other icon sets out there, providing icons as a webfont that uses Unicode's Private Use Area character codes to map normally non-rendering characters to icons. But you don't need to know that. All you need to do is add the script to the document ``, and drop in icons with an `` tag and the appropriate class:

  1. ```html
  2. <!DOCTYPE html>
  3. <html>
  4.   <head>
  5.     <script src="https://unpkg.com/@phosphor-icons/web"></script>
  6.   </head>
  7.   <body>
  8.     <i class="ph-smiley"></i>
  9.     <i class="ph-fill ph-heart" style="color: hotpink"></i>
  10.     <i class="ph-thin ph-cube"></i>
  11.   </body>
  12. </html>
  13. ```

Check out the full documentation on the @phosphor-icons/web repo page.

React


- Powerful – Phosphor's intuitive but powerful API can style the color, size, and weight of an icon with a few keystrokes, provide default styles to all icons via the Context API, or directly manipulate the SVG at runtime through render props to do some amazing things! Check out the full documentation on the @phosphor-icons/react repo page.

  1. ```jsx
  2. import React from "react";
  3. import ReactDOM from "react-dom";
  4. import { Smiley, Heart, Horse } from "@phosphor-icons/react";

  6. const App = () => {
  7.   return (
  8.     <div>
  9.       <Smiley />
  10.       <Heart size={32} color="hotpink" weight="fill" />
  11.       <Horse weight="duotone" />
  12.     </div>
  13.   );
  14. };

  16. ReactDOM.render(<App />, document.getElementById("root"));
  17. ```

- Lightweight – Supports tree-shaking, so your bundle only includes code for the icons you use.
- Flexible – Icon Components are a transparent wrapper around SVG elements, so feel free to add your own inline style objects, onClick handler functions, and a multitude of other props you're used to using on SVGs.

Vue


- Parity – As with React, you can manipulate the color, size, and weight of an icon with a few keystrokes, or provide default styles to all icons via the provide/inject API. It is fully tree-shakable and ready to use right away. Check out the full documentation on the @phosphor-icons/vue repo page.

  1. ```html
  2. <template>
  3.   <div>
  4.     <ph-horse />
  5.     <ph-heart :size="32" color="hotpink" weight="fill" />
  6.     <ph-cube />
  7.   </div>
  8. </template>
  10. <script>
  11.   import { PhHorse, PhHeart, PhCube } from "phosphor-vue";
  12.   export default {
  13.     name: "App",
  14.     components: {
  15.       PhHorse,
  16.       PhHeart,
  17.       PhCube,
  18.     },
  19.   };
  20. </script>
  21. ```

Note: Due to possible namespace collisions with built-in HTML elements, compononent names in the Vue library are prefixed with Ph, but otherwise follow the same naming conventions. Both Pascal and kebab-case conventions can be used in templates.


Our Related Projects


- @phosphor-icons/core ▲ Phosphor icon assets and catalog
- @phosphor-icons/react ▲ Phosphor icon component library for React
- @phosphor-icons/web ▲ Phosphor icons for Vanilla JS
- @phosphor-icons/vue ▲ Phosphor icon component library for Vue
- @phosphor-icons/elm ▲ Phosphor icons for Elm
- @phosphor-icons/flutter ▲ Phosphor IconData library for Flutter
- @phosphor-icons/webcomponents ▲ Phosphor icons as Web Components
- @phosphor-icons/figma ▲ Phosphor icons Figma plugin
- @phosphor-icons/sketch ▲ Phosphor icons Sketch plugin

Community Projects


- phosphor-react-native ▲ Phosphor icon component library for React Native
- phosphor-svelte ▲ Phosphor icons for Svelte apps
- phosphor-r ▲ Phosphor icon wrapper for R documents and applications
- blade-phosphor-icons ▲ Phosphor icons in your Laravel Blade views
- wireui/phosphoricons ▲ Phosphor icons for Laravel
- phosphor-css ▲ CSS wrapper for Phosphor SVG icons

If you've made a port of Phosphor and you want to see it here, just open a PR here!

License


MIT © Phosphor Icons