# no-icons-in-buttons

no-icons-in-buttons — a Claude Code rule that keeps button content text-only by default. The agent adds an icon only when the user explicitly asks for one.

- rule · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1120 repo stars
- Author: rerun-build
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rerun-build/rerun/tree/HEAD/apps/ui/.cursor/rules/no-icons-in-buttons.mdc
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/rules/no-icons-in-buttons

## What it does

The rule tells the agent to leave icons out of buttons unless the user specifically requests one. Button labels stay as text by default.

It covers every button component, including Shadcn UI Button and custom implementations. In Claude Code, place the rule file at `.claude/rules/no-icons-in-buttons.md`.

## Install

### Cursor (native platform)

**Manually: put the files in place**
- File: `.cursor/rules/no-icons-in-buttons.mdc` — Frontmatter: description, globs, alwaysApply

### Claude Code

**Manually: put the files in place**
- File: `.claude/rules/no-icons-in-buttons.md` — The paths frontmatter field limits the files: move globs from the source into paths

### Codex

**AGENTS.md**
- Codex reads AGENTS.md: paste the rule text there

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/instructions/no-icons-in-buttons.instructions.md` — The applyTo field sets which files it applies to: move globs from the source into applyTo

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/rules/no-icons-in-buttons.md`

### Cline

**Manually: put the files in place**
- File: `.clinerules/no-icons-in-buttons.md`

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/rerun-build/rerun/tree/HEAD/apps/ui/.cursor/rules/no-icons-in-buttons.mdc

## When to use it
- remove an icon from a button
- keep button labels text-only
- apply the same icon rule to Shadcn UI Button and custom buttons

## Example prompts
- Create an “Add item” button without an icon.
- Remove the icon from the save button.
- Make this action a text-only button.

## Similar
- [buttons-ctas](https://affpapa.org/en/nevibecode/skills/buttons-ctas.md) — skill · 628 installs
- [suggest-lucide-icons](https://affpapa.org/en/nevibecode/skills/suggest-lucide-icons.md) — skill · 653 installs
- [icons-badges](https://affpapa.org/en/nevibecode/skills/icons-badges.md) — skill · 609 installs
- [Vadivam Icons](https://affpapa.org/en/nevibecode/mcp/vadivam-icons.md) — MCP server · ★ 14 repo stars
- [Generative Icons](https://affpapa.org/en/nevibecode/mcp/generative-icons.md) — MCP server · ★ 7 repo stars
- [syncfusion-react-buttons](https://affpapa.org/en/nevibecode/skills/syncfusion-react-buttons.md) — skill · 708 installs

From the same set: [rerun-build/rerun](https://affpapa.org/en/nevibecode/by/rerun-build/rerun.md) — 25 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
