Skip to content

refactor(theme)!: replace legacy shadow variables - #2521

Draft
spike-rabbit wants to merge 1 commit into
mainfrom
refactor/theme-system-shadow-tokens
Draft

refactor(theme)!: replace legacy shadow variables#2521
spike-rabbit wants to merge 1 commit into
mainfrom
refactor/theme-system-shadow-tokens

Conversation

@spike-rabbit

Copy link
Copy Markdown
Member

Summary

Replace legacy elevation and Bootstrap shadow variables with the si-sys-effects-shadow-* system tokens. Update shadow consumers across Element, Bootstrap compatibility styles, maps, dashboards, and AG Grid.

Breaking change

Removed SCSS variables:

  • $element-elevation-1, $element-elevation-2, $element-elevation-3, $element-elevation-4
  • $element-elevation-inset-1, $element-elevation-inset-2, $element-elevation-inset-3, $element-elevation-inset-4
  • $box-shadow, $box-shadow-sm, $box-shadow-lg, $box-shadow-inset, $input-box-shadow
  • $popover-box-shadow, $modal-content-box-shadow-xs, $modal-content-box-shadow-sm-up, $thumbnail-box-shadow

Removed CSS custom properties:

  • --element-box-shadow-color-1
  • --element-box-shadow-color-2

Migrate elevation values to var(--si-sys-effects-shadow-1) through var(--si-sys-effects-shadow-4), or the matching $si-sys-effects-shadow-* SCSS token.

Validation

  • pnpm lib:build
  • pnpm dashboards:build
  • pnpm maps:build
  • pnpm run docs:build
  • Prettier and git diff --check

Use system shadow tokens directly across Element, Bootstrap compatibility styles, maps, dashboards, and AG Grid.

BREAKING CHANGE: Legacy elevation and Bootstrap shadow variables are removed.

Remove uses of $element-elevation-1, $element-elevation-2, $element-elevation-3,
$element-elevation-4, $element-elevation-inset-1, $element-elevation-inset-2,
$element-elevation-inset-3, $element-elevation-inset-4, $box-shadow,
$box-shadow-sm, $box-shadow-lg, $box-shadow-inset, $input-box-shadow,
$popover-box-shadow, $modal-content-box-shadow-xs,
$modal-content-box-shadow-sm-up, and $thumbnail-box-shadow.

Replace elevation values with var(--si-sys-effects-shadow-1) through
var(--si-sys-effects-shadow-4), or the corresponding $si-sys-effects-shadow-*
SCSS system token. The legacy --element-box-shadow-color-1 and
--element-box-shadow-color-2 custom properties are also removed.
@spike-rabbit
spike-rabbit force-pushed the refactor/theme-system-shadow-tokens branch from 7b2c0c3 to f1a70a7 Compare August 6, 2026 18:15
Comment on lines +81 to +84
box-shadow: var(--si-sys-effects-shadow-1);
box-shadow: var(--si-sys-effects-shadow-2);
box-shadow: var(--si-sys-effects-shadow-3);
box-shadow: var(--si-sys-effects-shadow-4);

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should show the SCSS variable. because that's a compile-time check.

Suggested change
box-shadow: var(--si-sys-effects-shadow-1);
box-shadow: var(--si-sys-effects-shadow-2);
box-shadow: var(--si-sys-effects-shadow-3);
box-shadow: var(--si-sys-effects-shadow-4);
box-shadow: variables.$si-sys-effects-shadow-1;
box-shadow: variables.$si-sys-effects-shadow-2;
box-shadow: variables.$si-sys-effects-shadow-3;
box-shadow: variables.$si-sys-effects-shadow-4;

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants