# 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
- Package `exports` map: `.` (client bindings), `./server` (SSR bindings → `dist/components/stencil-generated/components.server.js`), `./css/*` (style proxies), plus `./dist/*` and `./package.json` passthroughs for backwards compatibility. The generated `dist/` layout is internal — new consumer-facing entries belong in the `exports` map, not in documented deep imports.

## CSS proxy files

Committed one-line `@import` proxies under `css/` re-export `@xplortech/apollo-core` modular CSS via the `./css/*` subpath export. Per-component treeshake CSS is **not** proxied — consumers import `@xplortech/apollo-core/css/components/*` directly.