+1
Daily
8,782
stars
848
forks
142
watchers
975
prs
318
issues
187
releases
README
!octicons cover light
!octicons cover dark
Primer Octicons
Octicons are a set of SVG icons built by GitHub for GitHub.
Libraries
This repository contains several libraries. Each of them is in the lib/ folder and gives access to Octicons on a different platform/language.
JavaScript
The octicons node.js library is the main JavaScript library. With a JavaScript API that can be used in a variety of applications.
| Package | Version |
| ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| @primer/octicons Node.js package with JavaScript API | |
| @primer/octicons-react React Octicons components | |
| @primer/styled-octicons React Octicons components with Styled System props | |
Ruby
| Package | Version |
| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| octicons Ruby gem with Ruby API | |
| octicons_helperRails helper for using octicons | |
| jekyll-octiconsJekyll plugin for using octicons | |
Icon names and compatibility
The shape-based triangle, triangle-circle, and triangle-fill names follow the square family. Each provides 16px and 24px artwork. git-pull-request-unlisted provides 16px artwork.
| Canonical name | Compatibility name | Preserved behavior |
| ----------------- | ------------------------------ | --------------------------------------------------------------------------- |
| bookmark-fill | bookmark-filled (deprecated) | The old name retains its 16px drawing at every display size. |
| repo-delete | repo-deleted (deprecated) | The old name retains its 16px drawing at every display size. |
| triangle-circle | play (supported) | The old name retains both original circled drawings, not the bare triangle. |
Compatibility names retain their exports, CSS classes, symbol IDs, and published build/svg paths. An aliasOf property identifies the canonical name in icon data; deprecated: true separately marks a deprecated alias. Catalogues can filter aliasOf entries without removing legacy lookups.
The canonical bookmark-fill and repo-delete names now provide both naDiscussions
#1066Confusing Sort Icons0 comments · 2025-02-04#1059Planet Earth1 comments · 2025-01-01#741Can I use 16px version only and disable switching to 24px version?1 comments · 2022-02-11
Latest release
@primer/[email protected] @primer/[email protected] 2026-10-23Minor Changes - 1381 d25ce68df9d08abd65431a8a48b45446432f1b45 Thanks @edokoa! - Add the 16px git-draft-agent, git-pull-request-agent, check-agent, git-que-merge-agent, git-closed-agent, and git-merge-agent icons for agent-assisted draft, open, ready-to-merge, queued, closed, and merged pull request states.