Customization
Customize the STON.fi Widget appearance with themes, CSS variables, and the visual constructor.
You can change the STON.fi Widget's appearance through CSS custom properties (CSS variables). Override the color palettes to change the overall theme, or set component variables to customize individual elements. You can also adjust spacing, borders, corner radius, and widths.
Use the visual constructor to configure the appearance and preview your changes in the Theme tab. In the Export tab, copy the generated CSS and JavaScript configuration or a complete HTML example into your project.
Declare custom properties on the same container you pass to widget.mount(). Put these rules in your application's stylesheet.
Color variables
The widget uses two 12-step palettes: --accent-1 through --accent-12 for accent colors, and --grey-1 through --grey-12 for neutral colors. Shared text, icon, and component colors reference these palettes through var(). Override any palette variable to change the colors that use it.
Light and dark themes
The widget uses the light theme by default. Add the dark class to the container to use the dark theme:
<div id="omniston-widget-container" class="dark"></div>Use the container selector for shared overrides and add .dark for dark-theme values. This example changes the accent colors used by buttons and other elements:
#omniston-widget-container {
--accent-9: #7c3aed;
--accent-11: #6d28d9;
}
#omniston-widget-container.dark {
--accent-9: #8b5cf6;
--accent-11: #c4b5fd;
}You can switch themes at runtime by adding or removing the container's dark class.
Palette defaults
Each palette has separate light and dark values. You can override the complete palette or individual shades:
--accent-1
#fbfdff
#09111d
--accent-2
#f5f9ff
#0e1827
--accent-3
#e9f3ff
#0c264b
--accent-4
#daecff
#093065
--accent-5
#c8e2ff
#0e3b78
--accent-6
#b3d4ff
#174789
--accent-7
#99c3ff
#1f539d
--accent-8
#72aafc
#2462b8
--accent-9
#0071f0
#0071f0
--accent-10
#0063e0
#0063e0
--accent-11
#006ae8
#7eb8ff
--accent-12
#073168
#cfe3ff
--grey-1
#fcfcfc
#111111
--grey-2
#f9f9f9
#191919
--grey-3
#efefef
#222222
--grey-4
#e8e8e8
#2a2a2a
--grey-5
#e0e0e0
#313131
--grey-6
#d8d8d8
#3a3a3a
--grey-7
#cecece
#484848
--grey-8
#bbbbbb
#606060
--grey-9
#8d8d8d
#6e6e6e
--grey-10
#838383
#7b7b7b
--grey-11
#646464
#b4b4b4
--grey-12
#202020
#eeeeee
Shared colors
These variables control the widget background, borders, text, icons, and status colors. Override them to change a shared color without replacing the palette:
--background-color
#f4f4f4
#0f0f0f
--background-hover-color
var(--grey-3)
var(--grey-3)
--border-color
var(--grey-4)
var(--grey-4)
--text-primary-color
var(--grey-12)
var(--grey-12)
--text-secondary-color
var(--grey-9)
var(--grey-9)
--text-accent-color
var(--accent-9)
var(--accent-9)
--icon-primary-color
var(--text-primary-color)
var(--text-primary-color)
--icon-secondary-color
var(--grey-8)
var(--grey-8)
--icon-accent-color
var(--text-accent-color)
var(--text-accent-color)
--success-color
#15a45f
#15a45f
--danger-color
#e9354b
#e9354b
--warn-color
#ff8409
#ff8409
Component variables
Override a component variable to change that component independently of the shared colors. The tables list the current defaults, including references to palette and shared variables. Values without separate theme columns apply to both light and dark themes.
For example, customize primary buttons without changing the accent palette used elsewhere:
Icon buttons
--icon-button-text-color
var(--icon-primary-color)
--icon-button-background-color
var(--background-color)
--icon-button-background-hover-color
var(--grey-2)
--icon-button-border-width
var(--border-width)
--icon-button-border-radius
var(--border-radius)
--icon-button-border-color
var(--border-color)
Switches
--switch-track-border-width
var(--border-width)
var(--border-width)
--switch-track-border-radius
var(--border-radius)
var(--border-radius)
--switch-track-checked-border-color
var(--accent-9)
var(--accent-9)
--switch-track-checked-background-color
var(--accent-9)
var(--accent-9)
--switch-track-checked-background-hover-color
var(--accent-11)
var(--accent-11)
--switch-track-unchecked-border-color
var(--grey-4)
var(--grey-4)
--switch-track-unchecked-background-color
var(--grey-3)
var(--grey-5)
--switch-track-unchecked-background-hover-color
var(--grey-5)
var(--grey-8)
--switch-thumb-background-color
var(--grey-1)
var(--grey-12)
--switch-thumb-border-width
var(--border-width)
var(--border-width)
--switch-thumb-border-radius
var(--border-radius)
var(--border-radius)
--switch-thumb-checked-border-color
var(--accent-9)
var(--accent-9)
--switch-thumb-unchecked-border-color
var(--grey-4)
var(--grey-4)
Primary buttons
--button-primary-text-color
var(--grey-1)
var(--grey-12)
--button-primary-text-hover-color
var(--grey-1)
var(--grey-12)
--button-primary-text-disabled-color
var(--grey-1)
var(--grey-12)
--button-primary-background-color
var(--accent-9)
var(--accent-9)
--button-primary-background-hover-color
var(--accent-11)
var(--accent-11)
--button-primary-background-disabled-color
var(--grey-7)
var(--grey-7)
--button-primary-border-radius
var(--border-radius)
var(--border-radius)
Secondary buttons
--button-secondary-text-color
var(--accent-9)
var(--accent-9)
--button-secondary-text-hover-color
var(--accent-9)
var(--accent-9)
--button-secondary-text-disabled-color
var(--grey-8)
var(--grey-8)
--button-secondary-background-color
transparent
transparent
--button-secondary-background-hover-color
var(--accent-3)
var(--accent-3)
--button-secondary-background-disabled-color
var(--background-color)
var(--background-color)
--button-secondary-border-width
var(--border-width)
var(--border-width)
--button-secondary-border-radius
var(--border-radius)
var(--border-radius)
--button-secondary-border-color
var(--accent-6)
var(--accent-8)
--button-secondary-border-hover-color
var(--accent-6)
var(--accent-8)
--button-secondary-border-disabled-color
var(--grey-8)
var(--grey-8)
Inputs
--input-border-radius
var(--border-radius)
var(--border-radius)
--input-border-color
var(--grey-4)
var(--grey-5)
--input-background-color
var(--grey-3)
var(--grey-3)
--input-placeholder-color
var(--grey-8)
var(--grey-8)
--input-caret-color
var(--accent-9)
var(--accent-9)
--input-active-background-color
var(--grey-1)
var(--grey-1)
--input-active-border-color
var(--accent-9)
var(--accent-9)
--input-invalid-border-color
var(--danger-color)
var(--danger-color)
Input border width uses the shared --border-width variable.
Form sections
--form-background-color
var(--grey-2)
--form-border-color
var(--border-color)
--form-border-width
var(--border-width)
--form-border-radius
var(--border-radius)
Dialogs and drawers
--dialog-background-color
var(--grey-1)
--dialog-border-color
var(--border-color)
--dialog-border-width
var(--border-width)
--dialog-border-radius
var(--border-radius)
--dialog-overlay-background-color
rgba(0, 0, 0, 0.25)
Alerts
--alert-text-color
var(--accent-10)
var(--grey-11)
--alert-icon-color
var(--accent-9)
var(--accent-11)
--alert-border-color
var(--accent-6)
var(--accent-6)
--alert-border-width
var(--border-width)
var(--border-width)
--alert-border-radius
min(var(--border-radius), var(--max-border-radius))
min(var(--border-radius), var(--max-border-radius))
--alert-background-color
var(--accent-5)
var(--accent-4)
Tooltips
--tooltip-background-color
var(--form-background-color)
--tooltip-border-color
var(--border-color)
--tooltip-border-width
var(--border-width)
--tooltip-border-radius
min(var(--border-radius), var(--max-border-radius))
--tooltip-text-color
var(--text-primary-color)
Toggle groups
--toggle-group-border-width
var(--border-width)
var(--border-width)
--toggle-group-border-radius
var(--border-radius)
var(--border-radius)
--toggle-group-text-color
var(--grey-12)
var(--grey-12)
--toggle-group-border-color
var(--grey-4)
var(--border-color)
--toggle-group-background-color
transparent
transparent
--toggle-group-hover-text-color
var(--accent-11)
var(--accent-12)
--toggle-group-hover-border-color
var(--toggle-group-border-color)
var(--toggle-group-border-color)
--toggle-group-hover-background-color
var(--grey-2)
var(--grey-2)
--toggle-group-selected-text-color
var(--accent-10)
var(--grey-11)
--toggle-group-selected-border-color
var(--accent-10)
var(--accent-10)
--toggle-group-selected-background-color
var(--accent-5)
var(--accent-4)
Snackbars
--snackbar-background-color
var(--form-background-color)
--snackbar-border-color
var(--border-color)
--snackbar-border-width
var(--border-width)
--snackbar-border-radius
var(--border-radius)
Asset swap button
--swap-button-icon-color
var(--icon-primary-color)
--swap-button-background-color
var(--background-color)
--swap-button-border-color
var(--border-color)
--swap-button-border-width
var(--border-width)
--swap-button-border-radius
var(--border-radius)
--swap-button-hover-background-color
var(--form-background-color)
Active order button
--active-order-button-background-color
var(--grey-4)
--active-order-button-border-color
var(--border-color)
--active-order-button-border-width
var(--border-width)
--active-order-button-border-radius
var(--border-radius)
Loading skeletons
--skeleton-background-gradient
linear-gradient(90deg, var(--grey-3) 0%, var(--grey-6) 50%, var(--grey-3) 100%)
--skeleton-border-radius
var(--border-radius)
Labels
--label-border-radius
var(--border-radius)
Layout and icons
Use these variables to adjust the widget's dimensions, spacing, and borders. Component border widths and radii reference the shared variables unless you override them individually.
--widget-width
600px
Maximum container width.
--widget-padding
24px
Container padding.
--spacing-base
4px
Base unit for the spacing scale.
--border-width
1px
Shared border width.
--border-radius
0px
Shared corner radius.
--max-border-radius
16px
Corner-radius limit for alerts and tooltips.
--dialog-width
440px
Desktop dialog width.
--snackbar-width
var(--dialog-width)
Snackbar width.
--breakpoint-md
48rem
Breakpoint for switching between desktop dialogs and mobile drawers, read when mounted.
The container has a minimum width of 340px. This example sets its maximum width, padding, and corner radius:
Set data-icon-variant on the container to choose square icons (the default) or rounded icons:
Last updated