Skip to content

Customizing

Overview

Wisp does not ship with a settings file. Instead, every default is a CSS custom property with a sensible fallback value built in. This means you can drop Wisp into a project and start immediately without configuring anything.

When you are ready to make it your own, override any property in your own stylesheet using the cascade the way it was always intended to be used. Wisp does not need to know about your changes.

css
:root {
    --wisp-color-primary: #e63946;
    --wisp-spacing-md: 1.25rem;
}

Custom Properties

Spacing

PropertyDefault
--wisp-spacing-xs0.25rem
--wisp-spacing-sm0.5rem
--wisp-spacing-md1rem
--wisp-spacing-lg1.5rem
--wisp-spacing-xl3rem

Typography

PropertyDefault
--wisp-font-familysans-serif
--wisp-font-size-hero3rem
--wisp-font-size-4x2.25rem
--wisp-font-size-3x1.875rem
--wisp-font-size-2x1.5rem
--wisp-font-size-xl1.25rem
--wisp-font-size-lg1.125rem
--wisp-font-size-md1rem
--wisp-font-size-sm0.875rem
--wisp-font-weight-bold700
--wisp-font-weight-semibold600
--wisp-font-weight-medium500
--wisp-font-weight-regular400
--wisp-line-height1.5

Colors

PropertyDefault
--wisp-color-text#0f172a
--wisp-color-link#0d6efd
--wisp-color-primary#1d4ed8
--wisp-color-primary-text#ffffff
--wisp-color-secondary#475569
--wisp-color-secondary-text#ffffff
--wisp-color-neutral#f1f5f9
--wisp-color-neutral-text#0f172a
--wisp-color-surface#ffffff
--wisp-color-surface-text#0f172a
--wisp-color-focus#3b82f6

Components

Badge

PropertyDefault
--wisp-badge-border-radius4px

Box

PropertyDefault
--wisp-box-border-color#ccc
--wisp-box-border-radius6px

Button

PropertyDefault
--wisp-button-border-radius4px

Card

PropertyDefault
--wisp-card-border-color#ccc
--wisp-card-border-radius6px

Container

PropertyDefault
--wisp-container-width1140px

Input

PropertyDefault
--wisp-input-border-color#8c8c8c
--wisp-input-border-radius4px

Scroll

PropertyDefault
--wisp-scroll-border-color#ccc
--wisp-scroll-min-width40em

Table

PropertyDefault
--wisp-table-border-color#ccc
--wisp-table-cell-block-padding0.5rem
--wisp-table-cell-inline-padding1rem

Behaviors

PropertyDefault
--wisp-press-duration200ms