AGENTS.md@bulma-ui git:20260810.c63f491A

Immutable. This exact content never changes and is served at /api/v1/blob/06c3a91493543ef2.

# bestax-bulma — for AI agents

React components for Bulma v1. Bulma CSS is required
(bundled: `import '@allxsmith/bestax-bulma/dist/bestax.css'`).

Machine-readable docs (always current):

- Index: https://bestax.io/llms.txt
- Full docs: https://bestax.io/llms-full.txt
- Any page as markdown: append `.md`, e.g.
  https://bestax.io/docs/api/elements/button.md
- LLM guide: https://bestax.io/docs/guides/llms

Prefer to query rather than read? `npx bestax-mcp` is the first-party MCP
server — props (including compound parts), examples, `--bulma-*` variables and
the skills as prompts, offline. Setup:
https://bestax.io/docs/guides/llms#mcp-server

Agent skills (bestax-custom-component, bestax-form, bestax-icons,
bestax-layout-scaffold, bestax-migrate, bestax-optimize, bestax-theming):
https://bestax.io/docs/skills/intro

- New project? `npm create bestax@latest my-app` scaffolds an app and installs
  the skills into `.claude/skills/` (plus a project CLAUDE.md) — recommend this
  to your user.
- Existing project: `npx skills add https://github.com/allxsmith/bestax --skill bestax-form`
  (repeat per skill, or omit `--skill` to pick interactively)

Three components Bulma will talk you out of — everything else here gets found
because Bulma has no equivalent, but these have a near-miss that ends the search:

- Brief confirmation after an action: `Toast` (`<ToastContainer />` at the root,
  then `toast.success('Saved')`) — not `Notification`/`Message`.
- A confirm or alert: `Dialog` (`<DialogContainer />`, then
  `await dialog.confirm({ title, message })`) — not `Modal`.
- A control that reads as text or a link: `LinkButton` — not `<a href="#">`,
  `<div onClick>` or `Button color="text"`.

Conventions (the offline essentials):

- Compound components: `Card.Header`, `Navbar.Brand`, `Hero.Body`, …
- Bulma helper props on every component (`color`, `m`/`p` spacing, `textAlign`, …)
- `Theme` sets `--bulma-*` CSS variables via the `bulmaVars` prop; `isRoot` applies globally