# Changelog

All notable changes to UI/UX Pro MCP will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.3.0] - 2026-01-20

### Added
- **Multi-platform support**: Auto-detect platform intent (web/mobile-ios/mobile-android/cross-platform) from query keywords
- **Platform parameter**: Explicit `platform` parameter to override auto-detection
- **AI-optimized output format**: New `output_format` parameter with 'ai-optimized' (default ~5K tokens), 'minimal', 'full', 'structured' options
- **Page intent classification**: Smart detection of landing vs dashboard intent from query
- **Platform-aware BM25 boosting**: Re-rank search results based on detected platform
- **40 new mobile UX guidelines** (rows 131-170): Touch targets, reachability, platform-specific patterns, safe areas, gestures
- **6 new component styles** (rows 97-103): Back-to-top button, footer components, section dividers
- **Page intent keywords** in mappings.ts for better query understanding
- **`include_hover_effects` parameter**: Control hover effects CSS inclusion in output

### Changed
- Default output format changed from 'full' to 'ai-optimized' (~67% token reduction)
- Markdown guide restructured with 7 numbered steps for better AI adherence
- Back-to-top button marked as required (was recommended)
- Checklist moved to TOP of markdown guide
- [COPY THIS] markers added for code blocks

### Fixed
- `classifyPageIntent()` now correctly matches "page" keyword (weight increased to 0.6)
- `output_format` parameter now validates input and returns error for invalid values
- Intent detection uses original query instead of expanded query for accurate keyword matching
- "landing page" queries now correctly return landing layouts (not dashboard)
- Dark mode queries now return dark color palettes

### Internal
- **Position-weighted intent classification** (`classifyPageIntent`) for left-to-right query processing
- **Multi-word phrase priority** (e.g., "landing page" beats "dashboard")
- **`_meta` field** in `get_design_system` output with query interpretation, detected intent, confidence, matched keyword, position, and warnings
- **Dark mode color parsing** from `Dark_Mode_Colors` JSON field
- **`css_variables` field** with ready-to-paste CSS custom properties
- **`layout.source` field** indicating "landing" or "dashboard" source
- **Test suite**: `test-design-system.ts` with 13 test cases

## [1.2.1] - 2026-01-19

### Fixed - Data Quality Audit
- **colors.csv**: Fixed 48+ rows with generic #3B82F6 blue palettes → industry-specific research-backed colors
  - E-commerce → Amazon palette, Financial → Bloomberg dark, Analytics → Viridis scientific
  - NFT/Web3 → Cyberpunk neon, Creator Economy → Patreon coral, Music → Spotify green
  - Dating → Tinder pink, Mental Health → Calm/Headspace, Insurance → Progressive blue
  - And 35+ more industry-specific palettes
- **styles.csv**: Fixed JSON syntax errors in rows 84-88, renamed duplicate Neubrutalism
- **typography.csv**: Fixed font mismatches in 6 rows (Satoshi/General Sans → DM Sans configs)
- **icons.csv**: Added License column, removed duplicate BrainCircuit entry (176→175 rows)
- **charts.csv**: Fixed keyword format consistency, removed duplicate Candlestick (37→36 rows)
- **ux-guidelines.csv**: Fixed JS syntax errors in code examples (rows 9, 11, 54, 68)
- **products.csv**: Removed duplicate Creator Economy, fixed Airline keywords (117→116 rows)

### Data Quality
- Total rows validated: ~1,674 across 21 CSV files
- Average quality score: 9.1/10
- Zero CSV validation errors

## [1.2.0] - 2026-01-19

### ⚠️ BREAKING CHANGES
- **Tool consolidation**: Reduced from 12 tools to 6 for better LLM performance
  - `search_ui_styles`, `search_colors`, `search_typography`, `search_prompts` → **`search_styles`**
  - `search_icons`, `search_charts` → **`search_components`**
  - `search_landing`, `search_ux_guidelines`, `search_products` → **`search_patterns`**

