spartan-ng/spartan
Spartan
Spartan is a development framework and design system toolset that combines a headless UI component library with a full-stack application scaffolder. It provides accessible, unstyled primitives that separate behavioral logic from visual styling, while automating the creation of development environments with end-to-end type safety across API and database layers.
The project distinguishes itself by utilizing a component distribution model that copies styled source files directly into the local codebase to prevent dependency-based style locking. It also functions as an AI context server, using a protocol server to provide large language models with real-time documentation and architectural specifications to ensure generated code adheres to project composition rules.
The framework includes a command line interface for bootstrapping workspaces, installing functional skills, and managing design systems. It handles visual theming through CSS variables and semantic color pairs, allowing for runtime theme switching and customized design tokens.
The toolset is implemented in TypeScript and provides mechanisms to inspect project configurations and export workspace types as structured data.
Features
- Code Context Servers - Functions as a protocol server that exposes real-time documentation and architectural specifications to coding agents.
- Accessible UI Frameworks - Provides a framework for building interfaces with headless primitives that manage ARIA logic and visual control.
- Copy-Paste UI Frameworks - Distributes styled UI elements as source code that is copied directly into the local codebase to avoid dependency locking.
- AI Coding Assistant Guidance - Shares architectural patterns and composition rules with AI agents to ensure correct interface implementation.
- Context-Aware Code Generators - Synthesizes code that adheres to project architectural patterns by analyzing configuration, component APIs, and composition rules.
- Model Context Protocol Servers - Functions as a Model Context Protocol server to provide AI agents with real-time documentation and architectural specifications.
- Documentation Servers - Exposes technical documentation through a protocol server for retrieval by AI assistants and development tools.
- Bootstrap Installations - Provides a CLI to bootstrap the development environment by installing a predefined set of libraries and functional skills.
- UI Project Scaffolders - Provides a command line interface for bootstrapping workspaces and adding complete UI libraries to a project.
- End-to-End Type Safety Frameworks - Ensures consistent data structures and type safety across the entire stack, from the backend API to the frontend interface.
- Custom Color Theme Definitions - Updates application colors and semantic themes using CSS variables without modifying components.
- Headless Primitives - Provides accessible, unstyled headless primitives that separate behavioral logic from visual styling.
- Component Library Managers - Implements a system for assembling and customizing interface components by copying source files to avoid dependency locking.
- CSS Variable Theming - Implements a theming system using native CSS variables and semantic color pairs for dynamic runtime style switching.
- Documentation Context Providers - Serves component specifications and documentation via a protocol server to help AI coding assistants generate accurate code.
- Local-Source Component Distribution - Distributes UI components by duplicating raw source files into the project, allowing for full local ownership and modification.
- Unstyled Component Primitives - Installs accessible, unstyled headless UI primitives and their associated logic packages into the codebase.
- Source-File Component Distribution - Distributes styled UI elements by duplicating source files into the local codebase to prevent dependency locking.
- Design System Implementations - Centralizes visual tokens and semantic color pairs via CSS variables to maintain a consistent branding and layout.
- Headless UI Libraries - Provides a library of accessible, unstyled primitives that separate behavioral logic from visual styling.
- Visual Theme Configurations - Establishes a consistent visual look by selecting themes, border radius, and style entry points.
- Full-Stack Application Boilerplates - Scaffolds a complete development environment with integrated API and database layers to ensure end-to-end type safety.
- Type-Safe Scaffolders - Bootstraps integrated development environments with end-to-end type safety across the API and database layers.
- Full-Stack Development - Combines frontend and backend tools to achieve end-to-end type safety and rapid development.
- Project Bootstrapers - Uses a CLI to automate the initialization of project structures, including the integration of UI libraries and schematics.
- Skill Installation - Provides a command line interface to add and register reusable functional skills into an AI agent directory.
- Component Discovery Services - Allows AI agents to query a protocol server to confirm available APIs and examples before generating code.
- UI Styling and Themes - Enables the configuration of visual themes, border radii, and style entry points for a consistent design system.
- AI-Powered Development Environments - Combines a headless UI library and full-stack scaffolder with an AI context server for context-aware development.
- Schema-Driven Code Generators - Generates project-specific code by analyzing predefined composition rules and component APIs to ensure pattern adherence.
- UI Composition Rules - Validates code against semantic color patterns and nesting rules to ensure correct component usage.
- CLI Component Generators - Provides a CLI to generate individual UI elements by installing primitives and copying style files into the project.
- Component Installation CLIs - Uses a CLI to automate the injection of accessible UI component source code and their required logic dependencies.
- Custom Semantic Color Registrations - Allows registration of new purpose-driven background and foreground color pairs for use with utility classes.
- Light and Dark Theme Systems - Implements light and dark color schemes via CSS custom properties that switch automatically via class changes.
- Management Toolsets - Provides a command line interface for managing CSS variables, semantic colors, and the installation of themed components.
- Interface Accessibility - Composes user interfaces using headless primitives for inputs and navigation that prioritize accessibility.
- UI Component Styling - Applies a design system using copy-paste CSS classes to maintain full ownership of visual appearance.
- Full-Stack Web Applications - Integrates database and API layers to move a full-stack application from development to production.
