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

**React** bindings for Apollo web components generated from `@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 `react`**), PR `Refs:` lines, and shared design-system rules.

## This package (from repo root)

| Task | Command |
|------|---------|
| Build | `nx build @xplortech/apollo-react` |
| TypeScript compile | `nx tsc @xplortech/apollo-react` |
| Tests (smoke) | `nx test @xplortech/apollo-react` |
| Tests (SSR runtime) | `nx test:ssr @xplortech/apollo-react` (requires `nx build @xplortech/apollo-react`) |
| Clean | `nx clean @xplortech/apollo-react` |

There is no per-package lint target; lint runs at the workspace level via `npm run lint`. Proxy types are validated by `tsc`. Smoke tests assert committed Stencil bindings under `src/` (no preceding `apollo-core` build).

**Nx Release group:** `core` (released together with `apollo-core` and `apollo-vue`).

## Public API

- Usage and examples: [README.md](./README.md)
- Depends on `@xplortech/apollo-core` for runtime and styles

## CSS proxy files

Committed one-line `@import` proxies under `css/` re-export `@xplortech/apollo-core` modular CSS without an `exports` field (subpaths resolve by file path). Per-component treeshake CSS is **not** proxied — consumers import `@xplortech/apollo-core/css/components/*` directly.