diff --git a/DESIGN-GUIDE.md b/DESIGN-GUIDE.md new file mode 100644 index 00000000..d9cb472c --- /dev/null +++ b/DESIGN-GUIDE.md @@ -0,0 +1,183 @@ +# IGNY8 Design System Guide + +> **Single Source of Truth for UI Components** +> +> This guide ensures consistent, maintainable frontend code across the entire application. + +--- + +## Quick Links + +| Resource | Path | Description | +|----------|------|-------------| +| **Component System** | [docs/30-FRONTEND/COMPONENT-SYSTEM.md](docs/30-FRONTEND/COMPONENT-SYSTEM.md) | Full component reference with props, examples, and usage | +| **ESLint Plugin** | [frontend/eslint/](frontend/eslint/) | Custom rules enforcing design system | +| **Live Demo** | `/ui-elements` route | Interactive component showcase | +| **Design Tokens** | [frontend/src/styles/design-system.css](frontend/src/styles/design-system.css) | CSS variables and tokens | +| **Icons** | [frontend/src/icons/](frontend/src/icons/) | All SVG icons | + +--- + +## Core Principles + +### 1. Use Components, Never Raw HTML + +```tsx +// ❌ NEVER + + + + + +// ✅ ALWAYS + + +