Skip to content

lidge-jun/codexclaw / plugins/codexclaw/skills/dev-uiux-design

cxc-dev-uiux-design

Verified

Use for UI/UX and brand direction. Triggers: make it look good, onboarding, empty state, error state, favicon, logo, design system, 깔끔하게, 모던하게, 감성적으로.

references/form-patterns.md

View on GitHub
# Form Design Patterns

Validation timing, multi-step wizards, auth forms, file upload, and search/filter.

## 1. Validation Timing

| Strategy | When | Use For |
|----------|------|---------|
| **On blur** (default) | User leaves the field | Most fields — email, name, phone |
| **On submit** | Form is submitted | Short forms (≤ 4 fields), payment |
| **Real-time** | As user types, debounced 300ms | Username availability, search |
| **On blur + on change after first error** | First error on blur, subsequent on keystroke | Long forms |

- Never show errors on empty fields before first interaction
- Error appears below the field, not in a top-level alert
- Error state: red border + error icon + message text (never color alone)
- Success state: green check on field, NOT green border (a11y)
- Clear error when user starts correcting

## Multi-Step Form (Wizard)

```
Step Indicator (1/3, 2/3, 3/3)
├── Step Title
├── Fields for this step
├── [Back] [Next / Submit]
└── Progress bar (optional)
```

- Step indicator always visible (horizontal bar or numbered pills)
- Back button preserves all entered data
- Validate current step before allowing Next
- Final step shows summary before Submit
- Save partial state to sessionStorage (refresh-safe)
- Mobile: full-width steps, no horizontal scroll for indicator
- Max 5 steps — break longer flows into separate forms

## Auth / Password Forms

### Sign In

```
[Email / Username]
[Password] [Show/Hide toggle]
[Forgot password?]
[Sign In]
[— or —]
[Social login buttons]
```

### Sign Up

```
[Email]
[Password] [Strength meter below]
[Confirm password]
[Terms checkbox]
[Sign Up]
```

- Show/hide toggle as icon button inside the password field
- Strength meter: visual bar (red → yellow → green) + text label
  - Weak: < 8 chars or common password
  - Medium: 8+ chars, mixed case
  - Strong: 12+ chars, mixed case + number + symbol
- Never disable paste on password fields
- `autocomplete`: `username`, `current-password`, `new-password`
- Passkey/WebAuthn: offer as primary when supported
- Wrong credentials: "Invalid email or password" (never reveal which)

## File Upload

```
[Drop zone: dashed border, icon, "Drag files here or click"]
[File list: name, size, progress bar, remove]
```

- `accept` attribute: specify allowed types
- Max file size visible in drop zone text
- Individual progress bar per file
- Preview: thumbnails for images, icon + filename for documents
- Failed files: red highlight + retry button
- Multiple files: drag handles if order matters
- Drop zone is `<button>` or `role="button"`, keyboard-activatable
- Mobile: tap opens file picker, camera option for images

## Search / Filter

Filter dropdowns, sort menus, and search comboboxes use the project's unified
dropdown design layer (`dev-frontend` `dropdown-layer.md`
FE-DROPDOWN-LAYER-01): one skin, behavior-correct primitive per pattern.

```
[Search input + icon]
[Filter pills / dropdown] [Active filter count]
[Results count: "42 results"]
[Clear all filters]
```

- Debounce search input 300ms before querying
- Empty: show suggestions or recent searches
- Filter state reflected in URL query params (shareable, back-button works)
- Loading: skeleton results, not blank screen
- No results: helpful message + suggest clearing filters

## Pre-flight

- [ ] Validation uses on-blur timing by default
- [ ] Error messages appear below the relevant field
- [ ] Password fields have show/hide toggle and `autocomplete`
- [ ] Multi-step forms preserve data on back/refresh
- [ ] File uploads show individual progress and support drag-and-drop

## Cross-references

- Mobile form rules: `dev-frontend/references/core/mobile-ux.md`
- Validation UX states: `ux-states.md` §9
- Schema validation: dev-frontend [React stack](../../dev-frontend/references/stacks/react.md) (Zod + react-hook-form)
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: 321kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall