@aquera/nile-glyph
Icon components and glyph data for the Nile Design System.
Installation
npm install @aquera/nile-glyph
# or
yarn add @aquera/nile-glyph
Usage
Basic Usage
Import and use the <nile-glyph> web component:
<nile-glyph name="alert"></nile-glyph>
The component self-registers as a custom element when imported:
import '@aquera/nile-glyph';
Properties
| Property | Type | Default | Description |
|---|---|---|---|
name | string | — | The name of the icon to display |
set | string | 'local' | The icon set to use |
size | number | 16 | Icon size in pixels |
color | string | — | Icon fill color |
method | string | 'fill' | Rendering method ('fill' or 'stroke') |
description | string | '' | Accessible description for the icon |
push | boolean | false | Adds right margin spacing |
noFill | boolean | false | Prevents fill from being applied to paths |
frame | string | — | Custom viewBox dimensions |
customSvgPath | string | — | URL to a custom SVG file to load |
Examples
<!-- Icon with custom size and color -->
<nile-glyph name="alert" size="24" color="#ff0000"></nile-glyph>
<!-- Stroke-based icon -->
<nile-glyph name="calendar" method="stroke"></nile-glyph>
<!-- Icon with accessible description -->
<nile-glyph name="close" description="Close dialog"></nile-glyph>
<!-- Custom SVG from URL -->
<nile-glyph customSvgPath="/assets/my-icon.svg"></nile-glyph>
CSS Custom Properties
| Property | Description |
|---|---|
--nile-svg-height | Icon height |
--nile-svg-width | Icon width |
--nile-svg-fill | Icon fill color |
--nile-svg-stroke | Icon stroke color |
--nile-svg-stroke-width | Icon stroke width |
--nile-spacing-lg | Push margin spacing |
Programmatic Imports
// Import the component class
import { NileGlyph } from '@aquera/nile-glyph';
// Import individual icon SVG data
import * as Icons from '@aquera/nile-glyph/icons';
// Import the alias map
import { aliasMap } from '@aquera/nile-glyph';
Exports
| Entry Point | Description |
|---|---|
@aquera/nile-glyph | Main entry — NileGlyph, aliasMap, Icons |
@aquera/nile-glyph/icons | Individual icon SVG data (base64) |
@aquera/nile-glyph/nile-glyph | NileGlyph component only |
Development
This repo (aquerateam/nile-glyph-registry) holds the package at its root and the
glyph intake Slack bot (Nirman) in bot/. Both moved here from
aquerateam/design-system on October 27, 2026, history included.
yarn install --frozen-lockfile
yarn build # runs prebuild: icon files + tokens from assets/source/*.svg
yarn package # CDN bundle (dist/index.js)
yarn test
- New icons go in
assets/source/as SVGs, usually through the bot: an upload in Slack opens aglyph/*branch, whose pipeline builds the icon files, bumps the patch version and adds the release-notes entry below. - A version change merged to
masterpublishes to npm and toui-cdn.dev.aqueralabs.com/nile-glyph/<version>/. Arelease/*branch publishes to/nile-glyph/release/. - The bot deploys only through the custom pipeline
foundation-builder-deploy(seebot/deploy/).
Release Notes
In this section, you can find the updates for each release of @aquera/nile-glyph. It's a good practice to maintain detailed release notes to help users and developers understand what changes have been made from one version to another and how these changes might affect their projects.
Version 1.0.13 (October 30, 2026)
- Nile Glyph: Added New NxtGen Icon -
ng-bar-chart-error(UIF-1404)
Version 1.0.12 (October 28, 2026)
- Nile Glyph: Added New NxtGen Icon -
ng-hurricane-01(UIF-1402)
Version 1.0.11 (October 28, 2026)
- Nile Glyph: Added New NxtGen Icon -
ng-gift-02(UIF-1401)
Version 1.0.10 (October 27, 2026)
- Nile Glyph: Added New NxtGen Icon -
ng-star-04(UIF-1399)
Version 1.0.9 (October 23, 2026)
- Nile Glyph: Added New NxtGen Icon -
ng-array-integer(UIF-1394) - Nile Glyph: Added New NxtGen Icon -
ng-array-objects(UIF-1394) - Nile Glyph: Added New NxtGen Icon -
ng-array-strings(UIF-1394)
Version 1.0.8 (October 05, 2026)
- Nile Glyph: Added 1 New NxtGen Icon -
ng-ai-prompt(UIF-1376)
Version 1.0.7 (June 30, 2026)
- Nile Glyph: Added 2 New NxtGen Icons (UIF-1283)
Version 1.0.6 (June 01, 2026)
- Nile Glyph: Added 3 New NxtGen Icons (UIF-1248)
Version 1.0.5 (May 29, 2026)
- Nile Glyph: Added 21 New NxtGen Icons (UIF-1244)
Version 1.0.4 (May 28, 2026)
- Nile Glyph: Added 21 New NxtGen Icons (UIF-1241)
Version 1.0.3 (April 27, 2026)
- Nile Glyph: Added 21 New NxtGen Icons (UIF-1202)
Version 1.0.2 (April 15, 2026)
- Nile Glyph: Added Sql Server and Open Search Glyph (UIF-1183)
Version 1.0.1 (April 07, 2026)
- Nile Glyph: Added Colorize Glyph (UIF-1175)
Version 1.0.0 (March 26, 2026)
- Created Nile Glyph Component.
- 2200+ Glyphs(Icons) available out of the box.