# AGENTS.md — `@xplortech/apollo-icons`

**Icon assets and metadata** consumed by `xpl-icon` in `@xplortech/apollo-core`. Part of the Apollo monorepo: https://github.com/xplor/apollo

## Conventions

See the root [AGENTS.md](https://github.com/xplor/apollo/blob/main/AGENTS.md) for npm-only workflows, Conventional Commits (**scope `icons`**), PR `Refs:` lines, and component reuse rules (`xpl-icon` only in UI).

## This package (from repo root)

| Task | Command |
|------|---------|
| Build | `nx build @xplortech/apollo-icons` |
| Tests (vitest) | `nx test @xplortech/apollo-icons` |
| Lint | `nx lint @xplortech/apollo-icons` |

`build` runs the icon-source pipeline (`processSvgJson` → `svgo` → manifest build → type generation) automatically via Nx prebuild/postbuild hooks.

**Nx Release group:** `icons` (tag pattern `icons@{version}`).

## Public API

- Naming and contributor workflow: [README.md](./README.md), [CONTRIBUTING.md](./CONTRIBUTING.md)
- Icon preview in Storybook: see package `homepage` in `package.json`