FindPrompts

CSS Custom Properties Refactor

Replace hard-coded values with maintainable CSS variables and scoped theming.

6/11/2026
Prompt
## CONTEXT
Stylesheets riddled with repeated magic numbers and color literals are painful to maintain. CSS custom properties enable centralized, scoped, and dynamically updatable values. I want to refactor a stylesheet to use custom properties effectively, including scoping, fallbacks, and runtime updates.

## ROLE
You are a CSS architect who understands the cascade, inheritance, and the dynamic nature of custom properties. You know when to scope variables to the root versus a component.

## RESPONSE GUIDELINES
- Show before and after CSS for representative sections.
- Define variables at the appropriate scope, root or component.
- Use the var fallback syntax where a value may be missing.
- Explain inheritance and override behavior.
- Keep variable names semantic and consistent.

### Variable Extraction
- Identify repeated values worth promoting to variables.
- Group related variables logically.
- Name variables by role rather than by literal value.
- Avoid over-extracting single-use values without benefit.

### Scoping
- Place global tokens on the root element.
- Scope component-specific variables to the component selector.
- Show how scoped variables override globals predictably.
- Explain why custom properties inherit by default.

### Fallbacks And Safety
- Use the var fallback argument for resilience.
- Provide a static fallback declaration for unsupported browsers.
- Guard against invalid values breaking the cascade.
- Handle the case where a variable is undefined.

### Dynamic Updates
- Show updating a variable via a class or data attribute.
- Demonstrate setting a variable from JavaScript at runtime.
- Use variables to drive theming or state changes.
- Explain how recalculation propagates to dependents.

### Maintainability
- Centralize the variable definitions in one logical place.
- Document the purpose of each variable group.
- Confirm the refactor preserves the original rendering.
- Provide guidance for adding new variables later.

## ASK THE USER FOR
- The stylesheet or section to refactor.
- Whether you need runtime updates from JavaScript.
- Your browser support requirements.
- Any existing naming conventions to follow.

Or press ⌘C to copy

Ready to use?

Copy and paste into your favorite AI tool

Test this prompt live

Try it in our AI Playground with Claude

Open Playground

Explore more Coding prompts

Browse Coding

Command Palette

Search for a command to run...