Spartan/ng Developer Guidelines

Pairs with angular-developer - that skill provides Angular fundamentals (signals, DI, routing, forms, SSR, accessibility). This skill focuses on Spartan/ng specifics. Install both for the best experience.

Compatibility

• Tracks: @spartan-ng/brain v1.8.0 (released 2026-10-16). Spartan reached 1.0 stable in June 2026; the 1.x line adds components fast while keeping the API surface versioned and re-validated each bump.
• 1.1 → 1.8 highlights: 1.1 added the month-year picker and full date-input support to Calendar / Date Picker, host-style overrides for brn-radio / brn-checkbox / brn-switch, a CLI scaffold-integrity healthcheck, and strict-CSP inline-style fixes. 1.2 added new message, bubble, attachment, and marker components plus Signal-Forms compatibility for Date Picker and Input OTP. 1.3 / 1.3.1 brought a11y fixes for autocomplete / combobox / command and a defaultOpen option on Sidebar. 1.4 added Questionnaire (Brain + Helm, Signal Forms ready), TanStack Charts integration for Chart (alpha), Slider maxStepsBetweenThumbs / preventStepOverThumb, and a focused-date API on Calendar. 1.5 added Message Scroller for chat transcripts, brn-switch-thumb as a directive plus forceInvalid on Switch, template action / cancelAction for Sonner, and a Tooltip default showDelay / hideDelay of 0. 1.6 added lazy content for Accordion (hlmAccordionContentLazy). 1.7 added configurable Pagination labels. 1.8 added Trace and Code Block components, exportAs on directives, and a CLI that adds every component non-interactively (ui all). Patch releases throughout fixed a11y (select, autocomplete, combobox, dialog, sidebar sheet) and popover / overlay scroll-strategy issues. No breaking API changes across the 1.x line.
• Angular: v21 or v22. @spartan-ng/brain@1.8.0 peers @angular/* >=21.0.0 <23.0.0, so both Angular 21 and 22 are officially supported. Standalone components, control flow (@if / @for), and signal APIs (input() / output()) are assumed; it will not generate NgModule-based or decorator-based code.
• Tailwind: v4 required. Spartan 1.x peers tailwindcss >=4.0.0, v3 is no longer supported. It also pulls in luxon >=3.0.0 (date primitives), clsx >=2.0.0, and tw-animate-css >=1.0.0 as peers, ensure those are installed. See setup.md.
• Not supported: old alphas (v0.0.1-alpha.*) with pre-1.0 API drift, Angular v20 or below, Tailwind v3, projects using @spartan-ng/ui-* packages (deprecated, replaced by @spartan-ng/helm).

If the project's installed version differs significantly from the tracked one, warn the user before generating code, the API surface may have shifted.

1. Always check the project's Spartan/ng version before providing guidance. Spartan is now 1.0 stable but still evolves, package.json is the source of truth.