oliverv/caro / .agents/skills/oma-frontend
oma-frontend
UnverifiedImplement or modify web UI in React, Next.js, or Angular. Use for components, pages, styles, forms, and frontend state or data flows.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.0 KB |
| resources/angular-rules.md | markdown | 4.9 KB |
| resources/checklist.md | markdown | 4.7 KB |
| resources/error-playbook.md | markdown | 5.2 KB |
| resources/execution-protocol.md | markdown | 2.5 KB |
| resources/snippets.md | markdown | 11.6 KB |
| resources/tailwind-rules.md | markdown | 2.7 KB |
| resources/tech-stack.md | markdown | 8.4 KB |
resources/tailwind-rules.md
View on GitHub# Tailwind CSS Rules
> Basic Tailwind syntax (spacing scale, flex/grid, breakpoints) is assumed knowledge. This file only covers project-specific rules and non-obvious patterns. See `snippets.md` for ready-made component snippets.
## Core Rules
1. **No inline styles**: Tailwind classes only
2. **Mobile-first**: base classes target mobile, scale up with `sm:` `md:` `lg:`
3. **No hardcoded colors**: always use semantic tokens (see below)
4. **Dark mode aware**: every color token must work under `dark:` variant
5. **Arbitrary values only with justification**: `w-[789px]` needs a design reason; otherwise use the scale
## Semantic Color Tokens
Map all colors to design tokens in `packages/design-tokens`. Never use raw colors like `bg-white` or `text-gray-900`.
```tsx
// Good
<div className="bg-background text-foreground border-border">
<button className="bg-primary text-primary-foreground">
// Bad
<div className="bg-white text-black border-gray-300">
```
Available tokens:
- `background` / `foreground`
- `primary` / `primary-foreground`
- `secondary` / `secondary-foreground`
- `muted` / `muted-foreground`
- `accent` / `accent-foreground`
- `destructive` / `destructive-foreground`
- `border` / `input` / `ring`
## `cn()` Utility
Use `cn()` (clsx + tailwind-merge) whenever classes are conditional or need to be overridable from a prop:
```tsx
import { cn } from "@/lib/utils";
<div className={cn(
"base-class",
condition && "conditional-class",
{ "variant-a": variant === "a" },
className, // prop override must come last
)} />
```
## Focus States (A11y)
Every interactive element needs a visible focus state:
```tsx
className="focus:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2"
```
Screen-reader-only text: `<span className="sr-only">...</span>`.
## Tailwind v4 Theme
Tailwind v4 uses CSS-based configuration. `tailwind.config.js` is deprecated. Add custom tokens via `@theme` in `app/globals.css`:
```css
@import "tailwindcss";
@theme {
--spacing-18: 4.5rem;
--color-brand-50: #...;
--color-brand-900: #...;
}
```
## Anti-Patterns
- **`@apply` in CSS files**: defeats utility-first intent. Use classes in JSX, or extract a component.
- **Hardcoded hex/rgb**: always go through the token system.
- **Desktop-first breakpoints**: `grid-cols-3 sm:grid-cols-1` reverses the mobile-first flow.
- **Nested overrides**: if you find yourself writing `lg:!bg-primary`, the component API is wrong; add a variant instead.
## Formatting
Follow whatever class-sorting convention the project's formatter enforces (Prettier + `prettier-plugin-tailwindcss`, Biome's `useSortedClasses`, or similar). Do not hand-reorder against the formatter.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |