Changelog

• Add scheduled-refresh.php to check cache.db every 30 minutes for stale entries
• Create Windows Task Scheduler setup scripts (PowerShell and batch)
• Add test-scheduled-refresh.php for system verification
• Update README.md with comprehensive documentation:
• Add table of contents for better navigation
• Document scheduled refresh system setup
• Fix font references (Poppins, not Inter)
• Remove fictional API documentation (keys, rate limits, WebSocket, SDKs)
• Update project structure to match actual codebase
• Correct all configuration paths and examples
• Add troubleshooting sections for all major features
• System automatically triggers background refresh for stale orgs/users
• Prioritizes larger caches and handles lock files properly
• Logs all operations to logs/scheduled_refresh.log

• Add summary header showing total commits, days, and commits per hour
• Implement monthly activity barchart visualization
• Add interactive hover effects on bars
• Highlight current month and year with distinct colors
• Calculate statistics dynamically from git history
• Use solid colors for clean appearance
• Fully responsive design for all screen sizes

• Add detailed repository statistics section with primary stats cards
• Display total commits, categorized commits with percentages
• Show commit types breakdown with individual percentages
• Add top contributors section with visual progress bars
• Display generation timestamp and contributor count in header
• Improve visual design with gradient backgrounds and accent lines
• Add staggered animations for stat cards
• Enhance hover effects on commit items and body sections
• Improve responsive design for mobile devices
• Add subtle decorative elements (top borders, left accents)
• Better spacing and padding throughout all sections
• Polish empty state with improved styling
• Enhance filter bar with gradient background
• Improve contributor items with left accent bars
• Add smooth transitions and animations throughout

• Add automatic changelog generation from git history
• Support conventional commits with 11 commit types
• Generate both JSON (for web) and Markdown (for docs)
• Implement breaking change detection and display
• Add scope badges and issue reference links
• Create beautiful web interface with filtering and pagination
• Exclude changelog.json from git tracking
• Only update files when changes are detected

• Add support for both org and user package caches (TYPE_USER_PACKAGES)
• Display user caches with /u/ prefix URLs and person icons
• Show cache type badges (Org/User) in table
• Update stats to show breakdown (e.g., '5 Total (3 orgs, 2 users)')
• Fix cache key parsing to strip org_packages_, packages_, org_, user_ prefixes
• Add two refresh buttons:
• 'Refresh Stale Data' - only refreshes caches older than 30 min
• 'Refresh All Data' - refreshes all caches including fresh ones
• Refactor JavaScript into reusable performRefresh() function
• Improve confirmation dialogs with specific counts and warnings
• Better progress tracking with success/failure counts
• Fix refresh URLs to correctly handle both /username/ and /u/username/ paths
• Remove auto-refresh meta tag (manual refresh only)
• Add console logging for debugging refresh operations

• Enhanced admin/index.php with comprehensive improvements:
• Added CSRF protection for all POST actions
• Added Theme Cache Management card with live theme detection
• Added cache optimization actions (Clear All, Clear Expired, Optimize)
• Improved security with input sanitization
• Added visual theme badges showing all detected themes
• Better error handling and user feedback

• Modernized backend/api/clear-theme-cache.php:
• Added admin authentication and CSRF protection
• Implemented dynamic theme discovery (not hardcoded)
• Returns detailed metrics (theme count, names, sizes)
• Proper error handling and logging
• Works with any theme following metadata convention

• Completely rewrote backend/includes/generate-critical-css.php:
• Future-proof: automatically processes any theme file
• Extracts theme metadata from CSS comments with fallbacks
• Improved error handling and logging throughout
• Separates dark/light themes automatically
• Added regenerateCriticalCSS() for forced refresh
• Better caching with proper file locking

All changes support unlimited themes (not just Catppuccin palettes), include proper security measures, and provide excellent admin UX.

