🚀 NeoUI: High-Performance Brutalist Design System

NeoUI is a "shadcn-inspired" component library designed for the modern web. It combines a high-performance Rust-based CLI with a premium, high-contrast React component library.

✨ Features

• ⚡ Lightning Fast CLI: Built in Rust for zero-overhead component injection.
• 🎨 Neo-Brutalist Aesthetic: High-contrast, sharp-edged, and vibrant design tokens.
• ♿ Fully Accessible: Built on top of Radix UI primitives with ARIA compliance.
• 🌓 Dark Mode Ready: Optimized for high-impact pure black dark modes.
• 🧪 Production Ready: Complete Storybook documentation and Vitest Browser test suites.

🛠️ Architecture

NeoUI is structured as a modular ecosystem:

• /cli: The Rust core responsible for init and add <component> commands.
• /packages/registry: Source templates for all Neo components.
• /web: Documentation and visual playground.

🚀 Getting Started

1. Initialize NeoUI

Bootstrap your project with the Neo design system (colors, shadows, and base utilities).

npx @pd241008/neoui init

2. Add Components

Inject components directly into your codebase.

npx @pd241008/neoui add button
npx @pd241008/neoui add card
npx @pd241008/neoui add badge
npx @pd241008/neoui add tabs

3. Theme Orchestration

NeoUI comes with built-in theme support.

npx @pd241008/neoui add theme-provider
npx @pd241008/neoui add theme-toggle

🧪 Testing

We believe in high-fidelity testing. Every component is verified using:

• Storybook: Visual isolation and variant documentation.
• Vitest Browser: Real-world browser interaction tests via Playwright.

# Run visual playground
npm run storybook

# Run browser tests
npm exec vitest run

📜 License

MIT

🎯 Project Roadmap

• Phase 1: Brutalist Design System Foundations.
• Phase 2: Rust CLI Scripts & Component Frontend Scaffold.
• Phase 3: Component Library Completion.
• Phase 4: Documentation & Release.