Skip to content

Commit

Permalink
docs(sass-variables): add info and link to global sass vars
Browse files Browse the repository at this point in the history
  • Loading branch information
MajesticPotatoe committed Sep 18, 2024
1 parent 57f5514 commit ae7a667
Showing 1 changed file with 13 additions and 1 deletion.
14 changes: 13 additions & 1 deletion packages/docs/src/pages/en/features/sass-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ For additional details about css-pre-processors, please refer to the official vi

## Basic usage

Create a **main.scss** file in your **src/styles** directory and update the style import within your **vuetify.js** file:
There are many SASS variables such as **font size**, **font family**, and **line height** that can be configured globally. An extensive list of configurable global SASS variables can be found [here](https://github.com/vuetifyjs/vuetify/blob/master/packages/vuetify/src/styles/settings/_variables.scss). To start, create a **main.scss** file in your **src/styles** directory and update the style import within your **vuetify.js** file:

```scss { resource="src/styles/main.scss" }
@use 'vuetify' with (
Expand All @@ -70,6 +70,18 @@ Create a **main.scss** file in your **src/styles** directory and update the styl

Within your style file, import the Vuetify styles and specify the variables you want to override, that's it.

::: info

`'vuetify'` should be used for [global SASS variable](https://github.com/vuetifyjs/vuetify/blob/master/packages/vuetify/src/styles/settings/_variables.scss).

:::

::: info

`'vuetify/settings'` should be used for vuetify [component SASS Variables](features/sass-variables/#variable-api).

:::

::: warning

`'vuetify/styles'` should not be used in sass files as it resolves to precompiled css ([vitejs/vite#7809](https://github.com/vitejs/vite/issues/7809)). `'vuetify'` and `'vuetify/settings'` are valid and safe to use
Expand Down

0 comments on commit ae7a667

Please sign in to comment.