Skip to content

StratoLMS themes

StratoLMS has a built-in, build-time theme with four replaceable layers: tokens, UI primitives, domain blocks, and page layouts. The default paper preset preserves the original warm identity; slate and ink are included for different product voices.

  • Change a colour or spacing value in root theme.config.ts under tokens, or choose paper, slate, or ink under preset.
  • Change a page composition with layouts.home, layouts.catalog, layouts.course, or layouts.learn.
  • Run stratolms theme eject CourseCard to copy a built-in component into src/theme/overrides/ and make it yours.

The registry is resolved at build time: built-in < local override. Customize the built-in theme through tokens, layouts, and creator-owned local overrides.

The starter CSP permits same-origin images and data: images, but not remote hero origins. Keep images local and provide heroAlt. Do not use style attributes or Astro define:vars; use data attributes, CSS tokens, and scoped style blocks. The starter intentionally uses system font stacks and no web-font request by default.

Curriculum.astro, CourseCard.astro, Pricing.astro, and their siblings now live under src/theme/components/blocks/. A site that edited one of those files should re-apply its change as an override with stratolms theme eject.

The blocked VideoEmbed inline aspect-ratio attribute was fixed separately: ratios now use the CSP-safe MediaFrame data contract. This behavioural fix is independent of the additive theme redesign.

See tokens, components, layouts, overriding, and the external-theme decision.