### Added
- **Jetpack Compose stack** (70 entries) - Android/Kotlin Compose guidelines
- **Domain filtering** for merged tools:
  - `search_styles`: domain = style | color | typography | prompt
  - `search_components`: type = icon | chart
  - `search_patterns`: type = layout | ux | product
- **Mobile UI/UX 2026 data**:
  - Flutter: Impeller, 120Hz, Rive, Spring physics (+22 entries)
  - React Native: Reanimated 3, Skia, Gesture Handler (+21 entries)
  - SwiftUI: PhaseAnimator, TimelineView, iOS 26 Liquid Glass (+18 entries)
  - Styles: M3 Expressive, mobile animations (+13 entries)
  - Landing: Mobile layouts, bottom nav, adaptive screens (+12 entries)
- **CSV validation script**: `npm run validate:csv`
- **prepublishOnly hook** with automatic CSV validation

### Changed
- Improved tool descriptions with WHEN TO USE, RETURNS, EXAMPLES
- Enhanced `search_all` domain detection
- Total entries: 1,676+ (from ~1,500)

### Fixed
- `styles.csv` line ending normalization (CRLF → LF)
- `landing.csv` CSS formatting issues

## [1.1.9] - 2026-01-19

### Added
- **CSV validation script** (`scripts/validate-csv.js`) - Validates all CSV files for formatting issues
- **npm run validate:csv** command for easy validation
- **Jetpack Compose stack** (`data/stacks/jetpack-compose.csv`) - 70 entries for Android/Kotlin guidelines
- **Mobile layouts** in `landing.csv` (+12 entries) - Bottom sheets, FAB patterns, gesture navigation
- **M3 Expressive styles** in `styles.csv` (+13 entries) - Material 3 Expressive design tokens

### Enhanced
- **Flutter** (+22 entries) - Impeller renderer, 120Hz optimization, Rive animations, Liquid Glass effects
- **React Native** (+21 entries) - Reanimated 3 with Fabric, Skia rendering, Gesture Handler 2.x
- **SwiftUI** (+18 entries) - PhaseAnimator, TimelineView, SF Symbols 5, visionOS spatial

### Fixed
- `styles.csv` line endings (CRLF → LF)
- `landing.csv` CSS formatting issues
- CSV validation integrated into `prepublishOnly` hook

### Stats
- Total: 21 CSV files, 1,704+ entries, 0 validation errors

## [1.1.7] - 2026-01-19

### Added
- **flutter.csv**: 18 new 2026 entries (Dart 3.x records/sealed classes/patterns, Riverpod 2.x code generation, flutter_hooks, Impeller renderer, Material 3, Slivers, auto_route, predictive back, Flutter Web/Desktop, flutter_animate, golden tests, patrol, feature-first architecture, clean architecture, SelectableRegion)
- **react-native.csv**: 8 new 2026 entries (Fabric renderer, TurboModules, Expo Router, Reanimated 3 with Fabric, shared element transitions, Bridgeless mode, React 18 concurrent features, expo-image)
- **swiftui.csv**: 10 new 2026 entries (@Observable macro, SwiftData, SwiftData with Observable manager, TipKit, TipGroup.ordered, StoreKit 2 transactions, StoreKit 2 verification, App Intents, Lazy containers, stable IDs)

## [1.1.6] - 2026-01-18

### Added
- **styles.csv**: 6 new 2026 styles (Bento Grid, Neubrutalism 2026, Organic Biophilic, VisionOS Spatial, Conversational AI UI, Agentic Workflow UI)
- **colors.csv**: 5 new modern color entries (OKLCH Color Space, color-mix() Dynamic Palettes, Display P3 Wide Gamut, AI Confidence Semantic Colors, Earth Biophilic Palette)
- **prompts.csv**: 8 new AI design prompts for 2026 patterns
- **icons.csv**: 5 new AI/accessibility icons
- **typography.csv**: Fluid responsive typography and variable font axes entries
- **charts.csv**: Observable Plot and Nivo library recommendations

