neon_sakura 0.1.4

data/CHANGELOG.md

@@ -0,0 +1,568 @@
+# Changelog
+
+All notable changes to this project 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).
+
+## [Unreleased]
+
+## [0.1.4] - 2025-01-XX
+
+### Added
+- **Gravatar Support** - New `ProfileHelper` with `gravatar_url` method
+  - Generates Gravatar URLs from email addresses
+  - Configurable image size (default: 80px)
+  - Uses MD5 hashing for Gravatar GUID (acceptable for public identifiers)
+  - Returns identicon as default for unregistered emails
+
+- **File Upload Component** - Drag-and-drop file upload with preview
+  - Configurable file types (`accept` parameter)
+  - Maximum file size validation
+  - Optional image preview
+  - Multiple file support
+  - Drag-and-drop highlighting
+  - Stimulus controller integration
+  - Theme-aware styling with CSS variables
+
+- **Profile Image Selector Component** - Radio card selection UI
+  - Choose between default avatar, Gravatar, or uploaded image
+  - Preview images for each option
+  - Selection indicator
+  - Fully accessible with hidden radio buttons
+  - ActiveStorage integration for uploads (optional)
+  - Responsive grid layout
+
+- **9 New Heroicons** - High-priority icons for prys-m migration
+  - `bars` - Hamburger menu (bars-3)
+  - `chart_line` - Line chart visualization
+  - `chart_pie` - Pie chart visualization
+  - `user_circle` - User profile circle
+  - `user_plus` - Add user/invitation
+  - `info_circle` - Information/help
+  - `lightbulb` - Ideas/tips/features
+  - `paper_plane` - Send/submit
+  - `history` - Recent/past items
+
+- **Icon Audit Documentation** - Complete missing icons analysis
+  - Created `docs/MISSING_ICONS.md`
+  - Tracks 20-25 missing icons from prys-m
+  - Prioritized by usage frequency
+  - Heroicons source mapping
+  - Implementation plan for remaining icons
+
+### Added (Previous)
+- **Style Guide Favicon** - Added palette icon as favicon for style guide
+  - Uses inline SVG data URI with purple color (#a855f7)
+  - Appears in browser tab for easy identification
+  - Matches the style guide's theme-focused purpose
+
+- **Enhanced Pagy Examples** - Comprehensive pagination control examples in style guide
+  - **4 Live Examples**: info_tag, series_nav_js, series_nav, input_nav_js
+  - **Pagy 43.x API**: Updated to use instance methods (`@pagy.info_tag` instead of `pagy_info(@pagy)`)
+  - **Interactive**: All navigation controls are functional and demonstrate different pagination styles
+  - **Code Examples**: Each example shows the exact ERB code needed for Pagy 43.x
+  - **Controller Setup**: Includes Pagy 43.x controller configuration with `:offset` paginator
+  - **Helper Reference**: Complete documentation of available Pagy 43.x instance methods
+
+### Fixed
+- **CRITICAL: Propshaft @import Bug Fixed** - Resolved asset loading issues in consuming applications
+  - **Issue**: CSS `@import` statements do NOT work with Propshaft across gem boundaries
+  - **Root Cause**: Previous documentation incorrectly claimed Propshaft expands `@import` into `<link>` tags (this is Sprockets behavior, not Propshaft)
+  - **Impact**: Apps using neon_sakura with Propshaft would fail to load any styles
+  - **Solution**: Created `neon_sakura_stylesheets` helper that loads all CSS files individually in correct cascade order
+
+- **Style Guide Pagy Pagination** - Fixed Pagy 43.x API compatibility
+  - **Issue**: "wrong number of arguments (given 1, expected 0)" error when viewing pagination section
+  - **Root Cause**: Pagy 43.x has completely different API - uses `Pagy::Method` instead of `Pagy::Backend`
+  - **Impact**: Style guide pagination examples failed to initialize in apps using Pagy 43.x
+  - **Solution**:
+    - Added support for Pagy 43.x API: `include Pagy::Method` and `pagy(:offset, collection, **options)`
+    - Maintained backward compatibility with older Pagy versions using `Pagy::Backend` and `pagy_array`
+    - Controller now detects Pagy version and uses appropriate API automatically
+    - Changed parameter from `items:` to `limit:` (modern Pagy convention)
+
+- **Style Guide Icon Modal Display** - Fixed icons not appearing in modal zoom viewer
+  - **Issue**: Icons appeared blank/invisible in modal even though modal opened correctly
+  - **Root Cause 1**: Prysm icon had hardcoded `class="w-6 h-6"` instead of using `css_class` parameter
+  - **Root Cause 2**: JavaScript used fragile selector `[class*="w-8"]` which failed for icons without that class
+  - **Root Cause 3**: ERB template engine tried to evaluate `<%= %>` inside JavaScript string literal
+  - **Root Cause 4**: Tailwind classes (`w-64 h-64`) not reliably sizing SVG elements in modal context
+  - **Impact**: Modal opened but showed blank/broken content, MissingTemplate errors
+  - **Solution**:
+    - Updated prysm icon to use proper `css_class` parameter like all other icons
+    - Rewrote JavaScript to use robust SVG cloning with `querySelector('svg')`
+    - Set explicit width/height styles (256px) instead of Tailwind classes for reliable sizing
+    - Properly handle SVG className using `baseVal` property
+    - Preserve color classes while removing size classes
+    - Escaped ERB delimiters in JavaScript using string concatenation
+
+- **Style Guide Modal Display** - Fixed icon and image zoom modal not appearing as overlay
+  - **Issue**: Modal was appearing at bottom of page instead of as centered overlay
+  - **Root Cause**: Conflicting CSS classes (both `hidden` and `flex`) and inline styles
+  - **Solution**: Restructured modal with proper CSS classes and backdrop
+    - New modal structure: `.modal-overlay` → `.modal-backdrop` + `.modal-container`
+    - Proper fixed positioning with z-index layering
+    - Modal backdrop prevents page scrolling when open
+    - Smooth fade-in/out transitions
+    - Close via button, backdrop click, or ESC key
+
+### Added
+- **Style Guide Modal Zoom** - Interactive zoom functionality for icon and image modals
+  - **Zoom Controls**: Visible control panel with zoom in, zoom out, and reset buttons
+  - **Zoom Range**: 50% to 500% in 25% increments
+  - **Mouse Wheel Support**: Scroll to zoom in/out directly on modal content
+  - **Pan/Drag**: Click and drag to pan when zoomed in (cursor changes to grab/grabbing)
+  - **Keyboard Shortcuts**:
+    - `+` or `=` - Zoom in
+    - `-` or `_` - Zoom out
+    - `0` - Reset to 100%
+    - `Esc` - Close modal
+  - **Smart Features**:
+    - Auto-reset zoom when opening/closing modals
+    - Buttons disable at min/max zoom levels
+    - Smooth transitions for zoom and pan
+    - Zoom level percentage display
+  - **New Icons**: Added `minus` and `arrows_pointing_in` icons for zoom controls
+  - **CSS Classes**: `.zoom-controls`, `.zoom-control-button`, `.zoomable-wrapper`, `.zoomable-content`
+
+- **Secondary Blue Gradient** - New theme-independent cyan-to-blue gradient for all themes
+  - CSS variables: `--gradient-secondary-blue-from` (#0891b2) and `--gradient-secondary-blue-to` (#2563eb)
+  - Utility class: `.bg-gradient-secondary-blue` for background gradients
+  - Available in all themes (purple, green, red × light, dark)
+  - Added to style guide with live preview and code examples
+  - Usage: `<button class="bg-gradient-secondary-blue">Secondary Blue</button>`
+
+- **Navbar Link Color System** - Unified cyan navbar styling across all themes
+  - CSS variables: `--navbar-link-color` and `--navbar-link-hover` in all themes
+  - Dark modes: Bright cyan (#06b6d4) with lighter hover (#22d3ee)
+  - Light modes: Darker cyan (#0891b2) with darker hover (#0e7490) for contrast
+  - Utility classes: `.text-navbar-link` and `.hover:text-navbar-link`
+  - All navbar links (regular, dropdown, logout) use consistent cyan colors
+  - Active links show cyan color with cyan underline
+  - Replaces theme-specific accent colors with unified cyan across purple, green, and red themes
+
+- **StylesheetHelper Module** - New helper for Propshaft-compatible CSS loading
+  - `neon_sakura_stylesheets` helper loads all 18 CSS files in correct order (added loading.css)
+  - Proper cascade: themes → utilities → loading → components → forms → pagination
+  - Replaces broken `@import` approach with individual `stylesheet_link_tag` calls
+  - Available automatically in all views via ActionView integration
+
+- **Ouroboros Logo Icon** - New SVG icon depicting a serpent eating its own tail
+  - Available via `render_theme_icon("ouroboros", css_class: "w-6 h-6")`
+  - Theme-aware coloring with currentColor
+  - Includes decorative scales and detailed head/tail design
+
+- **Loading Indicators** - Comprehensive loading states and animations (`loading.css`)
+  - **Spinners**: Basic, accent, small (16px), and large (48px) variants
+    - `.spinner-basic` - Border color spinner
+    - `.spinner-accent` - Accent color spinner
+    - `.spinner-small` - Compact 16px spinner
+    - `.spinner-large` - Large 48px spinner
+  - **Progress Bars**: Determinate and indeterminate progress indicators
+    - `.progress-bar-container` - Progress bar wrapper
+    - `.progress-bar-fill` - Fill with gradient (set width via style)
+    - `.progress-bar-indeterminate` - Animated sliding progress bar
+  - **Skeleton Loaders**: Placeholder content while loading
+    - `.skeleton-text` - Text line placeholder with shimmer animation
+    - `.skeleton-avatar` - Circular avatar placeholder
+  - **Loading Overlay**: Full-screen loading state (`.loading-overlay`)
+  - All loading indicators are theme-aware using CSS custom properties
+
+- **Gradient System Enhancements**
+  - **Alternative Purple Gradient** - Secondary three-color purple gradient
+    - CSS Variables: `--gradient-secondary-start`, `--gradient-secondary-mid`, `--gradient-secondary-end`
+    - Colors: Purple (#b038dc) → Blue (#4c3ba5) → Indigo (#393e9c)
+    - Utility class: `.bg-gradient-secondary-purple`
+    - Available only in purple themes (light and dark)
+  - **Navbar Gradient** - Accent to notification gradient (third gradient option)
+    - CSS Variables: `--gradient-navbar-from`, `--gradient-navbar-to`
+    - Maps to accent color → notification color for each theme
+    - Utility class: `.bg-gradient-navbar`
+    - Available in all themes:
+      - Purple: Purple → Green
+      - Red: Red → Green
+      - Green: Green → Green
+  - **Gradients Section** in Style Guide - Showcases all gradient options with examples
+    - Primary gradient (theme-specific button gradients)
+    - Navbar gradient (accent to notification)
+    - Secondary gradient (purple themes only)
+    - Complete CSS variables documentation
+    - Visual comparisons and code examples
+
+- **Style Guide Feature** - Development/test-only comprehensive UI documentation at `/style-guide`
+  - Automatically injected route and navbar link (visible only in dev/test environments)
+  - Configurable via `enable_style_guide` (default: true) and `style_guide_navbar_position` (default: :end)
+  - Dynamic sections showcasing all components with live previews and code examples:
+    - **Icons**: All 94 SVG icons (including ouroboros) with clickable zoom modal and helper usage examples
+    - **Images**: All gem images with clickable zoom modal, display and usage instructions
+    - **Theme Switcher**: Live theme preview for all 6 themes (green/purple/red × light/dark)
+    - **Typography**: Heading styles, text colors, gradients
+    - **Colors**: CSS custom property reference with theme-aware color swatches
+    - **Gradients**: Primary, navbar, and secondary (purple only) gradient examples with visual comparisons
+    - **Buttons**: Submit buttons, primary buttons, icon buttons, link buttons
+    - **Forms**: Text inputs, textareas, selects, checkboxes, radio buttons
+    - **Cards**: Basic cards, cards with headers, card grids
+    - **Badges**: Status badges, outline badges, counter badges, tag badges
+    - **Alerts**: Success, error, warning, and info alerts
+    - **Loading Indicators**: Spinners, progress bars, skeleton loaders with working animations
+    - **Pagination**: Pagy integration examples (configurable via `style_guide_pagy_examples`, graceful error handling)
+  - Environment-restricted: Returns 404 in production (route not defined)
+  - Comprehensive test coverage with 30+ new tests
+  - Helper method: `example_with_code(title, code, &block)` for rendering component examples
+  - Navbar auto-injection via engine initializer (configurable position: :start, :end, :before_logout, or integer)
+  - **Pagy Configuration**: New `style_guide_pagy_examples` option (default: true)
+    - When enabled: Automatically detects Pagy availability and shows working examples
+    - When disabled: Hides pagination section entirely
+    - Graceful error handling: Shows helpful error message if Pagy installation fails
+    - Error messages include configuration instructions to disable examples if Pagy not needed
+
+### Changed
+- **Documentation Corrections** - Fixed incorrect Propshaft information in CLAUDE.md and README.md
+  - Removed misleading "each @import becomes a separate <link> tag" claims (lines 34, 293, 427)
+  - Added correct usage instructions with `neon_sakura_stylesheets` helper
+  - Updated "Usage" section with proper Propshaft-compatible code examples
+  - Added warning against using `@import "neon_sakura.css"` in application.css (doesn't work with Propshaft)
+
+### Migration Guide (CRITICAL for all Propshaft users)
+Apps experiencing missing styles must update their layouts:
+
+**Before (BROKEN with Propshaft):**
+```erb
+<%= stylesheet_link_tag "neon_sakura", "data-turbo-track": "reload" %>
+```
+OR
+```css
+/* application.css */
+@import "neon_sakura.css";
+```
+
+**After (CORRECT for Propshaft):**
+```erb
+<%# Load neon_sakura stylesheets (Propshaft-compatible) %>
+<%= neon_sakura_stylesheets %>
+
+<%# Load your app-specific styles %>
+<%= stylesheet_link_tag 'application', 'data-turbo-track': 'reload' %>
+```
+
+## [0.1.2] - 2025-12-21
+
+### Changed
+- **CSS Architecture Refactored**: Split monolithic `base.css` into 18 modular files with flat structure
+  - Created 4 theme files (`theme-default.css`, `theme-purple.css`, `theme-green.css`, `theme-red.css`)
+  - Created 10 utility files (`utility-reset.css`, `utility-layout.css`, `utility-sizing.css`, `utility-spacing.css`, `utility-colors.css`, `utility-borders.css`, `utility-typography.css`, `utility-gradients.css`, `utility-effects.css`, `utility-responsive.css`)
+  - Each theme file contains both light and dark variants for easier maintenance
+  - **Flat file structure** in root `app/assets/stylesheets/` (no subdirectories) for Propshaft compatibility
+  - Improved discoverability and maintainability with descriptive file naming
+- **Color Consistency**: Replaced all remaining hardcoded colors with CSS variables
+  - Gradient utilities now use theme-aware variables instead of hardcoded hex colors
+  - Button text colors now use `var(--color-text-primary)` in all files
+  - Focus ring colors updated to use CSS variables
+- **Documentation**: Updated CLAUDE.md and README.md with new CSS file structure and contribution guidelines
+- **CSS Linting**: Added Stylelint with industry-standard configuration
+  - Created package.json with Stylelint dependencies
+  - Added .stylelintrc.json configuration file
+  - Added .stylelintignore for vendor files
+  - Integrated Stylelint into pre-commit git hook
+  - Created GitHub Actions workflow for automated linting (RuboCop, Stylelint, Brakeman, Bundle Audit)
+  - Fixed duplicate `.pagy-nav` selector in components.css
+- **Asset Pipeline Fix**: Restructured to flat file architecture for Propshaft compatibility
+  - **Critical fix**: Moved all CSS files to root `app/assets/stylesheets/` directory (removed subdirectories)
+  - Propshaft serves all assets from flat `/assets/` URL path; subdirectory `@import` statements caused 404 errors
+  - `base.css` imports all theme and utility files (backward compatibility for apps loading base.css directly)
+  - `neon_sakura.css` imports all theme and utility files plus components (complete manifest)
+  - Each `@import` becomes a separate `<link>` tag served by Propshaft
+  - **Breaking for subdirectory references**: Any custom CSS importing via subdirectory paths must update to flat file names
+  - Fixed 404 errors: `/assets/themes/purple.css` → `/assets/theme-purple.css`
+
+### Fixed
+- Gradient utilities now properly adapt to current theme (green themes show green gradients, purple themes show purple gradients)
+- All components now fully support theme switching without hardcoded color values
+
+### Migration Guide
+1. Update Gemfile: `gem 'neon_sakura', '~> 0.1.2'`
+2. Run `bundle update neon_sakura`
+3. **No application changes required** - the refactoring is fully backward compatible
+4. The new modular structure only affects gem development, not consuming applications
+
+### Backward Compatibility
+- **100% backward compatible** - all existing applications continue to work without changes
+- `base.css` is now a manifest file that imports all theme and utility modules
+- No changes to utility class names or component styles
+- CSS cascade order preserved
+
+## [0.1.1] - 2025-12-20
+
+### Added
+- **406 Not Acceptable error page** - Added custom error page with helpful message for browser compatibility issues
+- **Multi-theme support**: 6 built-in themes (Green Light/Dark, Purple Light/Dark, Red Light/Dark)
+- **Theme switcher component** (`shared/theme_switcher`) with 3 modes:
+  - Disabled mode (1 theme): Shows current theme, button disabled
+  - Toggle mode (2 themes): Simple moon/sun toggle button
+  - Dropdown mode (3+ themes): Dropdown menu with checkmarks on current theme
+- **Theme configuration API**: Configure `default_theme`, `available_themes`, `enable_theme_persistence`, `theme_api_endpoint`
+- **Theme persistence**: localStorage-based with optional backend API support
+- **Theme Helper module** (`NeonSakura::ThemeHelper`) for server-side theme detection
+- **Theme Importer** (`NeonSakura::ThemeImporter`) for importing Bootstrap, Material UI, and custom themes
+- **Theme mapping system**: YAML configuration (`config/theme_mappings.yml`) for framework theme conversion
+- **Reusable dropdown.js module**: Extracted from navbar for use across components
+- **New icons**: `sun`, `moon`, `palette`, `prysm` (prys-m logo with two triangles design)
+- **Icon Helper module** (`NeonSakura::IconHelper`) with methods for icon management:
+  - `render_icon(name, options = {})` - Renders an icon partial with CSS class, aria-hidden, and aria-label options
+  - `available_icons` - Returns array of all available icon names
+  - `icon_exists?(name)` - Checks if an icon exists
+  - `render_icon_list(icon_names, options = {})` - Renders multiple icons in a container with custom styling
+- **Theme Helper icon rendering** (`render_theme_icon`) - Theme-aware icon rendering method in ThemeHelper
+- **Bootstrap compatibility CSS** (`compat/bootstrap.css`): Optional class aliases for gradual migration
+- **Theme switching JavaScript** (`theme_switcher.js`): Handles theme switching, localStorage, cookies, and optional backend sync
+
+### Changed
+- **CSS refactored to use custom properties**: All hardcoded colors replaced with `var(--color-*)` references
+  - base.css: All utility classes now use CSS variables for colors
+  - components.css: All component styles now use CSS variables for colors
+  - forms.css: All form styles now use CSS variables for colors and gradients
+- Base.css now uses CSS custom properties with 4 theme variants via `data-theme-name` and `data-theme-mode` attributes
+- Dropdown JavaScript extracted to separate tested module for reusability
+- **Default configuration**: All 4 themes available by default in new installations
+- Color system now uses semantic variables: `--color-text-primary`, `--color-background`, `--color-accent`, etc.
+- Intermediate color shades now use `color-mix()` function for smooth transitions
+- **Gradient system**: Added `--gradient-from`, `--gradient-to`, `--gradient-from-hover`, `--gradient-to-hover` variables for theme-configurable button gradients
+  - Green themes: Green to cyan gradients (#10b981 → #06b6d4)
+  - Purple themes: Blue to purple gradients (#2563eb → #9333ea)
+  - Red themes: Red to orange gradients (#dc2626 → #f97316)
+- **Text gradient system**: Added `--text-gradient-from`, `--text-gradient-to` variables for theme-configurable heading and link gradients
+  - Each theme has color-appropriate text gradients for headings
+- **Warning color**: Added `--color-warning` variable for consistent warning colors across themes
+- Mission Control navbar now synchronized with main navbar styling and includes theme selector
+- **Red themes**: Added 2 new themes (Red Light and Red Dark) with red-to-orange color scheme
+
+### Fixed
+- Search button text visibility in light theme (now uses white text)
+- Advanced search toggle button now uses theme-configurable gradients instead of hardcoded cyan/blue
+- Input submit buttons now use theme-configurable gradients instead of hardcoded purple
+- Heading and link gradients now match theme colors (green for green themes, purple/blue for purple themes)
+- Green themes now use green gradients throughout instead of purple/blue
+- Navbar link colors now properly show white by default with cyan hover state
+- Theme selector dropdown now appears in Mission Control navbar Tools menu
+- Dropdown event listeners no longer duplicate on re-initialization
+- **Navbar dropdown menus now work correctly after Turbo page navigation** - removed blocking initialization guard that prevented dropdowns from re-initializing on subsequent page loads
+- **Pagy pagination now uses pagy_input_nav_js for responsive design** - Fastest! Combines navigation and info in minimum space using Pagy's built-in JavaScript navigation with input field for direct page jumping.
+- **Download button text color** - Changed from mixed accent color to solid white (#ffffff) for better contrast and readability on gradient backgrounds
+
+### Migration Guide
+1. Update Gemfile: `gem 'neon_sakura', '~> 0.1.1'`
+2. Run `bundle update neon_sakura`
+3. **IMPORTANT**: Mount the engine in `config/routes.rb`:
+   ```ruby
+   Rails.application.routes.draw do
+     mount NeonSakura::Engine => "/", as: "neon_sakura"
+     # ... rest of your routes
+   end
+   ```
+4. **For responsive pagination** (recommended):
+   - Enable pagy extra in `config/initializers/pagy.rb`:
+     ```ruby
+     require 'pagy/extras/input_nav_js'
+     ```
+   - Add pagy to `config/importmap.rb`:
+     ```ruby
+     pin "pagy", to: "https://cdn.jsdelivr.net/npm/pagy@9.3.3/javascripts/pagy.min.js"
+     ```
+   - Import in `app/javascript/application.js`:
+     ```javascript
+     import "pagy"
+     ```
+   - Replace `pagy_nav` or `pagy_nav_search` with `pagy_input_nav_js` in views
+3. **Optional - Enable theme switching**:
+   - Add to `config/initializers/neon_sakura.rb`:
+     ```ruby
+     config.available_themes = [
+       { name: "green", mode: "light", label: "Green Light" },
+       { name: "green", mode: "dark", label: "Green Dark" },
+       { name: "purple", mode: "light", label: "Purple Light" },
+       { name: "purple", mode: "dark", label: "Purple Dark" }
+     ]
+     config.default_theme = { name: "purple", mode: "dark" }  # Optional, defaults to purple-dark
+     ```
+   - Add theme switcher to navbar: `<%= render "shared/theme_switcher" %>`
+4. **Optional - Database persistence**:
+   - Add migration: `rails g migration AddThemeToUsers theme_name:string theme_mode:string`
+   - Configure endpoint: `config.theme_api_endpoint = "/settings/theme"`
+5. **Optional - Import external themes**:
+   - Use `NeonSakura::ThemeImporter.from_bootstrap(vars)` or `.from_material_ui(vars)`
+   - Use Bootstrap compatibility CSS: `@import "neon_sakura/compat/bootstrap.css"` (optional)
+
+### Backward Compatibility
+- Existing apps continue to work without changes (defaults to "purple-dark" theme)
+- All utility classes maintain their original names
+- CSS variables have sensible fallbacks
+- No breaking changes to existing APIs
+
+## [0.1.0] - 2025-12-20
+
+### Added
+- Extracted Artemis navigation bar component as reusable `shared/navbar` partial
+- Configurable navigation positioning via `nav_position` (:none, :top, :under_heading)
+- Support for three link types: simple links, dropdown menus, and form buttons
+- Block/yield support for custom content in navbar (e.g., prys-m's Quick Import form)
+- NavbarHelper module with utility methods for active state detection and condition evaluation
+- Icon support for all navigation links via `icon` parameter
+- Conditional link rendering via `condition` parameter for dynamic navigation
+- Navbar JavaScript module (navbar.js) for dropdown functionality using vanilla JS
+- Configuration options: `nav_position`, `app_icon`, `show_search`
+- Active state highlighting for current page navigation links with `nav-active` class
+- Responsive navigation design with mobile support
+
+### Changed
+- **BREAKING**: Removed `mission_control_nav_links` configuration option
+  - Migration: Use `nav_links` instead for unified navigation across all layouts
+- Enhanced `nav_links` schema to support:
+  - `type` field for link, dropdown, or button types
+  - `icon` field for icon partial names
+  - `condition` field for conditional rendering with Ruby code evaluation
+  - `active_paths` array for additional path matching
+  - `method` field for button HTTP methods (:get, :post, :patch, :delete)
+  - `target` field for link targets (e.g., "_blank")
+  - `aria_label` field for custom accessibility labels
+- Dropdown functionality now uses gem's navbar.js instead of requiring Stimulus
+- Navigation styling consolidated in components.css (already present)
+
+### Fixed
+- Navigation dropdown z-index for proper layering above other content
+- Active state detection now supports multiple paths via `active_paths` array
+- Logout button styling properly supports Rails form button helpers
+
+### Removed
+- `mission_control_nav_links` configuration option (use `nav_links` instead)
+
+### Migration Guide
+1. Update Gemfile: `gem 'neon_sakura', '~> 0.1.0'`
+2. Run `bundle update neon_sakura`
+3. Replace `render "shared/nav"` with `render "shared/navbar"` in views
+4. Update configuration in `config/initializers/neon_sakura.rb`:
+   - Rename `mission_control_nav_links` to `nav_links`
+   - Add `nav_position` (options: `:none`, `:top`, `:under_heading`)
+   - Enhance nav_links with new schema (type, icon, condition, etc.)
+5. Remove application-specific navbar partials (now provided by gem)
+6. Remove Stimulus dropdown controller if only used for navbar (now handled by gem)
+
+## [0.0.9] - 2025-12-18
+
+### Added
+- Configurable Mission Control navigation via `mission_control_nav_links` configuration option
+- Support for flat links, dropdown menus, and form buttons in Mission Control navigation
+- Navigation link types: "link", "dropdown", and "button"
+- Automatic "Back to {app_name}" link and "Start Auto-refresh" button displayed inline below custom navigation
+- Comprehensive Mission Control navigation documentation in README.md
+- Remove duplicated back button
+
+### Changed
+- Mission Control layout now uses configured navigation instead of hardcoded Artemis navigation
+- When `mission_control_nav_links` is nil or empty, the custom navigation is hidden (falls back to default Mission Control navigation)
+- `app_name` configuration now used for "Back to {app_name}" link
+- "Start Auto-refresh" button now appears inline with "Back to" link, not in the navigation bar
+- Icon names in documentation updated to use underscores (e.g., `arrow_left` instead of `arrow-left`) to match actual file names
+
+### Fixed
+- Mission Control auto-refresh button positioning - now inline with "Back to" link instead of in navigation bar
+- Hardcoded navigation that prevented customization for different applications
+- Icon naming inconsistencies in documentation (hyphens vs underscores)
+
+## [0.0.8] - 2025-12-17
+
+### Changed
+- **BREAKING**: Converted all icons to inline `.svg.erb` partials with `currentColor` support
+- Icons now properly work with Tailwind `text-*` color classes
+- Simplified usage: `<%= render 'shared/icons/clock', css_class: 'w-6 h-6 text-green-400' %>`
+- Removed all external SVG files (now inline partials only)
+- Updated spinner to use CSS animation
+
+### Fixed
+- Multi-colored icons now work correctly in consuming applications
+- Icons properly inherit colors from CSS classes
+
+## [0.0.5 - 0.0.7] - 2025-12-17
+- Extracted all embedded SVG icons to external files
+- Icon SVGs use explicit cyan color (#7DD3FC) for Propshaft compatibility
+- Converted spinner from SVG to animated GIF
+- Updated 87 icon view partials to use image_tag
+- Moved icons to root app/assets/images/ directory
+- Resolve issues loading assets
+
+### Changed
+- **BREAKING**: Extracted all embedded SVG icons to external files in `app/assets/images/`
+- All icon SVGs now use explicit cyan color (#7DD3FC) instead of `currentColor` for compatibility with Propshaft
+- Converted spinner from SVG to animated GIF for better visual feedback
+- Updated all 87 icon view partials to use `image_tag` instead of embedded SVG code
+- Moved all icon files from `app/assets/images/icons/` to root `app/assets/images/` for Propshaft compatibility
+
+### Fixed
+- Fixed `chevron_down.svg` broken SVG (removed embedded ERB code)
+- Fixed `server_error.svg` X visibility by changing color to red (#EF4444)
+- Added explicit Propshaft asset paths configuration in engine initializer
+- All icon SVGs now have proper `width="24" height="24"` attributes for correct rendering
+
+### Updated
+- Updated artemis application spinner usage to remove `animate-spin` class (no longer needed with GIF)
+
+## [0.0.4] - 2025-12-16
+
+### Added
+- Progress bar component (`.progress-bar-container` and `.progress-bar`)
+- Support for dynamic progress width via CSS custom property `--progress-width`
+- Gradient styling for progress bars (cyan-500 to blue-500)
+- SVGs from Dragonfly archived project
+- Cherry blossom tree icon in both PNG and SVG formats (`cherry_blossom_tree.png` and `cherry_blossom_tree.svg`) with corresponding view partial
+- Add in Prys-m images
+- Update mission control ui to have auto-refresh
+- Minor workflow fix
+
+## [0.0.3] - 2025-12-10
+
+### Added
+- ErrorsController for handling common HTTP error codes (400, 401, 403, 404, 422, 500, 503)
+- ErrorsHelper with route helper support for error pages
+- Error view template with dark-themed styling and icon support
+- Automatic error page routes via Rails engine (can be disabled via configuration)
+- Configuration option `enable_error_pages` to control automatic error routes (default: true)
+- Comprehensive error controller and helper tests
+- Configuration tests for new `enable_error_pages` option
+- Support for both HTML and JSON error responses
+- Custom error messages and details via request parameters
+- Comprehensive configuration documentation in README.md
+- Documentation for automatic error routes and configuration in README.md
+
+## [0.0.2] - 2025-12-10
+### Bugfixes
+- Resolved name-spacing issues
+
+## [0.0.1] - 2025-12-09
+
+### Added
+- Initial release of neon_sakura gem
+- Extracted styling and theming components from Artemis Rails application
+- Base CSS styles with utility classes, layout, typography, and colors
+- Component CSS for UI elements (navigation, cards, badges, buttons, tables, alerts)
+- Form styling CSS
+- Pagination styles (pagy-tailwind.css)
+- Mission Control layout template
+- Error page layout template
+- SVG icon components (29 files)
+- Site footer component
+- Vanilla JavaScript dropdown functionality
+- Proper gem structure with lib/, app/, and asset directories
+
+### Changed
+- Updated gemspec with proper metadata and author details
+- Configured gem for Rails 8+ compatibility
+- Set up proper asset pipeline integration
+- Updated AI reviewer configuration to use Neon Sakura gem project context
+- Updated AI reviewer build system prompt for Neon Sakura gem project
+- Updated CLAUDE.md to include detailed project guidelines for AI reviewer
+
+### Fixed
+- Ensured all CSS imports work correctly in gem context
+- Verified JavaScript components work with Propshaft asset pipeline
+
+[0.0.1]: https://github.com/trex22/neon_sakura/releases/tag/v0.0.1