Skip to content

Commit

Permalink
Merge pull request #1515 from vtexdocs/EDU-12703-review-theming
Browse files Browse the repository at this point in the history
EDU-12703: Review 'Theming' doc
  • Loading branch information
mariana-caetano authored Oct 28, 2024
2 parents 2eead97 + 26abc2e commit b84dbc7
Showing 1 changed file with 9 additions and 26 deletions.
35 changes: 9 additions & 26 deletions docs/faststore/docs/customization/using-themes/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ title: "Theming"

Theming allows you to change the UI of your project by using CSS stylesheets called themes.

In this guide, you'll have an overview of theming in FastStore, explaining the concept of theming, the use of global and local tokens, the structure and architecture of themes, and the naming scheme for design tokens.
This guide provides an overview of theming in FastStore, explaining the concept of theming, the use of global and local tokens, the structure and architecture of themes, and the naming scheme for design tokens.

---

## What is Theming?
## Overview

Theming refers to the process of customizing the UI of a project by using CSS stylesheets called themes.
Themes consist of configurable design tokens that define the look and feel of the UI.
Expand Down Expand Up @@ -75,7 +75,7 @@ Local design tokens are connected to global tokens, forming the Theme. Global to

The interaction between components, local design tokens, and global design tokens creates a hierarchical structure allowing modular theming and customization.

![](https://vtexhelp.vtexassets.com/assets/docs/src/theming-architecture___f965569346d8d7d6a3de1f020f06ac99.png)
![tokens-interaction](https://vtexhelp.vtexassets.com/assets/docs/src/theming-architecture___f965569346d8d7d6a3de1f020f06ac99.png)

---

Expand All @@ -95,7 +95,7 @@ Design tokens follow a specific naming scheme to ensure predictability and cohes

![Naming scheme](https://vtexhelp.vtexassets.com/assets/docs/src/theming-naming-1___32778b6c40f12a94ac4a54a90879aeef.png)

Additional increments can be added to the token's name, such as hierarchy, nested element, variant, or situation, to differentiate tokens and provide more context.
To differentiate tokens and provide more context, additional increments can be added to the token's name, such as hierarchy, nested element, variant, or situation.

- **Hierarchy**: Define its tier.
- **Nested Element**: To style elements contained inside the component.
Expand All @@ -118,25 +118,8 @@ Global design tokens are parameters that affect all UI look 'n' feel. They are t

---

## Next steps

<Flex>
<WhatsNextCard
title="Global Tokens"
linkTo="https://developers.vtex.com/docs/guides/faststore/global-tokens-overview"
/>

<WhatsNextCard
title="Themes"
linkTo="https://developers.vtex.com/docs/guides/faststore/themes-overview"
/>

<WhatsNextCard
title="Icons"
linkTo="https://developers.vtex.com/docs/guides/faststore/reference-icons"
/>
<WhatsNextCard
title="Customizing"
linkTo="https://developers.vtex.com/docs/guides/faststore/building-sections-overview"
/>
</Flex>
## Learn more

- [Global tokens](https://developers.vtex.com/docs/guides/faststore/global-tokens-overview)
- [Themes](https://developers.vtex.com/docs/guides/faststore/themes-overview)
- [Icons](https://developers.vtex.com/docs/guides/faststore/reference-icons)

0 comments on commit b84dbc7

Please sign in to comment.