Customization

We recommend you customize your theme styles using the user style files. You can customize the theme’s styles with the following approaches:

Gulp based workflow

user.scss

You can add your own SCSS and override the theme style in the src/scss/user.scss file

_user-variables.scss

To make broader changes to the design of the theme, such as changing the color scheme or font sizes, use scss/_user-variables.scss. Any variable from scss/bootstrap/_variables.scss or scss/custom/_variables.scss can be overridden with your own value.

If you are not using Gulp based workflow

user.css

You can add your own SCSS and override the theme style in the public/assets/css/user.css file

Changing theme colors

Using SCSS variable:

You can bring your necessary variable colors form src/scss/theme/_colors.scss and paste it into src/scss/_user-variables.scss then update variables as your necessity. We recommend to follow this approach.

If you want to update any color, find the corresponding variable for thise color and place theme to _user-variables.scss file.

See bootstrap documentation for more details

$primary: $blue !default; 
$secondary: $gray-600 !default;
$success: $green !default;
$info: $cyan !default;
$warning: $yellow !default;
$danger: $red !default;
$light: $gray-100 !default;
$dark: $gray-1100 !default;

$body-color: $gray-900 !default;
$body-bg: $gray-100 !default;

$body-secondary-color: $gray-700 !default;
$body-secondary-bg: $gray-200 !default;

$body-tertiary-color: $gray-800 !default;
$body-tertiary-bg: $gray-300 !default;

$body-highlight-color: $gray-1000 !default;
$body-emphasis-color: $black !default;

Using CSS variable:

To update theme color with this approach, you have to update CSS variable. If you change any color you have to assign it's corresponding RGB color too. Please note sometimes you may need to update corresponding component's CSS variable.

See bootstrap documentation for more details

:root,
[data-bs-theme="light"] {
  --sparrow-primary:  #00d27a;
  --sparrow-primary-rgb: 0, 210, 122;
  --sparrow-body-color: #555555;
  --sparrow-body-color-rgb: 85, 85, 85;
  ...
  ...
  ...

  .btn-primary {
    --sparrow-btn-color: #fff;
  }
}