Skip to content

feat: add initial iconography guidelines and starter set#131

Open
hriszc wants to merge 2 commits into
asyncapi:masterfrom
hriszc:codex/iconography-system
Open

feat: add initial iconography guidelines and starter set#131
hriszc wants to merge 2 commits into
asyncapi:masterfrom
hriszc:codex/iconography-system

Conversation

@hriszc

@hriszc hriszc commented Mar 10, 2026

Copy link
Copy Markdown

Fixes #119

This is a first structured pass at a unified iconography system for AsyncAPI:

  • add a dedicated iconography guideline page under the brand docs
  • define shared grid, stroke, color, and contribution rules
  • seed the system with four reusable SVG icons for core platform concepts: event, channel, broker, and schema
  • link the new section from the main brand guideline index

This keeps the first PR intentionally small so the visual language can be reviewed before expanding the full icon library.

@thulieblack

Copy link
Copy Markdown
Member

@Mayaleeeee

@Mayaleeeee

Copy link
Copy Markdown
Member

@Mayaleeeee

I am on it

@@ -0,0 +1,57 @@
# Iconography documentation and usage guidelines

This guide defines a starting point for a unified AsyncAPI icon system that can be used across marketing surfaces and tooling UIs.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add the AsyncAPI Design system (the icon page) link here - ttps://www.figma.com/design/cFsY4LCfKmDqdlaTIJPpA1/AsyncAPI-Design-System?node-id=354-2046&p=f&t=CINUpbY33cZmalFG-0

- Make the set usable in both product interfaces and editorial/marketing layouts.

## Core style rules

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Check the Figma guideline here - to update this section

- Prefer rounded joins and rounded line caps.
- Build icons from circles, straight segments, and soft radii rather than sharp ornamental detail.
- Keep fills optional; default to outline-first icons.
- Avoid mixing multiple stroke weights inside one icon.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Check the Figma guideline here - to update this section


These icons are meant to establish the visual language before expanding the full library.

## Contribution guidance

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Check the Figma guideline here - to update this section

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create a Unified Iconography System for Marketing & Tooling

3 participants