Overview
The default theme consists of JSON files listed below.
- Global / core
- Global / brand
- Global / font
- Global / data-viz
- themes
- density
- dimensions
-
radius
JSON files |
Description |
---|---|
core (VUD) |
Defines the various design aspects such as: |
brand |
Defines the colour tokens and border-radius to uphold branding consistency across global settings. |
font |
Defines the font-family, type scale, font size & viewport. |
data-viz |
Defines the colours for charts. |
themes |
Defines the light and dark modes on the component level. |
density |
Defines the height for table rows and lists. |
dimensions |
Defines the size of an element. |
radius |
Defines the corner on an element. |
Token Studio
All VUD components inherit the default theme but can be customised to match your design requirements. The tokens in the default theme can be overridden.
Global level
Token ID |
What to do? |
Notes |
Where is the token applied within the UI? |
---|---|---|---|
Global/brand/[team]*
For example: |
1. Set up a token set of base tokens. |
This is where you store your colour palette.
Global/core are advised not to modify. |
N/A |
Global/brand/brand |
Assign a branding token by choosing the base token from Global/brand/[company]
|
Make sure to select the accurate base tokens when assigning to branding tokens. |
N/A |
Themes/light/ref Themes/dark/ref |
"If you need to change the branding colours, visit these individual tokens:
2. nav-hor-brand 3. nav-vert-brand 4. nav-stepper
5. toggle |
Notes |
✅ Text ✅ Icon ✅ Pictogram ✅ Border ✅ Fill ✅ Shade ✅ Tint ✅ Scheme |
Token ID |
Notes |
---|---|
radii.none
radii.xs radii.s radii.md radii.lg radii.xl radii.xxl radii.xxxl |
You can customise the border-radius. |
scale.const.min (scale)
scale.const.min.f0 (base) |
You can adjust the ratio to scale the font sizes. |
Component level
Token ID |
Notes |
Where is the token applied within the UI? |
---|---|---|
radius.round radius.sharp
radii.button radii.card radii.inputs radii.list radii.modal radii.panel |
You can customise the border-radius. |
✅ Single layer
✅ Button ✅ Inputs ✅ Modal ✅ Panel
|
density.condensed density.default density.regular density.relaxed |
You can customise the density. |
✅ List ✅ Table row |
dimension.size |
You can customise the dimensions. |
✅ Avatars |
Updates
To get the latest updates from the main library, you need to:
- If you have a branch, click on the icon with the blue dot
- If you work locally, copy/paste your JSON in a text edit file. You'll find the JSON {} upper right corner.
You would need to:
1. Pull your changes first to GitHub
2. Pull from GitHub to get the latest updates from VUD
When you pull from GitHub (Main), it will override all your current tokens. You would need to save your JSON in text edit file.