no-icons-in-buttons — Claude Code rule: install
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.
AGPL-3.0 ★ 1,120 updated 2026-11-16
.cursor/rules/no-icons-in-buttons.mdcWhat no-icons-in-buttons 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.
What it helps with
- 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 for the agent
- Create an “Add item” button without an icon.
- Remove the icon from the save button.
- Make this action a text-only button.
How to install no-icons-in-buttons
Manually: put the files in place
.cursor/rules/no-icons-in-buttons.mdcFrontmatter: description, globs, alwaysApply
Manually: put the files in place
.claude/rules/no-icons-in-buttons.mdThe paths frontmatter field limits the files: move globs from the source into paths
AGENTS.md
Codex reads AGENTS.md: paste the rule text there
Manually: put the files in place
.github/instructions/no-icons-in-buttons.instructions.mdThe applyTo field sets which files it applies to: move globs from the source into applyTo
Manually: put the files in place
.devin/rules/no-icons-in-buttons.mdManually: put the files in place
.clinerules/no-icons-in-buttons.mdStep by step, with commands for each platform: Cursor rules: .mdc files, four modes and what replaced .cursorrules
Questions about no-icons-in-buttons
How do I install no-icons-in-buttons in Claude Code?
Add the rule file at .claude/rules/no-icons-in-buttons.md.
What does no-icons-in-buttons do?
It tells the agent to use text-only buttons unless the user explicitly requests an icon.
Which buttons does no-icons-in-buttons cover?
It applies to all button components, including Shadcn UI Button and custom buttons.