美国
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 设计与多媒体
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# USMDS Development Guide
Build accessible React Native mobile interfaces using the U.S. Mobile Design System (USMDS) with NativeWind styling.
## Quick Reference
- **Components**: See [references/components.md](references/components.md) for all components with imports and usage examples
- **Setup**: See [references/setup.md](references/setup.md) for project initialization, Metro/Babel/Tailwind config
- **Theming**: See [references/theming.md](references/theming.md) for design tokens, colors, and custom theme configuration
## Core Architecture
USMDS has three layers:
1. **Components** — Pre-built accessible UI from `@/components/ui/*` (Button, Card, Alert, etc.)
2. **NativeWind Styling** — Tailwind CSS classes via the `className` prop
3. **Theme Tokens** — CSS custom properties (HSL-based) for consistent design language
Components are imported individually. Styling uses NativeWind (Tailwind for React Native). Theming flows through `tailwind.config.js` CSS variables.
## Project Setup (Quick)
```bash
# Automatic setup (recommended)
npx @blen/usmds init -y
# Or specify project path
npx @blen/usmds init -c /path/to/project
```
This generates: `tailwind.config.js`, `metro.config.js`, `babel.config.js`, `global.css`, and TypeScript definitions. See [references/setup.md](references/setup.md) for manual setup.
## Component Usage Pattern
All components import from `@/components/ui/`:
```tsx
import { Button } from '@/components/ui/button';
import { Text } from '@/components/ui/text';
<Button onPress={handlePress}>
<Text>Click me</Text>
</Button>
```
**Key convention**: USMDS `Button` and most interactive components require `<Text>` children — they do not accept bare strings.
## Styling with NativeWind
Apply Tailwind classes via `className`:
```tsx
<Button className="w-full mt-4">
<Text>Full Width Button</Text>
</Button>
<View className="bg-background border border-border rounded-lg p-4">
<Text className="text-foreground font-medium">Themed content</Text>
<Text className="text-muted-foreground text-sm">Supporting text</Text>
</View>
```
## Accessibility
USMDS components follow WAI-ARIA patterns for React Native:
- **Alert** components automatically get the `alert` accessibility role for screen readers
- **AlertDialog** provides structured confirmation with accessible header/footer
- **Accordion** follows WAI-ARIA accordion pattern with proper expand/collapse semantics
- Always wrap text in `<Text>` components (React Native requirement)
- Use `variant="destructive"` for error/danger states — provides semantic meaning
## PortalHost (Required for Overlays)
Components like AlertDialog, Tooltip, Popover, and DropdownMenu require `PortalHost` in your root layout:
```tsx
import { PortalHost } from '@rn-primitives/portal';
export default function RootLayout() {
return (
<ThemeProvider>
<Stack />
<PortalHost />
</ThemeProvider>
);
}
```
**Without PortalHost**, overlay components will not render. Add it as the last child in your root layout.
## Common Patterns
### Form with Validation
```tsx
import { View } from 'react-native';
import { Button } from '@/components/ui/button';
import { Text } from '@/components/ui/text';
import { TextInput } from '@/components/ui/textinput';
import { Checkbox } from '@/components/ui/checkbox';
const [errors, setErrors] = useState({});
<View className="flex-1 p-4 gap-4">
<View>
<Text className="mb-2 font-medium">Email</Text>
<TextInput
value={email}
onChangeText={setEmail}
placeholder="you@example.com"
keyboardType="email-address"
autoCapitalize="none"
className={errors.email ? 'border-destructive' : ''}
/>
{errors.email && (
<Text className="text-destructive text-sm mt-1">{errors.email}</Text>
)}
</View>
<Button onPress={handleSubmit} className="mt-4">
<Text>Submit</Text>
</Button>
</View>
```
### Card Layout
```tsx
import { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter } from '@/components/ui/card';
import { Badge } from '@/components/ui/badge';
<Card className="mb-4">
<CardHeader>
<CardTitle>Title</CardTitle>
<CardDescription>Subtitle</CardDescription>
</CardHeader>
<CardContent>
<Text className="text-muted-foreground">Body content</Text>
<View className="flex-row gap-2 mt-3">
<Badge><Text>Tag 1</Text></Badge>
<Badge variant="secondary"><Text>Tag 2</Text></Badge>
</View>
</CardContent>
<CardFooter className="gap-2">
<Button variant="outline" size="sm" className="flex-1">
<Text>Cancel</Text>
</Button>
<Button size="sm" className="flex-1">
<Text>Confirm</Text>
</Button>
</CardFooter>
</Card>
```
### Confirmation Dialog
```tsx
import {
AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent,
AlertDialogDescription, AlertDialogFooter, AlertDialogHeader,
AlertDialogTitle, AlertDialogTrigger,
} from '@/components/ui/alert-dialog';
<AlertDialog>
<AlertDialogTrigger asChild>
<Button variant="outline"><Text>Delete</Text></Button>
</AlertDialogTrigger>
<AlertDialogContent>
<AlertDialogHeader>
<AlertDialogTitle>Are you sure?</AlertDialogTitle>
<AlertDialogDescription>This action cannot be undone.</AlertDialogDescription>
</AlertDialogHeader>
<AlertDialogFooter>
<AlertDialogCancel><Text>Cancel</Text></AlertDialogCancel>
<AlertDialogAction><Text>Continue</Text></AlertDialogAction>
</AlertDialogFooter>
</AlertDialogContent>
</AlertDialog>
```
## Theme Colors
Theme uses HSL CSS variables mapped in `tailwind.config.js`:
| Token | Usage |
|-------|-------|
| `background` / `foreground` | Page background, primary text |
| `primary` / `primary-foreground` | Primary actions, emphasis |
| `secondary` / `secondary-foreground` | Secondary actions |
| `destructive` / `destructive-foreground` | Error states, danger actions |
| `muted` / `muted-foreground` | Subtle backgrounds, secondary text |
| `accent` / `accent-foreground` | Highlights, active states |
| `card` / `card-foreground` | Card surfaces |
| `border` / `input` / `ring` | Borders, input borders, focus rings |
See [references/theming.md](references/theming.md) for full configuration.
---
> Source: [blencorp/skills](https://github.com/blencorp/skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
章节与文件索引
按说明文件中的顺序排列。
快速参考
核心架构
项目设置(快速)
组件使用模式
使用 NativeWind 进行造型
文件/命令 -> @/components/ui/* · className · tailwind.config.js · metro.config.js · babel.config.js · global.css · @/components/ui/ · Button
内容校验值 -> 8a11697e9394
当前原文的自动摘译,尚未人工审校。
快速参考
组件:请参阅references/components.md,了解所有包含导入和使用示例的组件 设置:请参阅references/setup.md,了解项目初始化、Metro/Babel/Tailwind 配置 主题:请参阅references/theming.md,了解设计令牌、颜色和自定义主题配置
核心架构
USMDS 具有三层: 组件 — 来自
@/components/ui/*的预构建可访问 UI(按钮、卡片、警报等) NativeWind 样式 — 通过classNameprop 的 Tailwind CSS 类 主题令牌 — CSS 自定义属性(基于 HSL),以实现一致的设计语言 组件单独导入。样式使用 NativeWind(React Native 的 Tailwind)。主题通过tailwind.config.jsCSS 变量流动。项目设置(快速)
这会生成:
tailwind.config.js、metro.config.js、babel.config.js、global.css和 TypeScript 定义。有关手动设置,请参阅references/setup.md。组件使用模式
所有组件均从
@/components/ui/导入:关键约定:USMDSButton和大多数交互式组件需要<Text>子组件 — 它们不接受裸字符串。使用 NativeWind 进行造型
通过
className应用 Tailwind 课程: