ui-menus — Claude Code rule: native menus over custom JS
ui-menus — a rule for Claude Code and Codex that switches menu generation from custom JS components to native platform elements via zeego. Triggered when creating dropdowns or context menus.
MIT ★ 1,216 updated 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settingsWhat ui-menus does
Instead of handmade overlays with useState and Pressable, the agent writes calls to zeego/dropdown-menu or zeego/context-menu, which render native system menus. This brings built-in accessibility, familiar platform look and behavior, and saves rendering overhead.
The rule shows patterns for dropdowns, context menus (long-press), checkbox items and submenus. Requires the zeego library installed — code will not compile without it.
What it helps with
- replace JS overlays with native menus
- add long-press context menu
- embed checkboxes and submenus in dropdowns
- reduce custom UI rendering footprint
- meet accessibility requirements for menus
Example prompts for the agent
- Create a dropdown with Edit and Delete actions using zeego
- Add a long-press context menu with Copy and Paste
- Rewrite this menu as a
DropdownMenufrom zeego, first item destructive
How to install ui-menus
1Plugin marketplace
/plugin marketplace add fcakyon/claude-codex-settings/plugin install react-skills@claude-settings2Manually: put the files in place
.claude/rules/ui-menus.mdThe paths frontmatter field limits the files
AGENTS.md
Codex reads AGENTS.md: paste the rule text there
Manually: put the files in place
.cursor/rules/ui-menus.mdcFrontmatter: description, globs, alwaysApply
Manually: put the files in place
.github/instructions/ui-menus.instructions.mdThe applyTo field sets which files it applies to
Manually: put the files in place
.devin/rules/ui-menus.mdManually: put the files in place
.clinerules/ui-menus.mdStep by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use
Questions about ui-menus
How to install ui-menus in Claude Code?
First run /plugin marketplace add fcakyon/claude-codex-settings, then /plugin install react-skills@claude-settings. The rule file is .claude/rules/ui-menus.md.
What does the ui-menus rule do?
Switches the agent from custom JS menu components to native system menus via the zeego library. It generates code with DropdownMenu and ContextMenu instead of handmade overlays.
Is zeego required for the rule to work?
Yes. The rule relies on zeego/dropdown-menu and zeego/context-menu — code will not compile without the library installed.
Source text
ui-menus.md · MIT
---
title: Use Native Menus for Dropdowns and Context Menus
impact: HIGH
impactDescription: native accessibility, platform-consistent UX
tags: user-interface, menus, context-menus, zeego, accessibility
---
## Use Native Menus for Dropdowns and Context Menus
Use native platform menus instead of custom JS implementations. Native menus
provide built-in accessibility, consistent platform UX, and better performance.
Use [zeego](https://zeego.dev) for cross-platform native menus.
**Incorrect (custom JS menu):**
```tsx
import { useState } from 'react'
import { View, Pressable, Text } from 'react-native'
function MyMenu() {
const [open, setOpen] = useState(false)
return (
<View>
<Pressable onPress={() => setOpen(!open)}>
<Text>Open Menu</Text>
</Pressable>
{open && (
<View style={{ position: 'absolute', top: 40 }}>
<Pressable onPress={() => console.log('edit')}>
<Text>Edit</Text>
</Pressable>
<Pressable onPress={() => console.log('delete')}>
<Text>Delete</Text>
</Pressable>
</View>
)}
</View>
)
}
```
**Correct (native menu with zeego):**
```tsx
import * as DropdownMenu from 'zeego/dropdown-menu'
function MyMenu() {
return (
<DropdownMenu.Root>
<DropdownMenu.Trigger>
<Pressable>
<Text>Open Menu</Text>
</Pressable>
</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item key='edit' onSelect={() => console.log('edit')}>
<DropdownMenu.ItemTitle>Edit</DropdownMenu.ItemTitle>
</DropdownMenu.Item>
<DropdownMenu.Item
key='delete'
destructive
onSelect={() => console.log('delete')}
>
<DropdownMenu.ItemTitle>Delete</DropdownMenu.ItemTitle>
</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Root>
)
}
```
**Context menu (long-press):**
```tsx
import * as ContextMenu from 'zeego/context-menu'
function MyContextMenu() {
return (
<ContextMenu.Root>
<ContextMenu.Trigger>
<View style={{ padding: 20 }}>
<Text>Long press me</Text>
</View>
</ContextMenu.Trigger>
<ContextMenu.Content>
<ContextMenu.Item key='copy' onSelect={() => console.log('copy')}>
<ContextMenu.ItemTitle>Copy</ContextMenu.ItemTitle>
</ContextMenu.Item>
<ContextMenu.Item key='paste' onSelect={() => console.log('paste')}>
<ContextMenu.ItemTitle>Paste</ContextMenu.ItemTitle>
</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Root>
)
}
```
**Checkbox items:**
```tsx
import * as DropdownMenu from 'zeego/dropdown-menu'
function SettingsMenu() {
const [notifications, setNotifications] = useState(true)
return (
<DropdownMenu.Root>
<DropdownMenu.Trigger>
<Pressable>
<Text>Settings</Text>
</Pressable>
</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.CheckboxItem
key='notifications'
value={notifications}
onValueChange={() => setNotifications((prev) => !prev)}
>
<DropdownMenu.ItemIndicator />
<DropdownMenu.ItemTitle>Notifications</DropdownMenu.ItemTitle>
</DropdownMenu.CheckboxItem>
</DropdownMenu.Content>
</DropdownMenu.Root>
)
}
```
**Submenus:**
```tsx
import * as DropdownMenu from 'zeego/dropdown-menu'
function MenuWithSubmenu() {
return (
<DropdownMenu.Root>
<DropdownMenu.Trigger>
<Pressable>
<Text>Options</Text>
</Pressable>
</DropdownMenu.Trigger>
<DropdownMenu.Content>
<DropdownMenu.Item key='home' onSelect={() => console.log('home')}>
<DropdownMenu.ItemTitle>Home</DropdownMenu.ItemTitle>
</DropdownMenu.Item>
<DropdownMenu.Sub>
<DropdownMenu.SubTrigger key='more'>
<DropdownMenu.ItemTitle>More Options</DropdownMenu.ItemTitle>
</DropdownMenu.SubTrigger>
<DropdownMenu.SubContent>
<DropdownMenu.Item key='settings'>
<DropdownMenu.ItemTitle>Settings</DropdownMenu.ItemTitle>
</DropdownMenu.Item>
<DropdownMenu.Item key='help'>
<DropdownMenu.ItemTitle>Help</DropdownMenu.ItemTitle>
</DropdownMenu.Item>
</DropdownMenu.SubContent>
</DropdownMenu.Sub>
</DropdownMenu.Content>
</DropdownMenu.Root>
)
}
```
Reference: [Zeego Documentation](https://zeego.dev/components/dropdown-menu)
© fcakyon · MIT · fcakyon/claude-codex-settings