BA Icons packages
The Black Atmosphere Design System's icons, marks and illustrations, as packages you can install: core (the interface icons), illustrations (every other group), and the Vanilla, Astro, React and Vue adapters. Browse the icons.
1. Point your project at this registry
Add this to the .npmrc beside your package.json. It applies to these packages only; everything else still comes from npm.
@ba-icons:registry=https://icons.atmosphere.africa/npm/
2. Install
npm install @ba-icons/react pnpm add @ba-icons/react yarn add @ba-icons/react bun add @ba-icons/react
pnpm holds back packages released in the last day. Installing one sooner still works: pnpm records the exemption in your pnpm-workspace.yaml by itself.
Packages
| Package | Latest | Released | Needs |
|---|---|---|---|
@ba-icons/astroBA Icons for Astro: the <Icon name="lock" /> component, rendered on the server with no client JavaScript | 0.4.0also 0.3.0, 0.2.0, 0.1.0 | 2026-11-13 | astro >=5.0.0 |
@ba-icons/coreBA Icons core: the Black Atmosphere interface glyphs (BA Icons / Standard 01) as typed data, SVG strings, SVG files and a sprite | 0.4.0also 0.3.0, 0.2.0, 0.1.0 | 2026-11-13 | |
@ba-icons/illustrationsThe Black Atmosphere Design System's illustrations and marks: Brands, Custom Software, Smart Home, Cleaning, Laundry, Office Work, Business, Engineering, Hosting, Payments, Stack, Blockchain, Distribution, Media, People, Animals and Concepts | 0.4.0also 0.3.0, 0.2.0 | 2026-11-13 | |
@ba-icons/reactBA Icons for React: the <Icon name="lock" /> component | 0.4.0also 0.3.0, 0.2.0, 0.1.0 | 2026-11-13 | react >=18.0.0 |
@ba-icons/vanillaBA Icons for plain HTML and JavaScript: createIcon, replaceIcons, the <ba-icon> element, and a script for pages without a build step | 0.4.0also 0.3.0, 0.2.0, 0.1.0 | 2026-11-13 | |
@ba-icons/vueBA Icons for Vue 3: the <Icon name="lock" /> component | 0.4.0also 0.3.0, 0.2.0, 0.1.0 | 2026-11-13 | vue ^3.3.0 |