🤖 @viasat/beam-react-claude-plugin

A Claude Code plugin that keeps Claude honest about the Beam Design System. Instead of guessing component names, props, and tokens, Claude pulls them from Beam's own sources.

✨ What it does

Inside any project that depends on @viasat/beam-react, the plugin adds:

| Skill | Type | Purpose | | --------- | ------------ | -------------------------------------------------------------------------------------------------------------------- | | beam-ui | Auto-invoked | Build, modify, refactor, or debug UI using Beam components — and answer questions or give recommendations about Beam |

Each skill carries a short critical-rules block (the source-of-truth hierarchy, token rules, and composition rules) and defers to references/rules-preamble.md for the full procedure. The plugin also runs the Beam MCP server via npx, which gives Claude structured tool access to component props, stories, and concept docs.

⬇️ Installing it

Note: /plugin commands are Claude Code slash commands. Run them inside the Claude Code CLI, not in a raw terminal, the desktop app, or the VS Code Claude extension.

🏢 Via Beam internal Claude plugin marketplace

On VPN, add the Beam repo as a marketplace:

/plugin marketplace add [email protected]:vega/beam.git
/plugin install beam-react-claude-plugin

📦 Via npm

Off VPN, install the npm package in your terminal first:

npm install --save-dev @viasat/beam-react-claude-plugin

Then run these commands inside the Claude Code CLI:

/plugin marketplace add ./node_modules/@viasat/beam-react-claude-plugin
/plugin install beam-react-claude-plugin@beam

🔄 Updating

🏢 Via Beam internal Claude plugin marketplace

To update on VPN use:

/plugin update beam-react-claude-plugin

Then run /reload-plugins in the Claude Code CLI.

📦 Via npm

Off VPN, update the npm package and then the marketplace:

npm i @viasat/beam-react-claude-plugin@latest

/plugin marketplace update beam

Then run /reload-plugins in the Claude Code CLI.

🖥️ Non Claude Code users

On a different editor? The MCP runs on its own, no plugin required — see @viasat/beam-react-mcp.

✅ Requirements

• A project with @viasat/beam-react in package.json dependencies (skills check this before activating).
• Node.js and npm/npx available to run the @viasat/beam-react-mcp server (primary).
• Network access to https://react.beam.viasat.com/llms.txt (fallback when the MCP server is unavailable).

📄 License

MIT. © Viasat.