BumpyClock/agent-templates / skills_archive/web-skills/design-engineering
design-engineering
VerifiedDesign engineering principles and patterns for building polished, accessible web interfaces. Use this skill when building UI components, reviewing frontend code, implementing forms, handling touch interactions, optimizing performance, or creating marketing pages. Triggers on: design engineering, UI polish, input fields, form validation, button states, touch devices, mobile UX, accessibility, a11y, keyboard navigation, aria labels, font rendering, typography, layout shift, z-index, animations, transitions, easing, hover effects, tap targets, iOS Safari, prefers-reduced-motion, marketing pages, landing pages, dark mode, theme switching, scrollbars, gradients, shadows, virtualization, preloading.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.8 KB |
| aesthetic-direction.md | markdown | 3.7 KB |
| agents/openai.yaml | config | 189 B |
| animations.md | markdown | 7.8 KB |
| component-design.md | markdown | 7.2 KB |
| forms-controls.md | markdown | 4.9 KB |
| marketing.md | markdown | 3.4 KB |
| performance.md | markdown | 4.7 KB |
| touch-accessibility.md | markdown | 4.8 KB |
| ui-polish.md | markdown | 6.2 KB |
performance.md
View on GitHub# Performance
Optimization, virtualization, and performance considerations.
## Animation Performance
See [animations.md](animations.md) for detailed animation performance guidelines. Key rules:
- Only animate `transform` and `opacity`
- Avoid animating `height`, `width`, `padding`, `margin`
- Avoid `blur` filters above 20px
- Use `will-change: transform` for GPU acceleration
- Pause looping animations when off-screen
## Lists & Virtualization
Virtualize large lists. Don't render hundreds of DOM nodes when only a few are visible:
```jsx
import { useVirtualizer } from '@tanstack/react-virtual';
function VirtualList({ items }) {
const parentRef = useRef(null);
const virtualizer = useVirtualizer({
count: items.length,
getScrollElement: () => parentRef.current,
estimateSize: () => 50,
});
return (
<div ref={parentRef} style={{ height: '400px', overflow: 'auto' }}>
<div style={{ height: virtualizer.getTotalSize() }}>
{virtualizer.getVirtualItems().map((virtualItem) => (
<div
key={virtualItem.key}
style={{
position: 'absolute',
top: virtualItem.start,
height: virtualItem.size,
}}
>
{items[virtualItem.index]}
</div>
))}
</div>
</div>
);
}
```
## Transitions
### Avoid `transition: all`
Never use `transition: all`. It causes accidental animations and performance issues:
```css
/* Bad */
.button {
transition: all 200ms ease;
}
/* Good - specify exact properties */
.button {
transition: background-color 200ms ease, transform 200ms ease;
}
```
### Theme Switching
Switching themes should not trigger transitions. Disable transitions during theme changes:
```js
function setTheme(theme) {
// Disable transitions
document.documentElement.classList.add('no-transitions');
// Apply theme
document.documentElement.setAttribute('data-theme', theme);
// Re-enable transitions after paint
requestAnimationFrame(() => {
requestAnimationFrame(() => {
document.documentElement.classList.remove('no-transitions');
});
});
}
```
```css
.no-transitions,
.no-transitions * {
transition: none !important;
}
```
## Layout Performance
### Prevent Layout Shift
Dynamic elements should cause no layout shift:
- Use hardcoded dimensions for images and videos
- Reserve space for async content with skeletons
- Use `font-variant-numeric: tabular-nums` for changing numbers
- Don't change font weight on hover
### Font Loading
Preload fonts to prevent layout shift:
```jsx
import { preload } from 'react-dom';
preload('/fonts/inter-var.woff2', {
as: 'font',
type: 'font/woff2',
crossOrigin: 'anonymous',
});
```
## React Performance
### Minimize Re-renders
For animations, animate outside React's render cycle when possible:
```jsx
// Bad - causes re-render on every frame
const [position, setPosition] = useState(0);
// Good - use refs for direct DOM manipulation
const elementRef = useRef(null);
useEffect(() => {
let frame;
function animate() {
elementRef.current.style.transform = `translateX(${position}px)`;
frame = requestAnimationFrame(animate);
}
frame = requestAnimationFrame(animate);
return () => cancelAnimationFrame(frame);
}, []);
```
### Framer Motion Performance
```jsx
// Hardware accelerated (uses transform string)
<motion.div animate={{ transform: "translateX(100px)" }} />
// NOT hardware accelerated (more readable but slower)
<motion.div animate={{ x: 100 }} />
```
## CSS Performance
### CSS Variables
Avoid animating CSS variables in deep component trees. Each variable change triggers style recalculation for all descendants.
### Blur Filters
`blur()` filters above 20px are expensive, especially in Safari. Keep blur values subtle or avoid them on frequently-animating elements.
## Static Generation
Generate static content at build time:
```jsx
// Next.js example
export async function getStaticProps() {
const posts = await fetchPosts();
return {
props: { posts },
revalidate: 3600, // Revalidate hourly
};
}
```
Don't fetch blog posts, changelog entries, or docs at request time when they can be pre-generated.
## Preloading
### Critical Images
Preload above-the-fold images:
```html
<link rel="preload" as="image" href="/hero.webp" />
```
### Fonts
```html
<link
rel="preload"
href="/fonts/inter.woff2"
as="font"
type="font/woff2"
crossorigin
/>
```
## Off-Screen Content
Pause or stop resource-intensive operations when off-screen:
```js
const observer = new IntersectionObserver((entries) => {
entries.forEach((entry) => {
if (entry.isIntersecting) {
startAnimation();
} else {
pauseAnimation();
}
});
});
observer.observe(element);
```
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: 319k | 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: 196k | 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: 196k | 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: 196k | Updated | Claude CodeCodex | Verified | Install |