faststore-theming

Apply design-token overrides to FastStore storefront themes via custom-theme.scss.

39|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/vtexdocs/ai-skills --skill faststore-theming
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: faststore-theming
Source: https://github.com/vtexdocs/ai-skills/tree/main/tracks/faststore/skills/faststore-theming
Command: npx skills add https://github.com/vtexdocs/ai-skills --skill faststore-theming

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Theming FastStore storefronts consistently by applying design tokens and SCSS-based theming without touching component behavior.

Core Features & Use Cases

  • Global and local token management for colors, typography, spacing, and borders
  • Safe, token-driven overrides via src/themes/custom-theme.scss
  • Create brand-consistent themes across pages using data-fs-* selectors

Quick Start

Create a custom theme by adding src/themes/custom-theme.scss with token overrides.

Frequently Asked Questions about faststore-theming

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I theme a FastStore storefront using design tokens?

Override global and local design tokens in src/themes/custom-theme.scss to manage colors, typography, spacing, and borders. This approach applies brand-consistent visual changes across FastStore pages without altering underlying component behavior.

What is the best way to customize FastStore CSS without changing component logic?

The best way to customize FastStore CSS safely is by overriding design tokens in src/themes/custom-theme.scss. Apply visual changes to appearance using data-fs-* selectors and var(--fs-*) tokens to ensure component behavior remains untouched.

How do design tokens work for FastStore theming?

Design tokens for FastStore theming work by mapping visual properties like color and spacing to CSS custom properties. You apply these var(--fs-*) tokens through data-fs-* selectors to globally enforce brand styling standards across the storefront.

Can I use SCSS to override global and local tokens in a FastStore theme?

Yes, you can use SCSS to override both global and local tokens in a FastStore theme. Place your SCSS token overrides in src/themes/custom-theme.scss to define design properties for colors, typography, and spacing safely.

Why should I use design tokens instead of writing custom CSS for FastStore components?

Use design tokens instead of custom CSS to maintain a consistent design system and avoid breaking component behavior. Token-driven overrides in src/themes/ conform to FastStore theming standards, ensuring safe and manageable visual updates.

Do I need to modify component files to change FastStore typography and spacing?

No, you do not need to modify component files to change typography and spacing. FastStore separates visual design from behavior, allowing you to apply token overrides in src/themes/custom-theme.scss to adjust these properties globally.