@battlestack/theme
| Install | |
|---|---|
npm install @battlestack/theme |
|
| Latest Version: | 1.4.0 |
| Vue: | 3 |
| License: | MIT |
| Last Updated: | Oct 21, 2026 |
| Links: | GitHub · npm |
@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@themeramps (brand / lilac / warm-stone) and the--ui-*values for light and dark. Imported from the project'sapp/assets/css/main.css(after@import "@nuxt/ui"), because@thememust 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 realvar()chains, both modes) andcheck:contract(full ramps only, documented--ui-*names only, every:rootoverride 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
tsp.tools design-system theme as a Nuxt layer (Nuxt UI v4 + Tailwind v4): amber-...
Cross-framework design system tokens, Tailwind plugin, and variants for CUI
Public Battlestack preset: Nuxt 4 framework + open-source features. (Versioned f...
A reusable Nuxt foundation for content-driven happydesigns websites and applicat...
A premium card component library for Nuxt 4 with cinematic image filters, warm s...
Version History
| Version | Released | Vue | License |
|---|---|---|---|
| 1.4.0 | ^3.0 | MIT | |
| 1.3.0 | ^3.0 | MIT |