• Add 4 Catppuccin themes: Latte (light), Frappé, Macchiato, Mocha (dark)
• Implement automatic theme discovery from frontend/css/ee/ folder
• Add auto-generated critical CSS system for instant theme loading
• Optimize theme loading: only load active theme CSS on page load
• Add cache management API endpoint for theme CSS regeneration
• Fix Macchiato theme: proper colors, transparent footer sections
• Fix Latte theme: better contrast with white cards
• Remove manual theme configuration - fully automatic system
• Themes now switch instantly without page reload
• No preload warnings - optimized CSS loading strategy

Major Changes:

• Automatic theme discovery: Themes are now auto-detected from /frontend/css/ee/ folder
• No manual configuration needed - just drop a CSS file with metadata and it appears in settings
• Ultra-fast theme preloading with inline critical CSS to prevent flash of default theme

Theme System:

• Created backend/api/themes.php for automatic theme scanning
• Themes use metadata comments (Theme, Class, Emoji) for auto-configuration
• Updated theme-manager.js to dynamically load themes from API
• Added waitForThemes() promise to prevent race conditions

Theme Cleanup:

• Removed 19 unused/low-quality themes (kept only Default and Rust)
• Cleaned up styles.css imports
• Updated settings.php emoji mapping to use API data

New Themes:

• Perfected Rust theme with comprehensive styling
• Created AMOLED Dark theme as example (pure black, high contrast)
• Added theme-template.css with full documentation

Performance Optimizations:

• Inline script in <head> applies theme before first paint
• Critical CSS for instant background/text colors
• CSS preload hints for faster theme file loading
• localStorage caching for instant theme restoration
• Minified inline script (~100 bytes)

Documentation:

• Created frontend/css/ee/README.md with theme creation guide
• Added metadata format documentation
• Listed available Material icons for themes

Developer Experience:

• Create new theme: Copy template, add metadata, save - done!
• Themes automatically appear in settings
• No JavaScript or PHP configuration needed
• Full hot-reload support

• Added 'rust-theme' to valid theme list in API settings controller
• Included theme-manager.js on admin and donate pages for consistent theme support
• Ensures Rust theme can be saved and persisted across all pages

• Added Rust theme to theme manager with crab emoji (🦀)
• Imported rust.css stylesheet
• Theme features Rust game-inspired color scheme with red/rust accents

