UI Design
Own visual design across web, SwiftUI, and UIKit, plus browser styling and
behavior. Use swiftui or uikit for native implementation, state, lifecycle,
and accessibility; use animate for moving feedback and transitions. The
platform owner keeps the action and state contract.
Change only the jobs the request puts in scope.
For an authorized build or fix, implement and verify the change. For a plan,
review, or advisory task, leave the product unchanged and make each proposed
change and acceptance check concrete.
Work the request
- Inspect. Examine the available interface and nearby components with
representative content. Identify existing tokens, patterns, and the authoring
system. Check the target platforms and versions, available runnable surface,
and affected states, sizes, appearance modes, text scaling, inputs, and access paths.
Finish with the affected components and supported variants identified.
- Diagnose. Select the job: visual hierarchy or identity, CSS/layout,
browser behavior, accessibility, or a combination. For visual work, identify
the primary content and action, competing emphasis, groups, and semantic
roles. For behavior work, identify the expected activation, focus, input,
status, and state contract. Finish with an observable problem or design
intent and the contracts the change must preserve.
- Choose guidance. Follow each applicable branch below; read the sections
that address the job. An identity change starts with art direction, then the
platform guidance. A local CSS or behavior fix starts at its matching branch.
Finish with the proposed change tied to the diagnosed cause or design intent.
- Build or propose. Use the product's tokens, components, and authoring
stack. For visual work, resolve hierarchy and layout before decorative detail;
compare values with their neighbors and test the narrowest relevant surface
before wider compositions. Sketch or prototype when a direction needs trying.
Prefer intrinsic layout and native capabilities when they meet the contract.
Check feature support against the actual targets and provide a usable fallback
where needed. Cover every affected component, state, and access variant.
For advisory work, make those changes and checks concrete without editing
the product.
- Check. For implementation, exercise the changed surface at the affected
sizes and through its input and accessibility paths. Syntax support or a
screenshot alone does not establish an interaction works. Use
verify for
hands-on acceptance. For advisory work, trace each proposal through the
representative components and state the checks implementation must pass.
Read by task
Combine branches when the request crosses them. Keep visual direction stable
for behavior-only work, and interaction/access contracts stable for visual-only
work.
| Task |
Guidance |
| New identity or substantial visual redirection |
Art direction, then the web or Apple branch |
| Existing web interface looks wrong |
Diagnosis, then the relevant web visual system sections |
| Web type, spacing, color roles, shape, hierarchy, or starter tokens |
Web visual systems |
| Build or repair a numbered HSL web color ramp |
Palette workflow; keep another working color model when it fits |
| Web reset, logical properties, fluid scales, or theme/color implementation |
CSS foundations |
| Web content widths, grids, containers, responsive layout, spacing, or overflow |
Web layout |
| Browser semantics, states, focus, input, announcements, or accessibility |
Web behavior and accessibility |
| Web viewport, safe areas, virtual keyboard, touch, scrolling, browser chrome, carousel, or bounded panel |
Mobile browser behavior, plus the behavior contract when input or state changes |
| Web shadows, text alignment, image contrast/cropping, or media geometry |
Matching visual techniques sections |
| SwiftUI or UIKit visual design |
Apple-platform visual design, with the framework owner |
Visual decisions
Use position, grouping, spacing, weight, color, and size together to establish
hierarchy. Preserve the product's established language where it serves the job.
- Prefer semantic roles such as surface, primary text, secondary text, action,
warning, and separator over raw values at call sites.
- Keep more space around a group than within it. Ambiguous spacing obscures the
information architecture.
- Give the primary action the strongest treatment, keep secondary actions
clearly available, and use quiet or link-like treatment for tertiary actions.
Destructive actions become primary only when they are the current decision,
such as in a deletion confirmation.
- Use color consistently and pair it with text, shape, iconography, or another
cue when it communicates state.
- Use depth, borders, materials, and overlap to explain structure. Each cue
needs a job.
- Extend scales only when an existing value cannot express a real role clearly.
Scales and token counts are tools, not quotas.
- Prefer standard platform components and existing product patterns before
custom work. Customize deliberately when identity, hierarchy, or behavior
requires it.
Handoff
Deliver the implemented result or concrete proposal and state the diagnosed
job, roles or contracts changed, and checks performed. Completion requires every
affected component and variant to be accounted for, a coherent system that fits
the brief and surrounding product, and explicit remaining evidence gaps by
browser, device, appearance, input, or accessibility path.
For a plan, account for every component in scope with a concrete change or an
explicit reason it remains unchanged.
1---2name: ui-design3description: Use for visual hierarchy, art direction, or design systems on web, SwiftUI, or UIKit; and for web CSS, responsive layout, browser component behavior, input, or accessibility.4metadata:5 source: https://skillmd.com/skills/sreejithraman/ui-design6---78# UI Design910Own visual design across web, SwiftUI, and UIKit, plus browser styling and11behavior. Use `swiftui` or `uikit` for native implementation, state, lifecycle,12and accessibility; use `animate` for moving feedback and transitions. The13platform owner keeps the action and state contract.14Change only the jobs the request puts in scope.1516For an authorized build or fix, implement and verify the change. For a plan,17review, or advisory task, leave the product unchanged and make each proposed18change and acceptance check concrete.1920## Work the request21221. **Inspect.** Examine the available interface and nearby components with23 representative content. Identify existing tokens, patterns, and the authoring24 system. Check the target platforms and versions, available runnable surface,25 and affected states, sizes, appearance modes, text scaling, inputs, and access paths.26 Finish with the affected components and supported variants identified.272. **Diagnose.** Select the job: visual hierarchy or identity, CSS/layout,28 browser behavior, accessibility, or a combination. For visual work, identify29 the primary content and action, competing emphasis, groups, and semantic30 roles. For behavior work, identify the expected activation, focus, input,31 status, and state contract. Finish with an observable problem or design32 intent and the contracts the change must preserve.333. **Choose guidance.** Follow each applicable branch below; read the sections34 that address the job. An identity change starts with art direction, then the35 platform guidance. A local CSS or behavior fix starts at its matching branch.36 Finish with the proposed change tied to the diagnosed cause or design intent.374. **Build or propose.** Use the product's tokens, components, and authoring38 stack. For visual work, resolve hierarchy and layout before decorative detail;39 compare values with their neighbors and test the narrowest relevant surface40 before wider compositions. Sketch or prototype when a direction needs trying.41 Prefer intrinsic layout and native capabilities when they meet the contract.42 Check feature support against the actual targets and provide a usable fallback43 where needed. Cover every affected component, state, and access variant.44 For advisory work, make those changes and checks concrete without editing45 the product.465. **Check.** For implementation, exercise the changed surface at the affected47 sizes and through its input and accessibility paths. Syntax support or a48 screenshot alone does not establish an interaction works. Use `verify` for49 hands-on acceptance. For advisory work, trace each proposal through the50 representative components and state the checks implementation must pass.5152## Read by task5354Combine branches when the request crosses them. Keep visual direction stable55for behavior-only work, and interaction/access contracts stable for visual-only56work.5758| Task | Guidance |59| --- | --- |60| New identity or substantial visual redirection | [Art direction](references/art-direction.md), then the web or Apple branch |61| Existing web interface looks wrong | [Diagnosis](references/diagnose.md), then the relevant [web visual system](references/web.md) sections |62| Web type, spacing, color roles, shape, hierarchy, or starter tokens | [Web visual systems](references/web.md) |63| Build or repair a numbered HSL web color ramp | [Palette workflow](references/systems.md); keep another working color model when it fits |64| Web reset, logical properties, fluid scales, or theme/color implementation | [CSS foundations](references/web-css-foundations.md) |65| Web content widths, grids, containers, responsive layout, spacing, or overflow | [Web layout](references/web-layout.md) |66| Browser semantics, states, focus, input, announcements, or accessibility | [Web behavior and accessibility](references/web-behavior-and-accessibility.md) |67| Web viewport, safe areas, virtual keyboard, touch, scrolling, browser chrome, carousel, or bounded panel | [Mobile browser behavior](references/mobile-web.md), plus the behavior contract when input or state changes |68| Web shadows, text alignment, image contrast/cropping, or media geometry | Matching [visual techniques](references/techniques.md) sections |69| SwiftUI or UIKit visual design | [Apple-platform visual design](references/apple-platforms.md), with the framework owner |7071## Visual decisions7273Use position, grouping, spacing, weight, color, and size together to establish74hierarchy. Preserve the product's established language where it serves the job.7576- Prefer semantic roles such as surface, primary text, secondary text, action,77 warning, and separator over raw values at call sites.78- Keep more space around a group than within it. Ambiguous spacing obscures the79 information architecture.80- Give the primary action the strongest treatment, keep secondary actions81 clearly available, and use quiet or link-like treatment for tertiary actions.82 Destructive actions become primary only when they are the current decision,83 such as in a deletion confirmation.84- Use color consistently and pair it with text, shape, iconography, or another85 cue when it communicates state.86- Use depth, borders, materials, and overlap to explain structure. Each cue87 needs a job.88- Extend scales only when an existing value cannot express a real role clearly.89 Scales and token counts are tools, not quotas.90- Prefer standard platform components and existing product patterns before91 custom work. Customize deliberately when identity, hierarchy, or behavior92 requires it.9394## Handoff9596Deliver the implemented result or concrete proposal and state the diagnosed97job, roles or contracts changed, and checks performed. Completion requires every98affected component and variant to be accounted for, a coherent system that fits99the brief and surrounding product, and explicit remaining evidence gaps by100browser, device, appearance, input, or accessibility path.101102For a plan, account for every component in scope with a concrete change or an103explicit reason it remains unchanged.