DocsBlog

Get Started

Components

Data Grid

Signals

Styling

Theming

↑↓Navigate
↵Select
cmd + cCopy URL
EscClose
  • 1.9.0

  • Day

    Night

    Preview

    Switch mode
  • cerberus

    acheron

    elysium

    oceanus

Get Started
Components
Data Grid
Signals
Styling
Theming

Concepts

OverviewTokensSemantic TokensRecipesSlot Recipes

Design Tokens

AnimationsColorsGradientsSpacingShadowsFontZ-Index

Shadows

Shadow design tokens available in the Cerberus Design System.

View as Markdown
Open this page in Markdown
Anthropic
Open in Claude
Ask questions about this page
OpenAI
Open in ChatGPT
Ask questions about this page

Overview

Shadow tokens represent the shadow of an element. They provide depth and hierarchy to your interface by creating visual layers. Cerberus provides a set of predefined shadow tokens that you can use throughout your application.

Tokens

Cerberus provides the following shadow tokens:

2xs
--cerberus-shadows-2xs
xs
--cerberus-shadows-xs
sm
--cerberus-shadows-sm
md
--cerberus-shadows-md
lg
--cerberus-shadows-lg
xl
--cerberus-shadows-xl
2xl
--cerberus-shadows-2xl
inner
--cerberus-shadows-inner
inset-2xs
--cerberus-shadows-inset-2xs
inset-xs
--cerberus-shadows-inset-xs
inset-sm
--cerberus-shadows-inset-sm

Usage

You can use shadow tokens with the shadow or boxShadow props:

import { Box } from "styled-system/jsx"
 
// Using predefined shadow tokens
 
<Box shadow="sm">Small shadow</Box>
<Box shadow="md">Medium shadow</Box>
<Box shadow="lg">Large shadow</Box>
 
// Using boxShadow prop
 
<Box boxShadow="md">Medium shadow</Box>

Custom Shadows

You can also define custom shadow tokens in your theme configuration:

import { createCerberusConfig, createCerberusPreset } from '@cerberus/panda-preset'
 
export default createCerberusConfig({
  presets: [createCerberusPreset()],
 
  include: ['./app/**/*.{ts,tsx}'],
  exclude: [],
 
  theme: {
    extend: {
      tokens: {
        shadows: {
          custom: {
            value: '0 4px 8px rgba(0, 0, 0, 0.1)',
          },
          glow: {
            value: '0 0 20px rgba(59, 130, 246, 0.5)',
          },
        },
      },
    },
  },
})

Shadow Values

The shadow tokens support both string values and composite objects:

String Values

shadows: {
  simple: {
    value: '0 1px 3px rgba(0, 0, 0, 0.1)'
  }
}

Composite Values

shadows: {
  complex: {
    value: {
      offsetX: 0,
      offsetY: 4,
      blur: 8,
      spread: 0,
      color: "rgba(0, 0, 0, 0.1)"
    }
  }
}

Multiple Shadows

shadows: {
  layered: {
    value: ['0 1px 2px rgba(0, 0, 0, 0.05)', '0 4px 8px rgba(0, 0, 0, 0.1)']
  }
}

On this page

  • Overview
  • Tokens
  • Usage
  • Custom Shadows
  • Shadow Values
    • String Values
    • Composite Values
    • Multiple Shadows
Edit this page on Github