• Updated all 20 custom themes with hard-coded hex colors for scrollbars
• Added !important flags to override base.css default blue scrollbar
• Each theme now has scrollbar colors matching its unique color scheme:
• Catppuccin Mocha: Pink (#f38ba8)
• Cyberpunk: Magenta (#ff00ff)
• Deep Space: Violet gradient (#8b5cf6 #3b82f6)
• Dracula: Purple (#bd93f9)
• Emerald Oasis: Emerald gradient (#7dd3ae #5fb894)
• Forest: Green (#228b22)
• Gruvbox: Aqua (#83a598)
• Material Dark: Blue (#2196f3)
• Midnight Haze: Lavender (#9d8ec7)
• Minimal Dark: Blue (#74b9ff)
• Monokai: Orange (#fd971f)
• Nord: Frost blue (#88c0d0)
• Ocean: Blue (#1976d2)
• One Dark Pro: Blue (#61afef)
• Retro Terminal: Green (#0f0)
• Rust: Rust red (#cd412b)
• Solarized Dark: Blue (#268bd2)
• Sunset: Orange (#ff8c00)
• Synthwave: Magenta (#ff0080)
• Tokyo Night: Blue (#7aa2f7)
• Replaced CSS variable references with actual color values
• Ensures consistent theme-specific scrollbar appearance

User Profile Pages Enhancements:

• Enhanced profile header with gradient backgrounds and glow effects
• Improved avatar presentation with gradient border and better shadows
• Fixed avatar parallax (now stays fixed on scroll)
• Repositioned score badge directly under username with icon
• Larger, bolder typography with better spacing
• Enhanced stats cards with gradient borders and hover animations
• Improved player activity section with better card designs
• Added 3D tilt effect to game cards on mouse movement
• Implemented entrance animations with stagger effects
• Better responsive design for mobile devices

Organization Pages Improvements:

• Enhanced sidebar with modern type breakdown filters
• Improved package cards with better hover states
• Added gradient backgrounds and smooth transitions
• Better filter buttons with active state indicators
• Enhanced package overlay with fade-in effects
• Improved grid layout and spacing
• Added loading states and animations

Pagination Enhancements:

• Modern container design with gradient backgrounds
• Enhanced buttons with icon animations
• Smart ellipsis for large page counts
• Improved info display with package and page indicators
• Added Material Icons for Previous/Next buttons
• Smooth entrance and hover animations
• Better accessibility and responsive design
• Glow effect on active page

Animations & Effects:

• Entrance animations for all major sections
• Staggered fade-in effects for stats and cards
• Number counting animations
• 3D tilt effects on game cards
• Smooth transitions with cubic-bezier easing
• Shine effects on hover
• Reduced motion support

Accessibility:

• Improved focus states for keyboard navigation
• Better color contrast
• ARIA labels and semantic HTML
• High contrast mode support
• Screen reader friendly

Responsive Design:

• Better breakpoints (1024px, 768px, 480px)
• Mobile-optimized layouts
• Touch-friendly interactions
• Flexible grids that adapt to screen size

Technical:

• Created frontend/css/org-enhancements.css
• Enhanced frontend/css/user-profile.css
• Improved frontend/css/pagination.css
• Updated frontend/js/user-profile.js with new animations
• Updated frontend/js/org-page.js with enhanced interactions
• Added IMPROVEMENTS.md documentation

• Implement Ko-fi webhook handler for real-time donation processing
• Create public donation page (/donate) with supporter list and stats
• Add admin donation management interface with test donation creation
• Implement currency formatting helper for proper amount display
• Add donation database with SQLite storage and statistics tracking
• Secure verification token in config file (not committed)
• Add masked token display in admin panel with copy functionality
• Integrate donation link in footer navigation
• Style donation pages to match dark theme design system

• Create centralized breadcrumb helper with consistent rendering
• Add proper ARIA attributes for accessibility (role, aria-label, aria-current)
• Implement auto-generated separators via CSS
• Fix 'About This Package' JSON rendering bug with proper parser
• Support JSON description structures (headings, lists, code, images, attachments)
• Update all 13 pages to use standardized breadcrumb component
• Consolidate breadcrumb CSS into packages.css
• Add responsive breadcrumb styles for mobile devices
• Remove unnecessary hover effects and animations
• Enhance description section CSS for tables, attachments, and additional elements
• Maintain theme consistency across all pages

Pages updated:

• index.php (package detail, user profile, error pages)
• settings.php, legal.php, about.php, credits.php
• newspost.php, news.php, orgnews.php, release-notes.php
• changelog.php, api-doc.php, ugc-charts.php

All changes validated with no syntax errors or diagnostics issues.

• Show only first 5 tags by default when more than 5 exist
• Add toggle button to expand/collapse all tags
• Maintain accessibility with proper ARIA attributes
• Keep Material Symbols icons and existing styling
• Add smooth transitions and theme-consistent design

• Created new Credits page (/credits) with full acknowledgements
• Special thanks section to Facepunch Studios with contact info
• Organized credits into sections: Core Tech, Frontend, Backend, APIs, Infrastructure
• Enhanced visual presentation with card-based layouts and icons
• Improved About page with mission statement and unique content
• Added 'What Makes Us Different' section highlighting key features
• Removed duplicate content between About and Credits pages
• Added Credits link to footer navigation
• Integrated Credits route into routing system
• Both pages now fully responsive and visually polished

• Add full news article routing and display system
• Fetch news from package LatestNews field and /news API
• Implement modern glassmorphism design for articles
• Add horizontal news card layout with hover effects
• Improve Description section with rich HTML rendering
• Add Latest News section to package detail pages
• Implement news article pages with sections, author cards, and hero media
• Add SEO meta tags (Open Graph, Twitter Card)
• Add breadcrumb navigation and back buttons
• Implement caching for news data
• Add proper 404 error handling
• Style news cards with gradient effects and animations
• Make all layouts responsive for mobile devices

• Support direct linking to specific sections via URL hashes:
• /legal#terms - Terms of Service
• /legal#privacy - Privacy Policy
• /legal#data-collection - Data Collection Details
• /legal#user-rights - Your Rights
• /legal#contact - Contact Information
• Auto-scroll to section based on URL hash on page load
• Update URL hash when clicking quick navigation items
• Handle browser back/forward navigation with hashchange event
• Add visual feedback for active navigation item
• Add .htaccess rewrite rule for /legal without .php extension
• Update settings.php link to use hash-based navigation
• Smooth scroll with header offset for better UX

• Support direct linking to specific tabs via URL hashes:
• /settings#account
• /settings#privacy
• /settings#notifications
• /settings#appearance
• Auto-activate tab based on URL hash on page load
• Update URL hash when switching tabs (without page reload)
• Handle browser back/forward navigation with hashchange event
• Add .htaccess rewrite rule for /settings without .php extension
• Update legal.php links to use hash-based navigation
• Maintain backward compatibility with existing routing

• Add data export API endpoint at /backend/api/settings.php
• Implement 'Download My Data' button in Privacy & Data settings tab
• Export user data in machine-readable JSON format including:
• Profile information (Steam ID, username, avatar)
• User preferences (theme, layout, notifications)
• Session history with obscured IP addresses
• Update legal.php with data portability information
• Configure routing for /api/settings endpoint
• Add user-friendly UI with loading states and toast notifications

• Created fully functional legal page at /legal with ToS and Privacy Policy
• Added TL;DR summary section for quick understanding
• Implemented interactive features: smooth scrolling, section highlighting, copy-to-clipboard
• Added visual data retention timeline with color-coded badges
• Created comprehensive FAQ section with 8 common questions
• Enhanced data collection section with visual cards
• Added actionable user rights guide with step-by-step instructions
• Implemented version history tracking
• Added print/save as PDF functionality
• Included scroll-to-top button and notification system
• Updated footer with both official s&box Discord and s&box Explorer Discord links
• Added proper meta tags for SEO
• Fully responsive design consistent with existing codebase
• Print-friendly styles for documentation purposes

• Added 3-tab interface: Active Now, Recent (7 Days), All History
• All History shows unique users only (no duplicates)
• IP addresses obscured in All History tab (e.g., 5.55.x.x)
• Added session duration and status badges
• Improved UI with Material icons and color-coded activity status

• Add visual distinction for commit types (feat, fix, chore, refactor, docs, style, perf, test, ci)
• Each type has unique color scheme, icon, and badge
• Add filter bar to view commits by type
• Filter buttons show commit counts per type
• Filters persist across pagination
• Mobile-responsive filter design
• Integrate seamlessly with existing theme system

Layout & Visual Improvements:

• Added consistent spacing variables (--spacing-xs through --spacing-2xl)
• Enhanced typography with responsive clamp() sizing for all headings
• Improved card hover effects with gradient overlays and animated accent lines
• Optimized package cards with subtle scale effects (reduced from 4px to 3px)
• Enhanced breadcrumb navigation with proper separators and hierarchy
• Added smooth transitions and reduced excessive hover effects for natural feel

Breadcrumb Enhancements:

• Fixed breadcrumb structure: Home Organization Package
• Removed manual '/' separators, added CSS-based separators
• Enhanced styling with hover effects and icon animations
• Improved accessibility with better focus states
• Added proper ARIA labels and semantic structure

Admin Panel - User Session Tracking:

• Created comprehensive session tracking system (config/session_tracking.php)
• Added user_sessions database table with indexes
• Implemented automatic activity tracking on page loads
• Created /admin/active-users.php showing real-time logged-in users
• Added session statistics: active now, today, this week, all-time
• Tracks Steam ID, username, avatar, IP address, login/activity times
• Auto-refreshes every 30 seconds for real-time monitoring
• Created /admin/test-sessions.php debug page for troubleshooting

Admin Panel UI:

• Added User Activity card with live statistics
• Enhanced visual consistency with gradient backgrounds
• Added animated accent lines on hover for cards
• Improved responsive design for mobile/tablet
• Better spacing and typography throughout
• Fixed Material Symbols icon loading and CSS

Routing & Access:

• Fixed router.php to allow direct access to admin PHP files
• Updated .htaccess to properly route admin and auth directories
• Ensured admin pages are accessible while maintaining security

Technical Improvements:

• Fixed SQL date/time queries for better SQLite compatibility
• Added proper error handling and logging
• Implemented session cleanup (30-day retention)
• Added database connection fallbacks
• All PHP files validated with no syntax errors

Thematic Consistency:

• Unified shadow depths and border treatments
• Consistent transition timing (0.2-0.3s) across all components
• Enhanced focus states for better accessibility
• Improved color contrast and visual hierarchy

• Implement /ugc/charts/game and /ugc/charts/map endpoints
• Fetch live data from Facepunch Services API with 30-minute cache
• Display 5 chart sections: Popular Today, Popular This Month, Trending Now, Most Favorited, Newest Releases
• Integrate with CacheManager for centralized SQLite-based caching
• Add responsive design with glassmorphism effects and smooth animations
• Include Charts navigation link in header
• Support stale cache fallback on API failures

• Split 's&box Explorer' text into individual letter spans using JavaScript
• Add CSS animations for letter-by-letter slide-in effect with bounce
• Animation triggers only when hovering over the brand icon
• Includes staggered delays, color transitions, and smooth cubic-bezier easing
• Scoped to .nav-brand and its children for minimal impact"

• Implement CacheManager class for centralized cache handling
• Add migration utility for existing JSON caches to SQLite
• Support multiple cache types (org_packages, user_packages, etc.)
• Include database schema and initialization

• Add authentication state tracking to prevent unnecessary API calls
• Handle 401 Unauthorized responses gracefully
• Implement proper fallback behavior for unauthenticated users
• Skip server saves when user is not authenticated
• Improve error handling and logging for theme settings

• Added a red animated badge to mark non-working features in the UI
• Created CSS animations for pulsing and shining effects
• Improved accessibility with proper ARIA labels
• Enhanced the layout preference section in settings

• Add user profile page with settings
• Implement theme switching functionality
• Update API endpoints for user preferences
• Modify .htaccess for new routes
• Update changelog with recent changes

• Enhance theme management and user profile UI
• Update API endpoints and header includes
• Add user settings functionality
• Update configuration templates

• Added lightbox-data.php to manage media data for the lightbox component
• Included the script in index.php for media pages
• Updated changelog.json with the latest changes

• Added main.js, package-detail.js, and user-profile.js
• Updated refresh-worker.php and index.php with new features
• Updated changelog.json to reflect recent changes

• Updated favicon declarations to remove duplicates
• Fixed web manifest paths and configuration
• Added proper browserconfig.xml for Windows tiles
• Improved .htaccess rules for static assets
• Ensured proper content types for web manifest
• Added proper cache control headers for static assets

• Updated fixAvatarUrl to handle Steam avatars and ensure highest resolution
• Process avatar URLs in meta-tags.php to use full resolution avatars
• Improved URL handling for both Steam and s&box avatar sources
• Updated Twitter card meta tags with correct profile information
• Ensured HTTPS is used for all avatar URLs