An opinionated, feature-rich kit for rapid application development. Built on modern standards (Radix UI, Tailwind CSS) with sensible defaults, yet with flexible escape hatches to customize deeply when needed.
Spezi Web Design System is a general-purpose component and utilities library designed to accelerate web application development by providing well-tested, comprehensive, accessible, and type-safe components out of the box. It strikes a balance between opinionated defaults and customization flexibility - enabling developers to focus on building features rather than implementing UI patterns, while maintaining the option to take ownership when needed.
The library enforces a consistent design language, includes robust state management patterns, and provides a comprehensive set of utilities - handling UI complexity behind the scenes.
As part of the broader Spezi Web ecosystem, this library serves as the foundation for building applications that can be extended with specialized packages (like health-specific components) and bootstrapped with the spezi-web-template-application for rapid project setup.
- 40+ Production-Ready Components - Comprehensive library including atoms (Button, Input, Select), molecules (DashboardLayout, ConsentDialog, NotFound, Notifications), and utilities
- Modern Tech Stack - Built on Radix UI, Tailwind CSS, TypeScript, and React 19
- Theming Support - Customizable design tokens and theme configuration
- Well-Tested - High test coverage with Vitest and Testing Library
- Feature-Rich - Integrated form with validation, data fetching patterns, authentication, application shell, error handling, and more
- Comprehensive Documentation - Interactive Storybook with live examples
- Type-Safe - Full TypeScript coverage with strict typing for enhanced developer experience
- Accessibility First - WCAG-compliant components with built-in keyboard navigation and screen reader support
- Battle-Tested - Used in production by multiple Stanford projects
- 🚀 Getting Started - Installation, setup, and usage guide
- 📚 Interactive Storybook - Browse components, view live examples, and experiment with props
- 📖 API Reference - Detailed technical documentation and API reference
- 🏗️ Template Application - Get started quickly with a complete application setup
Spezi Web Design System is part of a larger ecosystem of tools and packages:
- spezi-web-configurations - Shared ESLint, Prettier, and TypeScript configurations used across Spezi Web projects (including this library)
- spezi-web-template-application - Complete application template that combines all Spezi Web packages for rapid project bootstrapping
Real-world Stanford projects using this library:
- ENGAGE-HF Web Frontend - Heart failure management platform for patients and healthcare providers
- Spezi Web Study Platform - Research study management and participant enrollment system
- RadGPT - AI-powered radiology assistance tool
Refer to them if you need inspiration or guidance on how to use the library in your own projects.
For detailed setup instructions, configuration, and usage examples, see the Getting Started guide.
Spezi Web Design System strikes a balance between highly opinionated frameworks and copy-paste patterns. We provide package-based distribution for automatic updates, strong opinions for faster development, and escape hatches when you need deep customization.
Read more about our rationale, comparisons with alternatives, and detailed trade-offs →
Built on modern standards: TypeScript, React 19, Tailwind CSS v4, and Radix UI. Includes integrations with React Hook Form, Zod, TanStack Table, and more.
View complete technology stack and rationale →
This project is licensed under the MIT License. See Licenses for more information.
This project is developed as part of the Stanford Byers Center for Biodesign at Stanford University. See CONTRIBUTORS.md for a full list of all Spezi Web Design System contributors.
