core ยท diff
git:20250727.a15289d to git:20250728.7290823
2 added, 0 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
---
description: Core architecture and quality rules for React + Vite + shadcn/ui template
globs: ["src/**/*.{tsx,ts}", "package.json", "vite.config.ts", "tailwind.config.ts"]
alwaysApply: true
---
# React + Vite + shadcn/ui Template - Core Rules
## ๐จ CRITICAL ARCHITECTURE RULES
### Component Size & Organization
- **NEVER** create components over 300 lines
- **ALWAYS** break down complex components into smaller, focused pieces (20-100 lines)
- **EXTRACT** reusable logic to custom hooks, not copy-paste
- **USE** composition patterns - build complex UI from smaller components
### File Structure Requirements
```
src/
โโโ components/
โ โโโ ui/ # shadcn/ui components (READ-ONLY)
โ โโโ common/ # Reusable components
โ โโโ forms/ # Form components
โ โโโ features/ # Feature-specific components
โโโ hooks/ # Custom React hooks
โโโ lib/
โ โโโ utils.ts # Utilities (includes cn function)
โ โโโ types.ts # Shared TypeScript types
โ โโโ constants.ts # App constants
โ โโโ validations/ # Zod schemas
โโโ pages/ # Route components (composition only)
โโโ services/ # API calls
โโโ context/ # React context providers
```
### Import Organization
```tsx
// 1. React imports
import React, { useState, useEffect } from 'react'
// 2. Third-party libraries
import { useQuery } from '@tanstack/react-query'
import { zodResolver } from '@hookform/resolvers/zod'
// 3. UI components
import { Button } from '@/components/ui/button'
import { Card } from '@/components/ui/card'
// 4. Local components
import { UserCard } from '@/components/common/UserCard'
// 5. Hooks and utilities
import { useDisclosure } from '@/hooks/useDisclosure'
import { cn } from '@/lib/utils'
// 6. Types and constants
import type { User } from '@/lib/types'
import { API_ENDPOINTS } from '@/lib/constants'
```
### Essential Commands
```bash
npm run dev # Start development server (port 8080)
npm run build # Production build
npm run lint # Run ESLint - MUST pass before shipping
```
### Quality Gates
- **BEFORE SHIPPING**: Run `npm run lint` and fix all issues
- **ACCESSIBILITY**: Maintain WCAG 2.1 AA contrast (4.5:1 minimum)
- **NO CONSOLE ERRORS**: Zero warnings in browser console
- **RESPONSIVE**: Test on mobile and desktop
+ - **DESIGN QUALITY**: Industry-appropriate visual identity with purposeful color psychology
+ - **CUSTOM DESIGN**: Interfaces should feel premium and custom-crafted, not template-like