### Fixed
- CSV formatting issues in colors.csv rows 116-120

## [1.1.5] - 2026-01-18

### Added - New Landing Patterns
- **Row 47: Tab Navigation Component** - ARIA-compliant tabs with animated indicator, keyboard navigation
- **Row 48: Analytics Dashboard Layout** - KPI cards grid, chart widgets, responsive design
- **Row 49: Mega Menu Navigation** - Multi-column dropdown, keyboard focus management

### Enhanced - 2026 Best Practices Audit
- **Row 45 (Slider/Carousel)**: Embla/Swiper patterns, CSS scroll-snap, RTL support, prefers-reduced-motion, ARIA accessibility
- **Rows 8, 14 (Pricing)**: Framer Motion toggle animation, badge pop effect, price counter animation
- **Rows 2, 33 (Testimonials)**: Video testimonials, masonry layout, infinite marquee, lazy load avatars, platform badges
- **Rows 6, 13, 35 (Comparison Tables)**: Sticky headers with scroll shadow, feature tooltips, mobile horizontal scroll
- **Rows 9, 39 (Video Heroes)**: Lazy video with IntersectionObserver, prefers-reduced-motion fallback, poster optimization

### Research Sources
- Perplexity 2026 research: ARIA tabs (WAI-ARIA), Embla/Swiper carousels, Framer Motion pricing, Tremor dashboards, Stripe/Apple mega menus

### Summary
- Comprehensive audit of all 49 landing patterns
- 3 new critical patterns added (Tab, Dashboard, Mega Menu)
- 10 existing patterns enhanced with 2026 techniques
- Coverage: ARIA, prefers-reduced-motion, IntersectionObserver, CSS scroll-snap, RTL, keyboard navigation

## [1.1.4] - 2026-01-18

### Enhanced
- **landing.csv Row 41 (Scroll-Reactive Header)**:
  - Added explicit height transition (80px → 56px)
  - Added CSS scroll-driven animation with `animation-timeline: scroll()`
  - Added `@supports` feature detection with JS fallback

### Added
- **landing.csv Row 46**: Auto-Hiding Header pattern
  - Hide on scroll down, show on scroll up (Linear/Vercel style)
  - Direction-aware scroll tracking with `prevScrollY`
  - `requestAnimationFrame` for performance
  - 80px threshold before hiding
  
- **ux-guidelines.csv Row 129**: Header Height Transition guidelines
  - Best practice: 80px → 56px with 0.3s ease-out

- **ux-guidelines.csv Row 130**: Auto-Hide Navigation Direction
  - Direction tracking with threshold guidelines

### Updated
- **styles.csv Row 76**: Navbar Glassmorphism States
  - Added CSS `animation-timeline: scroll()` code (90%+ browser support 2026)
  - Updated era tag to "2026 Modern"

### Summary
- Deep research from Perplexity confirms 2026 best practices
- CSS scroll-driven animations now primary with JS fallback
- Auto-hiding header pattern addresses major gap

## [1.1.3] - 2026-01-18

### Fixed
- Fixed CSV parsing errors in landing.csv (rows 41, 42, 45) caused by unquoted rgba() values and comma-separated lists

## [1.1.2] - 2026-01-18

### Added
- **landing.csv**:
  - Scroll-Reactive Header (navbar scroll effect with glassmorphism)
  - Mobile Navigation Overlay (hamburger menu with slide animation)
  - Modern Footer Layout (multi-column grid, social icons, newsletter)
  - Section Dividers (wave SVG, diagonal clip-path, gradient fade)
  - Content Slider Carousel (track, dots, arrows, autoplay JS)
- **styles.csv**:
  - Navbar Glassmorphism States (component with default/scrolled/mobile states)
  - Theme Toggle (sun/moon rotation animation)
- **ux-guidelines.csv**:
  - Navbar Scroll Threshold (50-100px guidance)
  - Navbar Transition Timing (0.3-0.4s cubic-bezier)
  - Mobile Menu Animation Patterns
  - Blur-Up Image Loading effect
  - Skeleton Shimmer animation pattern
