#4199: uikit-theme.scss

site/_sass/uikit/uikit-theme.scss

Path: site/_sass/uikit/uikit-theme.scss · Type: SCSS — master theme entry point

Purpose: The single SCSS file imported by Jekyll's main CSS entry point (assets/css/main.scss) — orchestrates the entire CSS build by importing variables, theme overrides, all 63 component theme files, and all core component files in correct dependency order. The architectural backbone of the site's CSS.

Source: GitHub

9 lines · 2 code · 3 comments · 4 blank

The complete CSS compilation chain

Commit	Message
`ac75fabf3`	Github pages migrated to Asciidoc

When Jekyll builds the site, the CSS compilation flows through exactly 5 files before producing the final output:

Step	File	What it does
1	`assets/css/main.scss`	Jekyll entry point — has empty front matter (`---\n---`) which tells Jekyll to process this file. Contains: `@import "uikit/uikit-theme.scss";`
2	uikit-theme.scss (this file)	Imports variables → theme overrides → all 63 component theme files → all core component files
3	`variables.scss` (#4091) + `variables-theme.scss` (#4092)	Defines and overrides design tokens
4	63 theme/*.scss files	Visual styling for each component (colors, shadows, fonts) — loaded via `_import.scss` (#4052)
5	60+ components/*.scss files	Functional CSS (layout, grid, positioning) — loaded via multiple `_import.*.scss` files

This file contains almost no CSS rules of its own — it's an aggregator/manifest. Its @import order is carefully sequenced: variables first (so components can reference them), theme overrides second (selectively modifying core defaults), then all component styles.

Key takeaways

The single import point: Everything the site's CSS needs flows through this file. Remove an import here, and that component's styles disappear.
@import deprecation: SCSS @import is deprecated in Dart Sass 2.0+. Future migration to @use/@forward will require restructuring this file.
Parent dependency: assets/css/main.scss must have Jekyll front matter (even empty) for Jekyll to process it. Without it, Jekyll treats it as a static asset and doesn't compile SCSS.