# How to customize Storefront UI components

One of the key goals of Storefront Ui is to provide you with a ready to use design system with which you can recreate almost every design.

Below you can read how you can customize different aspects of its styles and components.

# Global styles

Usually when you're designing a new app you're starting with a style guide. A style guide is a set of common design standards and principles used in a whole projet. It usually covers things such as typography or colors.

We can represent style guide as a set of global SCSS variables. By using them we are abstracting visual configuration from html and CSS structure tod eclarative variables. Thank to this approach we can ship updates to Storefront UI without breaking your projects.

You can override them to shape the look and feel of your project. There are two groups of available SCSS variables in Storefront UI:

  • Global variables are representing project style guide. They are setting up global properties like like colors or typography. For example below code in sfui.scss will change accent color in your whole project to blue.
$c-accent-primary: blue;
  • Component-specific variables are meant to customize behavior of certain component type (like SfButton). You can find them in documents about certain components. For example below code in sfui.scss will change default (not modified by other CSS rules) background color of every SfButton component in your project to red.
$button-background-color: red;

You can override any of those variables in sfui.scss file in a root of your project.


You can use sfui.scss to create and share completely new design system for Storefront UI

# Per-instance component customization

Even though global and component-specific variables are providing decent level of customization

Almost every Storefront UI component is divided into sections (following BEM convention). Each of them is wrapped into a Vue slot to let you replace parts of it's HTML.

Take a look at below example. This is how SfPagination component look like out of the box:

  @click="page => currentPage = page"

Let's say we want to display prev and next buttons instead of default arrow icons.

In component documentation we can read that it has next and prev slots. We can use them to add our custom behavior. For every slot you have access to methods and data properties related to it's functionality via slot scope. In our case it would be go function that will move forward/backward and isDisabled property that tells us if there is a next or previous page. We can use the latest to disable buttons when they're not usable.

<SfPagination :current="currentPage" :total="20" :visible="5"  @click="page => currentPage = page">
  <template #prev="{ isDisabled, go }">
    <button @click="go()" :disabled="isDisabled ? true : false">prev</button>
  <template #next="{ isDisabled, go }">
    <button @click="go()" :disabled="isDisabled ? true : false">next</button>

This is a result of above modification:

The same way you can customize any other Storefront UI component. Default markup is no longer a problem for us!