@battlestack/theme

Battlestack Design System Nuxt — the Nuxt UI theme: token values for light and dark, brand assets, and the Logo lockup. No components; Nuxt UI is the component library.
254 3
Install
npm install @battlestack/theme
Latest Version:1.4.0
Vue:3
License:MIT
Last Updated:Oct 21, 2026
Links: GitHub  ·  npm
Maintainer: joris-sevenlab

@battlestack/theme

Battlestack Design System Nuxt as a Nuxt layer. No components — Nuxt UI is the component library; this package themes it and nothing else.

Source of truth: the "Battlestack Design System Nuxt" project on claude.ai/design. Values change there first and are mirrored here.

What it ships

  • tokens.css — Tailwind @theme ramps (brand / lilac / warm-stone) and the --ui-* values for light and dark. Imported from the project's app/assets/css/main.css (after @import "@nuxt/ui"), because @theme must compile inside the project's Tailwind root.
  • <BsLogo> — the Battlestack lockup, the layer's only component (brand, not UI).
  • Brand SVG assets (assets/).
  • Gates: check:contrast (WCAG pairs through the real var() chains, both modes) and check:contract (full ramps only, documented --ui-* names only, every :root override restated in .dark).

How a project consumes it

nuxt4:battlestack-theme (in @battlestack/preset-nuxt4) wires it up: extends: ['@battlestack/theme'], the two @imports in main.css, the semantic alias map (primary: 'brand', secondary: 'lilac', neutral: 'stone') in app.config.ts, and a project-owned app/assets/css/brand.css for local token overrides.

A client theme is a copy of this package with different values — same names, same shape, check:contract enforces it.

Related Packages

@thespielplatz/tsp-tools-theme

tsp.tools design-system theme as a Nuxt layer (Nuxt UI v4 + Tailwind v4): amber-...

3,240
@cui-universal/theme

Cross-framework design system tokens, Tailwind plugin, and variants for CUI

108 2
@battlestack/preset-nuxt4

Public Battlestack preset: Nuxt 4 framework + open-source features. (Versioned f...

986 3
@happydesigns/ui

A reusable Nuxt foundation for content-driven happydesigns websites and applicat...

3,059 1
@xenterprises/nuxt-x-cards

A premium card component library for Nuxt 4 with cinematic image filters, warm s...

2,272

Version History

Version Released Vue License
1.4.0 ^3.0 MIT
1.3.0 ^3.0 MIT