Release v0.5.0

.gitignore

@@ -30,6 +30,7 @@ yarn-error.log*
 
 # Coverage directory
 /coverage
+/coverage-quiz
 
 # Dotenv files
 *.local
@@ -64,7 +65,7 @@ next-env.d.ts
 # Documentation (development only)
 .claude/
 CLAUDE.md
-frontend/docs/
+frontend/_dev-notes/
 frontend/.env.bak
 
 

CHANGELOG.md

@@ -159,3 +159,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 - Stabilized shop checkout, refund, inventory, and webhook flows
 - Improved Neon performance and reduced CU-hours usage
 - Cleaned up redundant files, comments, and legacy code
+
+## [0.5.0] - 2026-01-26
+
+### Added
+
+- AI-powered Word Helper for Q&A:
+  - Text selection with floating “Explain” button
+  - Multilingual explanations (uk / en / pl)
+  - Draggable modal with caching and rate limiting
+- Extensive automated testing:
+  - 90%+ coverage for Quiz core logic (unit + integration)
+  - Full Q&A component, hook, and API test coverage
+- SEO & content enhancements for Blog:
+  - Breadcrumb navigation (posts & categories)
+  - Schema.org JSON-LD (Article, BreadcrumbList)
+  - Improved metadata (descriptions, dates, authors)
+- Improved navigation & UX:
+  - Refactored responsive header with clear active states
+  - GitHub stars indicator in header
+  - Enhanced mobile menu with scroll locking
+- Visual & UX polish across platform:
+  - Unified category accent colors across Quiz & Q&A
+  - Refined Leaderboard layout and mobile responsiveness
+  - Updated About page interactions and game mechanics
+- Infrastructure & environment support:
+  - GROQ API integration for AI features
+  - New environment variable support and documentation
+
+### Changed
+
+- Quiz UI unified with Q&A design system:
+  - Shared CategoryTabButton component
+  - Category-based accent colors across full quiz flow
+  - Traffic-light countdown timer (green / yellow / red)
+- Blog experience refined:
+  - Improved search relevance and filtering UX
+  - Better author navigation and category presentation
+- Header, footer, and navigation styles aligned to brand tokens
+- Shop UI polish:
+  - Button styles and hero messaging updated
+  - Stripe checkout success redirect fixed
+- Removed deprecated Contacts page and all references
+
+### Fixed
+
+- Stabilized Leaderboard layout, spacing, and mobile behavior
+- Fixed quiz timer persistence and anti-cheat messaging UX
+- Improved accessibility and visual consistency across components
+- Resolved locale duplication in Stripe checkout redirects
+- Cleaned up redundant UI states, placeholders, and legacy styles

frontend/.env.example

@@ -1,5 +1,7 @@
 # --- Core / Environment
+APP_ADDITIONAL_ORIGINS=https://admin.example.test
 APP_ENV=
+APP_ORIGIN=https://example.test
 APP_URL=
 NEXT_PUBLIC_SITE_URL=
 
@@ -83,10 +85,17 @@ STRIPE_WEBHOOK_RL_WINDOW_SECONDS=60
 STRIPE_WEBHOOK_INVALID_SIG_RL_MAX=30
 STRIPE_WEBHOOK_INVALID_SIG_RL_WINDOW_SECONDS=60
 
+# SECURITY: If true, trust Cloudflare's cf-connecting-ip header for rate limiting.
+# Enable ONLY when traffic is fronted by Cloudflare (header is set by Cloudflare at the edge).
+# Default: false (0). Keep 0 in untrusted environments to avoid IP spoofing.
+TRUST_CF_CONNECTING_IP=0
+
 # SECURITY: If true, trust x-real-ip / x-forwarded-for headers for rate limiting.
 # Enable ONLY behind Cloudflare or a trusted reverse proxy that overwrites these headers.
 # Default: false (empty/0/false).
 TRUST_FORWARDED_HEADERS=0
 
 # emergency switch
 RATE_LIMIT_DISABLED=0
+
+GROQ_API_KEY=

frontend/.gitignore

@@ -12,6 +12,7 @@
 
 # testing
 /coverage
+/coverage-quiz
 
 # next.js
 /.next/
@@ -45,5 +46,5 @@ next-env.d.ts
 
 # Documentation (only for development)
 CLAUDE.md
-docs/
-.claude
+_dev-notes/
+.claude