Skip to main content

Iconography

Icons are the visual throughline from product to brand. Octicons, our open source icon library, is one of our most essential and stable brand elements. It's included in Primer, with icons meant to primarily serve GitHub's needs across product.

Octicons

Octicons, our product icon library, are our default icon. Their usage and brand equity help strengthen and reaffirm our commitment to consistency and dependability in brand. We support these icons with a set of larger illustration-like spot icons.

A grid of Octicon icons showing the variety of icons available in the library.

See Primer’s Octicon documentation for a complete look at this library and its optical sizes.

Spot icons

Our spot icons build from our gitline shape library, taking the timeline and commit circle and bending them into the shape of our well known product icons. This set isn’t a replacement for octicons and shouldn’t be used in small sizes.

A grid of spot icons showing larger illustrative versions of common icons.

Usage

Octicons are our open source icons that are typically used in the GitHub product. In a brand context, we use them to give text visual flare and a relationship to it’s content, such as custom bullet points or bento box flairs in our blog.

Three content cards showing Engineering, GitHub Copilot, and ReadMe Project with icons.

Icons occasionally get woven into our keyart to help distinguish content from one another. The art and the mascots should always take center stage, allowing icons to add a semantic layer or serve as a decoration.

A 3D illustration showing icons woven into a layered composition with the Copilot mascot.

Outside of navigation and product icon lockups, Spot icons can add style and topical meaning to content and card layouts. Try to keep the color palettes restrained to neutrals, primary hero and secondary heroes, as color ratios are not as easily expressed.

Four examples of octicons used in brand contexts showing stats and metrics.

When the visual is more abstract and restrained, Spot icons can be a simple device for connecting the visual to the topic.

Example of icons used in a marketing composition with text about AI capabilities.