About the collection

GHIcons gathers Ghanaian symbols in one place and standardises them, so developers stop hunting across the web for a usable copy. This page covers what the collection takes in, how the project handles meanings, and how to help.

What the collection takes in

Every symbol that is Ghanaian or belongs to Ghanaian life — not only the cultural ones. Adinkra is where the collection started and remains the largest part, but the scope also covers the currency, national and state emblems, and the marks of Ghanaian movements and organisations. Ghanaian brands are a longer-term ambition, and the one needing most care, since trademarks belong to their owners.

The thread is not that a symbol is old or ceremonial. It is that someone building software for Ghana would reasonably want it, and should not have to go looking for it.

What Adinkra symbols are

Adinkra are visual symbols of Akan origin, associated most closely with the Asante of Ghana. Each one stands for a concept, a proverb or an aphorism — Gye Nyame for the supremacy of God, Sankofa for learning from the past, Dwennimmen for humility together with strength.

They are traditionally printed onto cloth with stamps carved from calabash, arranged in a grid and divided by lines drawn with a comb. That grid is where the shape of this site's home page comes from, and it is also why the symbols translate so readily into icons: they were designed to be stamped, repeated, and read at a glance.

What is in the collection

Adinkra 103

The largest part of the collection, and the best documented. Traditional Akan symbols, each carrying a specific meaning.

National 2

Symbols representing Ghana as a nation. Several national emblems are multicolour in life; the collection is monochrome for now, so they ship as silhouettes until colour support lands.

General 1

Ghanaian concepts and objects outside the Adinkra canon — currency, everyday iconography, and the things that do not fit elsewhere. This is the category with the most room to grow.

On meanings and accuracy

These are real cultural symbols, so getting them wrong has a cost. An icon with perfect geometry and the wrong name or meaning spreads misinformation about Ghanaian culture, and it does it at the scale of every app that installs the package.

So the project holds to a few rules. Meanings come from reliable sources, not from what sounds plausible. Where interpretations differ, that is said plainly rather than one reading being presented as settled. And where nobody has done the research yet, the icon says so instead of inventing something.

Documented meanings so far: 0 of 106.

That is the honest state of the collection today. The field is there in the registry and waiting to be filled, and moving that number is the most useful thing anyone can do here. Read the cultural guidelines

How to contribute

Most of what this project needs is not code. Pick whichever of these fits you.

Research a symbol's meaning

Take a symbol that has no recorded meaning, find reliable sources, and write up what it represents with citations. No code, no design tools. This is the work the collection is most short of.

Open an issue with what you find

Draw a symbol

Add a Ghanaian symbol that is missing. You supply one SVG on a 24×24 canvas using currentColor — the project generates every package from it, so you never write framework code.

Read the icon specification

Request or correct one

Know a symbol that should be here — cultural, national, commercial, anything Ghanaian — or spot one that is named or drawn wrongly? Say so. Corrections to existing icons are as valuable as new ones.

Request a symbol

Build an integration

Vue, Svelte, Web Components and Flutter are all planned and all unclaimed. An integration is a generator over the existing collection, not a redraw of 106 icons.

Read the architecture

What is coming

GHIcons is pre-1.0. The icon collection and the React API are usable now; the pieces below are in progress or planned.

  • NextDocumented meanings, search keywords and alternate names for the whole collection
  • NextAutomated tests across the generation pipeline
  • 1.0A stable icon specification, registry format and React API
  • LaterMore of the collection — ceremonial objects, the coat of arms, Kente-inspired motifs
  • LaterMulticolour support, so symbols that are not monochrome in life can be represented faithfully
  • LaterVue, Svelte, Web Components and Flutter packages

The full roadmap, with everything it depends on, lives in the repository.