- **prompts.csv**:
  - Interactive Particle Background pattern

### Enhanced
- **styles.csv**: Glassmorphism entry updated with navbar-specific states

### Summary
- All content gaps from CryptoVault landing page test addressed
- HIGH priority: Navbar scroll, Footer patterns, Mobile menu ✅
- MEDIUM priority: Theme toggle, Slider, Image lazy, Section dividers ✅
- LOW priority: Particles, Glassmorphism states ✅

## [1.1.1] - 2026-01-18

### Fixed
- Fixed CSV parsing issues in colors.csv (escaped quotes in hex color values)
- Fixed CSV parsing issues in react.csv (escaped quotes in code examples)

## [1.1.0] - 2026-01-18

### Added

**New Features:**
- Added 3 new icon libraries: Heroicons, Phosphor Icons, Tabler Icons (+40 icons)
- Added React animation guidelines: Framer Motion (8 entries), React Spring (5 entries)
- Added AI-Native UI styles: Agentic Interface, Streaming UI, Spatial UI 3D, Voice UI
- Added CSS Scroll-Driven Animations guidelines
- Added View Transitions API guidelines for ux-guidelines.csv and nextjs.csv

**2026 Framework Updates:**
- React 19.2: Added React Compiler v1.0, Activity component, useEffectEvent hook
- Next.js 16: Added Turbopack stable, 'use cache' directive, React Compiler integration
- Tailwind v4: Added 10 new entries for CSS-first config, container queries, oklch colors

**New Color Palettes:**
- AI Code Assistant, AI Image Generator, AI Chatbot LLM
- AI Voice Platform, AI Analytics Dashboard, AI Automation Agent
- AI Video Generator, Spatial Computing/VisionOS

**New Product Types:**
- Kids/Baby/Parenting App
- Manufacturing/Industrial Platform
- Crowdfunding/Fundraising Platform

### Fixed
- Updated 19 Tailwind v4-beta URLs to stable docs
- Updated React 19 docs URLs from blog to reference docs
- Fixed Next.js version references (14+ → 15+)

### Changed
- +99 new entries across all data files
- +20 URL/reference fixes
- Total entries now: 1410+

## [1.0.1] - 2026-01-18

### Changed
- Added npm version and downloads badges to README
- Improved installation documentation with NPX, global install, and source options
- Enhanced MCP configuration examples for VS Code, Cursor, and Claude Desktop

## [1.0.0] - 2026-01-17

### Added
- Initial release with **1340+ curated design resources**
- **11 specialized search tools** for UI/UX design
- **UI Styles** (70 entries): Glassmorphism, Neumorphism, Brutalism, Bento Grid, Agentic Interface, Spatial UI, etc.
- **Color Palettes** (112 entries): Industry-specific palettes for SaaS, Fintech, Healthcare, AI/ML, Climate Tech
- **Typography** (72 entries): Modern font pairings including Geist, Satoshi, variable fonts
- **Charts** (35 types): Candlestick, Confusion Matrix, KPI Sparkline, Waterfall, etc.
- **UX Guidelines** (115 entries): Dashboard UX, AI Interface Design, WCAG 2.2, Voice UI
- **Icons** (131 entries): Lucide icons for Fintech, AI, Healthcare, E-commerce, Developer
- **Landing Pages** (40 patterns): AI Hero, Bento Grid, Pricing Calculator, Exit Intent
- **Products** (114 types): AI Assistant, Crypto/DeFi, HealthTech, Creator Economy
- **AI Prompts** (30 templates): Midjourney v7, DALL-E 3, Stable Diffusion, LLM code gen
- **Framework Guidelines** (660+ entries): React 19, Next.js 15, Vue 3.5, Svelte 5, TailwindCSS v4
- BM25 search algorithm with confidence-based domain detection
- stdio transport for VS Code/Claude Desktop integration
- HTTP/SSE transport for development and testing
- CSV-based extensible data system