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

Stencil-built **web components** (`xpl-*`), global CSS (`build/style.css`), and the design-system runtime for Apollo. 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 `core`** for most changes here), PR `Refs:` lines, Foundation tokens, Stencil rules, and Figma workflow links.

## This package (from repo root)

| Task | Command |
|------|---------|
| Build | `nx build @xplortech/apollo-core` |
| Dev server | `npm run dev` or `nx dev @xplortech/apollo-core` |
| Unit tests | `nx test @xplortech/apollo-core` |
| E2E tests | `npm run test.e2e` (or `nx test.e2e @xplortech/apollo-core`) |
| Storybook | `npm run storybook` |
| Lint (all) | `nx lint @xplortech/apollo-core` |
| CSS lint | `nx lint:css @xplortech/apollo-core` |

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

## Public API

- Consumer overview: [README.md](./README.md)
- Interactive docs: [Apollo Storybook](https://xplor-apollo.herokuapp.com/)
- Mintlify component reference: [platform.xplordocs.com/apollo](https://platform.xplordocs.com/apollo) (see [llms.txt](https://platform.xplordocs.com/llms.txt) for AI-oriented indexes)