CHANGELOG

1.4.4 - 2025-10-23

Fixed

• Refactor parent project modules identification
• Update OAuth settings UI with new components
• Updated igniter script with more bulletproofing

1.4.3 - 2025-10-22

Fixed

• Installer Robustness - Universal compatibility with complex config files
  • Added support for runtime.exs with Dotenvy and environment variables
  • Comprehensive error handling prevents crashes on complex syntax
  • Smart import_config detection ensures proper configuration order
  • Multiple fallback strategies (AST parsing → File operations → manual instructions)
• Duplicate Prevention - Installation now truly idempotent
  • Added duplicate detection for all configurations (repo, layout, mailer, Swoosh)
  • Integration plug no longer duplicates on multiple installs
  • All config checks prevent adding same configuration twice
• Igniter Tracking - Fixed file change tracking warnings
  • All file modifications now properly tracked by Igniter
  • Eliminated "file changed since read" warnings

Changed

• Error Recovery - Graceful degradation with clear user feedback
  • All installer modules wrapped in comprehensive try/rescue blocks
  • Clear manual configuration instructions when automatic fails
  • IO.warn messages for debugging failed operations

1.4.2 - 2025-10-22

Fixed

• We removed unecessary catch all for routing
• Fixed issue with runtime not working when installing with project is setup to use .env files

1.4.1 - 2025-10-21

Added

• OAuth User Settings - Connected Accounts management interface in user settings
  • View all linked OAuth providers (Google, Apple, GitHub, Facebook)
  • Connect additional OAuth accounts to existing user profile
  • Disconnect OAuth providers with security validation
  • User-friendly instructions for OAuth account linking
  • Email verification matching for OAuth connections
• OAuth Setup Instructions - In-app Google OAuth configuration guide
  • Step-by-step Google Cloud Console setup instructions
  • Callback URL display for easy copying
  • Collapsible instructions panel in admin settings
  • Reverse proxy configuration examples (nginx/apache)

Changed

• OAuth Infrastructure - Automatic HTTPS detection and deployment improvements
  • X-Forwarded-Proto header detection for reverse proxies
  • OAuth callbacks work out-of-box behind nginx/apache
  • Manual oauth_base_url override for edge cases
  • OAuth2.AccessToken serialization in JSONB fields
• Email UI - Enhanced table components
  • Replace HTML tables with reusable .table_default component
  • Consistent table styling across email details

Fixed

• OAuth Integration - EnsureOAuthScheme plug integration
• Code Quality - Credo readability improvements in OAuth modules
• Icon Management - Centralized all OAuth icons to Core.Icons module

Upgrade Notes

• OAuth providers require matching email addresses between provider and PhoenixKit account
• Users can manage connected accounts at /users/settings
• At least one authentication method (password or OAuth) required for account access

1.4.0 - 2025-10-17

Added

• Pages Content System - Full Markdown-driven site with admin file navigator, metadata-aware editor, and public rendering at /pages/* routes
• User Custom Fields - WordPress ACF-like JSONB custom fields system with column filtering, reordering, and management interface
• Collaborative Editing - FIFO locking system for entities with real-time presence tracking and PubSub event broadcasting
• Content Language Module - Multi-language support with language switcher, locale routing, and language management interface
• User Settings - Default user status on creation, automatic email confirmation for first user, timezone settings with geolocation IP tracking

Changed

• Email Operations - Sender profile configuration, one-click AWS infrastructure setup, prioritized credentials (Settings DB → ENV)
• Developer Experience - OAuth/email dependencies now mandatory, mix phoenix_kit.* --help support, IgniterCompat for cleaner installs
• Navigation - Admin navigation uses LiveView navigate for instant transitions, disabled long-polling for faster cleanup

Fixed

• Custom Fields - Column updates when deleting custom fields
• Critical Bugs - Ecto.SubQueryError in user role filtering, OAuth checkbox errors, PhoenixKit.Config usage issues
• Email System - AWS credential bugs, SQS message loss, chart initialization, idempotency/deduplication improvements
• Code Quality - Cleaned up Dialyzer/Credo warnings, improved logging, removed excessive debug output

Upgrade Notes

• Run mix deps.get to install mandatory OAuth/email packages
• Enable Pages module from /admin/modules to use content management
• Custom fields available in user management submenu

1.3.5 - 2025-10-16

Added

• Pages Module - File-based content management system spanning admin and public workflows
  • Tree-based navigator in /admin/pages for creating, moving, duplicating, and deleting Markdown content
  • Full-screen editor with metadata controls (status, timestamps) and unsaved-change safeguards
  • Public rendering pipeline that serves published pages at /pages/* and the catch-all root route
• Email Sender Configuration - Dynamic from_email and from_name settings via admin interface
  • New Sender Configuration form at /admin/settings/emails
  • 3-tier priority system: Settings DB → Config → Defaults
  • Live preview showing how emails will appear to recipients
  • All outgoing emails now use dynamic sender information
  • Settings update immediately without restart

Fixed

• Email Dashboard Chart Initialization - Resolved chart rendering issues on initial page load
  • Added Promise-based Chart.js library loading with retry mechanism
  • Implemented event buffering for chart data when charts not ready
  • Enhanced lifecycle handling with multiple LiveView events
  • Added exponential backoff retry (up to 5 attempts)
  • Charts now reliably render even with slow network conditions
• Code Quality Issues - Fixed Dialyzer warnings and Credo recommendations
  • Resolved nested module aliasing warnings across 26 files
  • Fixed function complexity issues (cyclomatic complexity reduced)
  • Improved code efficiency with Enum.map_join instead of map + join
  • Fixed "last clause in with is redundant" patterns
  • Alphabetized module aliases for better organization

Improved

• Documentation - Reduced CLAUDE.md to core guidance and moved module-specific content into Emails/Pages/Entities READMEs plus a new OAuth & Magic Link guide
• Installer Experience - Added an IgniterCompat helper so installer modules compile quietly even when Igniter isn't installed

1.3.4 - 2025-10-15

Added

• AWS Infrastructure Automation - One-click AWS email infrastructure setup from admin web interface
  • New PhoenixKit.AWS.InfrastructureSetup module for automated resource creation
  • Creates SNS Topic, SQS Queues, DLQ, and SES Configuration Set with one click
  • Idempotent operations (safe to run multiple times)
  • Web interface at /admin/settings/emails with "Setup AWS Infrastructure" button
  • Auto-fills AWS settings form with created resource details
  • Added ex_aws_sns ~> 2.3 dependency for SNS operations
• Mix Tasks Help System - Comprehensive --help flag support for installation and update tasks
  • mix phoenix_kit.install --help - Detailed installation options with examples
  • mix phoenix_kit.update --help - Update task documentation with CI/CD guidelines
  • Usage examples, option descriptions, and troubleshooting tips
  • Auto-detection capabilities explanation
• Public AWS Credentials API - Centralized AWS credentials management with smart fallback
  • PhoenixKit.Emails.aws_configured?() - Public function for checking AWS setup
  • Settings Database as primary source, Environment Variables as fallback
  • Improved error messages mentioning both Web UI and ENV configuration

Changed

• AWS Credentials Priority - Settings Database now takes precedence over Environment Variables
  • Primary: Settings Database (runtime configuration via Web UI)
  • Fallback: Environment Variables (for production secrets)
  • Users can configure credentials via Web UI without ENV duplication
  • Maintains backward compatibility for ENV-only deployments
• Documentation Updates - Comprehensive guide for AWS setup and credentials management
  • CLAUDE.md expanded with 540+ new lines
  • Added AWS Credentials Priority section with configuration scenarios
  • Removed obsolete config-based email configuration examples
  • Added Installation and Update help system documentation

Fixed

• AWS Credentials Configuration Bug - Fixed issue where Settings DB credentials were ignored
  • get_sqs_config() now uses helper functions with Settings DB → ENV fallback
  • has_aws_credentials() properly checks both Settings DB and ENV
  • SQS Worker now respects Web UI configured credentials
• Test Email URLs - Fixed test email links to use site_url from settings instead of localhost

1.3.3 - 2025-10-14

Changed

• Dependency Management - Made OAuth authentication dependencies mandatory instead of optional
  • ueberauth, ueberauth_google, ueberauth_apple, and ueberauth_github are now required dependencies
  • Ensures OAuth functionality works out-of-the-box without manual dependency configuration
  • Simplifies installation process for new users
• Email System Dependencies - Added required dependencies for complete email functionality
  • gen_smtp - Required for Amazon SES SMTP email adapter
  • saxy - Required for AWS SQS XML response parsing
  • finch - HTTP client for AWS API communication (already included)
  • Ensures complete email system support without additional configuration
  • Improves reliability of email delivery and event tracking through AWS SES/SQS

Fixed

• AWS Credentials Configuration - Fixed critical issue where AWS credentials entered via Web UI were ignored
  • Problem: Settings Database credentials were not being used, system only checked Environment Variables
  • Solution: Updated get_sqs_config() to use Settings DB → ENV fallback pattern
  • Updated has_aws_credentials() to properly check both Settings DB and ENV
  • Made aws_configured?() public function for use across modules
  • Enhanced error messages to mention both Web UI and ENV configuration methods
  • Added comprehensive documentation in CLAUDE.md about credentials priority system

Improved

• Settings DB Priority System - Clarified and enforced credentials configuration priority
  • Primary: Settings Database (runtime configuration via Web UI at /admin/settings/emails)
  • Fallback: Environment Variables (for production secrets and legacy deployments)
  • Users can now configure credentials via Web UI without ENV duplication
  • Maintains backward compatibility for ENV-only deployments

Migration Notes

• Projects upgrading from 1.3.2 must run mix deps.get to install new required dependencies
• OAuth features now work automatically without manual dependency installation
• Amazon SES email adapter now fully functional without additional setup
• AWS credentials can now be configured via Web UI; ENV variables optional

1.3.2 - 2025-10-10

Fixed

• Critical: Email System SQS Message Loss Bug - Fixed critical bug where manual email status sync was deleting ALL messages from SQS queue, including non-matching ones

  • Issue #1: Non-matching messages now stay in queue for normal SQS worker processing
  • Prevents permanent data loss of delivery events from AWS SES

• Email Event Deduplication - Added deduplication for events from multiple queues

  • Issue #2: Events from both SQS and DLQ are now deduplicated by message_id + event_type
  • Prevents duplicate event records when same event exists in both queues

• Email Event Idempotency - Enhanced idempotency checks for all event types

  • Issue #3: Added duplicate prevention for bounce, complaint, and reject events
  • Completes idempotency coverage (delivery, open, click already had checks)
  • Prevents duplicate events during retry scenarios and race conditions

• SQS Polling Optimization - Reduced AWS API calls by up to 80%

  • Issue #4: Manual sync now stops after first match instead of polling all batches
  • Saves API costs and reduces latency (from 10s to 2s average)

• System Settings Integration - Fixed hardcoded values in manual sync

  • Issue #5: Now uses get_sqs_max_messages() and get_sqs_visibility_timeout() from settings
  • Issue #6: Visibility timeout increased from 30s to system default (300s)
  • Prevents race conditions during long-running operations

Improved

• Error Logging - Stacktrace formatting improved for better debugging

  • Issue #7: Uses Exception.format_stacktrace() for readable log output

• Code Quality - Removed redundant require Logger statements

  • Issue #8: Single module-level require Logger instead of 11 duplicate requires
  • Cleaner codebase following Elixir best practices

Technical Details

• Modified files:
  • lib/phoenix_kit/emails/emails.ex (77 changes)
  • lib/phoenix_kit/emails/sqs_processor.ex (66 changes)
• All changes verified with successful compilation
• Based on comprehensive code review identifying 8 issues (1 critical, 2 high, 3 medium, 2 low priority)

1.3.1 - 2025-10-07

### Fix: Admin Role Access with Real-time Scope Refresh Implemented a PubSub-based scope refresh system that updates sessions in real-time without forcing logouts:

• New Module: PhoenixKit.Users.ScopeNotifier manages user-specific PubSub topics for role changes
• LiveView Integration: Sessions automatically subscribe to their user's topic and rebuild the cached scope when roles change
• Admin Demotion Handling: Users who lose admin privileges are immediately redirected from admin pages with clear error messaging
• Transaction Safety: Role mutations use broadcast flags to prevent partial-state notifications during database transactions

Additional Improvements:

• Better Error Messages: Now distinguishes between "not logged in" vs "logged in but insufficient role" scenarios
• Subscription Lifecycle: Proper subscription management when users switch or sessions end
• Safe User Fetching: Added get_user/1 helper that returns nil instead of raising exceptions

Technical Details:

• Broadcasts happen on phoenix_kit:user_scope:#{user_id} topics
• LiveViews attach a :handle_info hook to process {:phoenix_kit_scope_roles_updated, user_id} messages
• Scope refresh compares old vs new admin status to trigger redirects only when necessary
• Edge cases handled: user deletion mid-session, owner role protection, non-admin page refreshes

1.3.0 - 2025-10-06

Added

• Magic Link Registration System - Passwordless two-step registration via email
  • New PhoenixKit.Users.MagicLinkRegistration context for registration link management
  • Magic link request LiveView at {prefix}/users/register/magic-link
  • Registration completion LiveView at {prefix}/users/register/complete/:token
  • Configurable expiry time (default: 30 minutes)
  • Automatic email verification on completion
  • Referral code support in registration flow
  • Database V16 migration: Modified tokens table to allow null user_id for magic_link_registration context
  • Check constraint ensuring user_id required for all non-registration token contexts
• OAuth Provider Validation - Enhanced OAuth request handling with configuration checks
  • Provider existence validation before authentication flow
  • Helpful error messages when OAuth not configured or provider not found
  • Debug logging for OAuth authentication flow
  • Graceful fallback to login page with user-friendly error messages

Changed

• OAuth Dependencies Made Optional - OAuth authentication dependencies (ueberauth, ueberauth_google, ueberauth_apple) are now marked as optional
  • Reduces dependency bloat for applications not using OAuth
  • Applications wanting OAuth must explicitly add dependencies to their mix.exs
  • Detailed setup instructions added to CLAUDE.md with step-by-step configuration guide
  • Improved referral code handling in OAuth flow with safe fallback when ReferralCodes module not loaded

Improved

• OAuth Documentation - Comprehensive setup guide with environment variable configuration
  • Clear dependency installation instructions
  • Provider configuration examples for Google and Apple Sign-In
  • Environment variable setup guide for development and production
  • Migration notes for V16 oauth_providers table and magic link registration

Fixed

• Dialyzer Warnings - Updated line number references for OAuth controller pattern matching
• Entities Menu Navigation - Fixed main Entities menu staying selected when clicking entity submenus by adding disable_active={true} attribute
• New Nav Bar - Added new top nav bar with update interface for comfort and ease of use

UI/UX Improvements

• Hero Icons Migration - Migrated modules page to use Heroicons for consistent icon system
  • Replaced custom icon components with hero-icons: hero-arrow-left, hero-cog-6-tooth, hero-users, hero-envelope, hero-information-circle
  • Consistent sizing and theming across dashboard and modules pages

1.2.14 - 2025-09-30

Added

• Email Queue LiveView - Complete real-time queue monitoring interface with system status, rate limit tracking, and failed email management
  • System status cards showing online status, daily sent count, failed emails (24h), and retention settings
  • Rate limit status display with visual progress bars for global, recipient, sender limits and blocklist statistics
  • Failed emails management table with individual retry and bulk operations support
  • Recent activity table displaying last 20 emails with delivery, open, and click event badges
  • Auto-refresh every 10 seconds for real-time monitoring
  • Bulk retry and delete operations with confirmation workflow
• Email Blocklist LiveView - Full-featured blocklist management interface with comprehensive filtering and bulk operations
  • Statistics dashboard showing total blocks, active blocks, and expired blocks
  • Advanced search and filtering by email address, reason, and status (active/expired)
  • Add block form with support for temporary blocks (expiration dates) and multiple block reasons
  • CSV import/export functionality for bulk blocklist management
  • Bulk operations: remove selected addresses and export selected to CSV
  • Pagination support (50 entries per page) with navigation controls
  • Auto-refresh every 30 seconds with manual refresh option
  • Visual status indicators for active and expired blocks
• Template-Mailer Integration - Production-ready template system integration with automatic tracking
  • New PhoenixKit.Mailer.send_from_template/4 main API for sending templated emails
  • Convenience wrapper PhoenixKit.Emails.Templates.send_email/4 for cleaner API
  • Automatic template loading by name with status validation
  • Variable substitution with template rendering
  • Automatic usage tracking (usage_count and last_used_at updates)
  • EmailLog system integration for delivery tracking
  • Support for custom from addresses, reply-to, and metadata
  • Comprehensive error handling (template_not_found, template_inactive)
• RateLimiter Blocklist API - Three new public API methods for blocklist management
  • list_blocklist/1 - Query blocklists with filtering (search, reason, status), sorting, and pagination
  • count_blocklist/1 - Count blocked emails with optional filters
  • get_blocklist_stats/0 - Retrieve blocklist statistics including total, active, expired, and by-reason breakdowns
• Emails.delete_log/1 - New public API method for email log deletion with proper error handling
• Email Headers Management - Complete headers tracking system with AWS SES integration
  • New email_save_headers setting to control headers saving behavior
  • Headers automatically populated from AWS SES events via SQS processor
  • Headers extracted from all SES event types (send, delivery, bounce, complaint, open, click, reject, delay, subscription)
  • New API methods: save_headers_enabled?(), set_save_headers(enabled)
  • Admin UI toggle for enabling/disabling headers collection
  • Headers button in email details hidden when no headers exist
• Emails Advanced Settings - Expanded configuration API for lifecycle and monitoring
  • set_compress_after_days(days) - Configure email body compression timing (7-365 days)
  • set_s3_archival(enabled) - Enable/disable S3 archival for old email data
  • set_cloudwatch_metrics(enabled) - Toggle CloudWatch metrics integration
  • set_sqs_max_messages(count) - Configure SQS polling batch size (1-10 messages)
  • set_sqs_visibility_timeout(seconds) - Set SQS message visibility timeout (30-43200 seconds)
  • Enhanced Emails Settings LiveView with compression, archival, CloudWatch, and SQS controls

Changed

• Template Editor - Enhanced with test send and draft save capabilities
  • Test send functionality now available in both new and edit modes (previously edit-only)
  • New "Save as Draft" button in creation mode for saving incomplete templates
  • Smart status handling: regular save creates active templates, draft save creates draft templates
  • Improved user experience allowing template testing before final save
• Template Variable System - Complete overhaul with automatic management
  • Automatic variable extraction from template content (subject, html_body, text_body)
  • Smart default descriptions for 20+ common variables (user_name, email, url, etc.)
  • Inline editing of variable descriptions with real-time updates
  • Variables automatically added to changeset during validation and save
  • Removed manual "Add" button workflow in favor of automatic detection
  • Visual improvements with better empty states and usage instructions
• Template Editor Preview - Iframe-based isolation for template preview
  • HTML preview now rendered in sandboxed iframe to prevent style leakage
  • Template styles no longer affect editor UI layout
  • Automatic height adjustment based on content
  • Improved security with sandbox restrictions
• Template Form Validation - Fixed changeset handling and error display
  • Corrected form binding from nested map to direct changeset
  • Fixed error extraction using Keyword.get instead of get_in
  • Applied fixes to all 8 form fields (name, slug, display_name, category, status, description, subject, html_body, text_body)
• Template Slug Auto-generation - Improved logic for reliable slug creation
  • Moved slug generation before validation in changeset pipeline
  • Enhanced to check both changeset changes and existing field values
  • Handles both nil and empty string cases properly
  • Made slug field visible on editor form with helper text

Fixed

• Template Creation Errors - Resolved Access.get/3 function clause errors in template editor forms
• Variable Description Editing - Fixed inability to edit variable descriptions after auto-addition
• Template Editor Modal - Removed unnecessary modal step in template creation workflow
• Slug Validation - Fixed "slug can't be blank" errors with improved auto-generation timing
• Code Quality Issues - Fixed all compiler warnings, Credo issues, and Dialyzer errors
  • Fixed nested module aliasing in SQS processor (Credo software design warning)
  • Removed Logger metadata keys not found in config (compiler warnings)
  • Fixed nested code depth issue by extracting helper function (Credo refactoring warning)
  • Removed unreachable pattern match clause in email interceptor (Dialyzer error)

Improved

• Emails Code Quality - Enhanced error handling and logging across emails modules
• SQS Processor Architecture - Refactored headers update logic with proper function extraction and reduced nesting depth
• LiveView Performance - Optimized data loading and real-time updates in queue and blocklist interfaces
• User Experience - Streamlined template creation and management workflows

1.2.13 - 2025-09-29

Added

• Email Template Management System - Complete database-driven template system with CRUD operations and variable substitution
• Template Editor Interface - Full-featured LiveView editor with HTML structure, preview, and test functionality
• Template List Interface - Comprehensive template management with search, filtering, and status management
• Mix Task for Template Seeding - New mix phoenix_kit.seed_templates task for creating default system templates
• Migration V15 - Database tables for email template storage with system template protection
• Version Tracking in Migrations - Enhanced migration system with PostgreSQL table comments for version tracking
• Debug Logging for Email Metrics - Enhanced error handling and debugging for chart data preparation
• Automatic Variable Extraction - Smart detection and extraction of template variables with intelligent descriptions
• Smart Variable Descriptions - Automatic mapping of common template variables to user-friendly descriptions

Changed

• Mailer Integration - Updated to use database templates with fallback to hardcoded templates for backward compatibility
• User Notifier - Enhanced to support template-based email generation with variable substitution
• Email Metrics Dashboard - Improved chart data initialization and error handling for better reliability
• Email Templates Search - Simplified search form layout for better user experience
• Template Editor Workflow - Simplified template creation process with automatic variable detection and validation

Fixed

• Email Metrics Chart Data - Fixed initialization errors and null value handling in chart data preparation
• Migration Rollback - Added proper version tracking for migration rollback operations
• Linter Issues - Resolved alias ordering and function complexity issues for better code quality
• Pre-commit Hooks - Enhanced pre-commit validation with proper error handling
• Template Slug Generation - Fixed auto-generation logic for better handling of template names and slugs
• Template Validation Flow - Improved validation sequence for better user experience during template editing

Removed

• Modal Template Creation - Removed modal-based template creation interface in favor of simplified direct editor workflow

1.2.12 - 2025-09-27

Added

• Complete Emails Architecture - New email_system module replacing legacy email_tracking with enhanced AWS SES integration and comprehensive event management
• AWS SES Configuration Task - New mix phoenix_kit.configure_aws_ses task for automated AWS infrastructure setup with configuration sets, SNS topics, and SQS queues
• Enhanced SQS Processing - New Mix tasks for queue processing and Dead Letter Queue management:
  • mix phoenix_kit.process_sqs_queue - Real-time SQS message processing for email events
  • mix phoenix_kit.process_dlq - Dead Letter Queue processing for failed messages
  • mix phoenix_kit.sync_email_status - Manual email status synchronization
• V12 Migration - Enhanced email tracking with AWS SES message ID correlation and specific event timestamps (bounced_at, complained_at, opened_at, clicked_at)
• Emails LiveView Interfaces - Reorganized email management interfaces with improved navigation and functionality
• Extended Event Support - Support for new AWS SES event types: reject, delivery_delay, subscription, and rendering_failure
• Enhanced Status Management - Expanded email status types including rejected, delayed, hard_bounced, soft_bounced, and complaint

Changed

• Email Architecture Refactoring - Complete transition from email_tracking to email_system module for better organization and AWS SES integration
• Email Event Processing - Enhanced event handling with provider-specific data extraction and improved error recovery patterns
• Database Schema - Updated email logging with aws_message_id field and specific timestamp tracking for different event types
• LiveView Organization - Reorganized email-related LiveView modules under email_system namespace for better structure

Removed

• Legacy Email Tracking Module - Removed entire email_tracking module and all associated files in favor of new email_system architecture
• Old Email LiveView Interfaces - Removed legacy email_tracking LiveView components and templates
• Deprecated Email Processing - Removed outdated email event processing and archiver implementations

Fixed

• Emails Integration - Improved integration patterns for better performance and reliability
• SQS Message Processing - Enhanced message processing with proper error recovery and retry mechanisms
• Email Event Handling - Better handling of AWS SES events with improved message parsing and validation

1.2.11 - 2025-09-24

Added

• AWS SQS Integration - Complete SQS worker and processor for real-time email event processing from AWS SES through SNS
• Manual Email Sync - New sync_email_status/1 function to manually fetch and process SES events for specific messages
• DLQ Processing - Dead Letter Queue support for handling failed messages with comprehensive retry mechanisms
• Mix Tasks for Emails:
  • mix phoenix_kit.email.send_test - Test email sending functionality with system options
  • mix phoenix_kit.email.debug_sqs - Debug SQS messages and emails with detailed diagnostics
  • mix phoenix_kit.email.process_dlq - Process Dead Letter Queue messages and handle stuck events
• Emails Supervisor - OTP supervision tree for SQS worker management with graceful startup/shutdown
• Application Integration Module - Enhanced integration patterns for emails initialization

Improved

• Email Interceptor - Enhanced with provider-specific data extraction for multiple email services (SendGrid, Mailgun, AWS SES)
• Emails API - Added manual synchronization and event fetching capabilities for both main queue and DLQ
• Mailer Module - Improved integration with emails and enhanced error handling patterns
• Email Event Processing - Better handling of AWS SES events with improved message parsing and validation

Fixed

• Email Status Processing - Improved handling of delivery confirmations, bounce events, and open management
• SQS Message Handling - Enhanced message processing with proper error recovery and retry logic

Added

• Update Task Enhancement - Added --yes/-y flag for skipping confirmation prompts and automatic migration execution

1.2.10 - 2025-09-21

Improved

• Authentication UI Consistency - Unified design across all authentication pages (login, registration, magic link, account settings) with consistent card layouts, shadows, and spacing
• Icon Integration - Added icon slot support to input component enabling consistent iconography throughout forms using PhoenixKit's centralized icon system
• User Experience - Enhanced interaction feedback with hover scale animations and focus transitions on buttons and form elements
• Visual Cohesion - Removed background color inconsistencies and standardized visual hierarchy across all authentication flows
• Development Documentation - Comprehensive contributor guide with Phoenix built-in live reloading (primary method), custom FileWatcher fallback, GitHub workflow, and complete CONTRIBUTING.md documentation

Added

• Magic Link Integration - Added Magic Link authentication option to login page with elegant divider and themed button
• Account Settings Redesign - Complete visual overhaul of settings page to match authentication pages design language
• Flash Message Auto-dismiss - Implemented automatic flash message dismissal after 10 seconds for improved user experience
• Form Field Icons - Email, password, and profile fields now display contextual icons (email, lock, user profile) for better visual clarity

Changed

• Magic Link Page Layout - Redesigned magic link page with card-based layout matching login and registration pages
• Settings Page Structure - Restructured account settings with centered layout, improved typography, and consistent spacing
• Input Component Enhancement - Extended core input component to support icon slots while maintaining backward compatibility

1.2.9 - 2025-09-18

Improved

• Icon System Centralization - Consolidated all inline SVG icons across the codebase into centralized PhoenixKitWeb.Components.Core.Icons module for better maintainability and consistency
• Authentication Pages Icons - Migrated 10 inline SVG icons from login, registration, and magic link pages to centralized icon components (email, lock, user profile, user add, login icons)
• Component Reusability - Migrated 50+ SVG icons from 20+ template files to reusable component functions with configurable CSS classes
• Code Quality - Eliminated duplicate SVG code and standardized icon usage patterns throughout admin interfaces, forms, and user authentication flows
• LiveView Module Organization - Reorganized LiveView modules into logical subfolders for better structure
• Route Organization - Restructured admin routes with improved hierarchical organization
• Email URL Generation - Enhanced Routes.url/1 function to prioritize site_url setting from Settings over dynamic endpoint detection, ensuring consistent email links across PROD and DEV environments

Changed

• User Routes - Moved all user-related routes under /admin/users/ prefix:
  • /admin/roles → /admin/users/roles
  • /admin/live_sessions → /admin/users/live_sessions
  • /admin/sessions → /admin/users/sessions
  • /admin/referral-codes → /admin/users/referral-codes
• Email Routes - Reorganized email routes for better clarity:
  • /admin/email-logs → /admin/emails
  • /admin/email-logs/:id → /admin/emails/email/:id
  • /admin/email-metrics → /admin/emails/dashboard
  • /admin/email-queue → /admin/emails/queue
  • /admin/email-blocklist → /admin/emails/blocklist

Added

• icon_login Component - Added new login icon component (arrow entering door) to Icons module for authentication pages
• New Icon Components - Added icon_download, icon_lock, and icon_search components to Icons module for comprehensive coverage
• Icon Documentation - Enhanced Icons module with detailed component documentation and usage examples
• HTML Email Templates - Added professional HTML versions for all authentication emails (confirmation, password reset, email update) with responsive design and consistent branding
• Site URL Configuration - Email links now use site_url setting from Settings panel when configured, providing full control over email URLs in production environments

Fixed

• Icon Reference - Fixed incorrect icon_check_circle reference to icon_check_circle_filled in magic_link_live.ex
• Code Readability - Removed unnecessary alias expansion braces for single module imports

1.2.8 - 2025-09-17

Improved

• Asset Build Pipeline - Enhanced asset rebuilding using standard Phoenix asset pipeline (mix assets.build) with intelligent fallbacks to esbuild, tailwind, and npm commands for better compatibility
• Dynamic URL Prefix Handling - Replaced hardcoded /phoenix_kit/ paths with dynamic Routes.path() throughout the codebase for proper prefix support
• Code Quality - Improved code formatting, comment alignment, and whitespace consistency across all modules
• Installation Messages - Enhanced user feedback messages with dynamic prefix support and clearer instructions

Fixed

• Hardcoded Paths - Replaced static URL paths with dynamic prefix resolution using PhoenixKit.Utils.Routes
• Asset Rebuild Process - Asset builder now tries multiple commands in order of preference for maximum compatibility

Removed

• SimpleTest File - Removed unused development test artifact (simple_test.ex)

1.2.7 - 2025-09-16

Added

• Email Navigation - Added Email Metrics, Email Queue, and Email Blocklist pages to admin navigation menu
• Email Blocklist System (V09 Migration) - Complete email blocklist functionality with temporary/permanent blocks, reason management, and audit trail
• Email Routes - Added routes for all Email LiveView pages in admin integration
• Users Menu Grouping - Reorganized admin navigation with expandable Users and Email groups using HTML5 details/summary
• Migration Documentation - Comprehensive migration system documentation with all version paths and rollback options

Fixed

• Email Cleanup Task Pattern Matching - Fixed Dialyzer warning about Emails.enabled?() pattern matching
• Dashboard Add User Button - Corrected navigation from dashboard Add User button to proper /admin/users/new route
• Migration V09 Primary Key - Fixed duplicate column 'id' error in phoenix_kit_email_blocklist table creation

Improved

• Navigation Menu Structure - Replaced custom JavaScript with native HTML5 details/summary for better reliability and performance
• Email Group Organization - Email, Metrics, Queue, and Blocklist now properly grouped under Email section

1.2.6 - 2025-09-15

Added

• Admin Password Change Feature - Direct password change capability for administrators in user edit form
• Username Search Integration - Added username search to referral code beneficiary selection and main user dashboard
• Username Implementation - Added optional username field with automatic generation from email for new user registrations

Fixed

• Form Validation Display Issues - Replaced static validator hints with proper Phoenix LiveView components using phx-no-feedback:hidden
• Dark Theme Compatibility - Improved password management sections with theme-adaptive styling

Improved

• Date Formatting - Updated referral dashboard to use user settings-aware date formatting
• Dynamic Routing - Replaced hardcoded /phoenix_kit/ paths with PhoenixKit.Utils.Routes.path() throughout referral codes
• Admin UI Experience - Enhanced password management with both direct change and email reset options

1.2.5 - 2025-09-12

Added

• Emails Foundation with email logging and event management schemas
• Email Rate Limiting Core with basic rate limiting functionality and blocklist management
• Email Database Schema (V07) with optimized tables and proper indexing
• Email Interceptor System for pre-send filtering and validation capabilities
• Webhook Processing Foundation for AWS SES event handling (bounces, complaints, opens, clicks)
• get_mailer/0 function in PhoenixKit.Config for improved mailer integration
• RepoHelper Integration for proper database access patterns in emails modules

Fixed

• All compilation warnings (40 → 0) - 100% improvement in code cleanliness
• PhoenixKit.Repo undefined references - proper integration with PhoenixKit.RepoHelper
• Unused variable warnings throughout the codebase
• Pattern matching issues in error handling code
• Missing @moduledoc for EmailBlocklist schema

Improved

• Credo warnings (30 → 5) - 83% improvement in code quality metrics
• Dialyzer warnings (40 → 4) - 90% improvement in type checking
• Code formatting with proper number formatting (86_400 vs 86400)
• Code efficiency with optimized Enum operations (map_join vs map + join)
• Function complexity by extracting nested logic into helper functions
• Error handling by replacing explicit try blocks with case/with patterns
• Alias ordering alphabetically in imports
• Trailing whitespace removal across codebase

Technical Improvements

• Memory-efficient patterns preparation for future batch processing
• Comprehensive input validation for emails data
• SQL injection protection with parameterized queries
• Professional code structure following PhoenixKit conventions
• Enhanced error handling with proper rescue clauses and pattern matching

1.2.4 - 2025-09-11

Added

• Complete referral codes with comprehensive management interface
• Referral code creation, validation, and usage management functionality
• Admin modules page for system-wide module management and configuration
• Flexible expiration system with optional "no expiration" support for referral codes
• Advanced admin settings for referral code limits with real-time validation:
  • Maximum uses per referral code (configurable limit)
  • Maximum referral codes per user (configurable limit)
• Beneficiary system allowing referral codes to be assigned to specific users
• User search functionality with real-time filtering for beneficiary assignment
• Hierarchical navigation structure with "Modules" parent and nested "Referral Codes" item
• Professional referral code generation with confusion-resistant character set
• Settings persistence system with module-specific organization
• Introduced custom prefix in the config (/phoenix_kit to something else)

Changed

• Improved form component alignment and styling in referral code forms
• Updated core input components to fix layout issues with conditional labels
• Reorganized admin settings order for better user experience
• Strengthened form validation with real-time feedback and error handling

Fixed

• Settings persistence ensuring values are properly saved and loaded from database

1.2.3 - 2025-09-11

Added

• Enhanced mix phoenix_kit.status task with hybrid repository detection and fallback strategies
• Comprehensive status diagnostics with detailed database connection reporting
• Application startup management for reliable status checking in various project configurations
• Intelligent repository detection supporting both configured and auto-detected repositories
• Mailer delegation support with automatic parent application mailer detection
• Comprehensive AWS SES configuration with automatic Finch HTTP client setup
• Finch HTTP client integration for email adapters (SendGrid, Mailgun, AWS SES)
• Auto-detection of existing mailer modules in parent applications
• Enhanced email configuration with configurable sender name and email address
• Production-ready email templates for SMTP, SendGrid, Mailgun, and AWS SES
• Complete AWS SES setup guide with step-by-step checklist and region configuration
• Automatic dependency management for gen_smtp when using AWS SES
• Swoosh API client configuration for HTTP-based email adapters

Changed

• Asset rebuild system simplified to consistently recommend rebuilds for better reliability
• Status task now provides more detailed verbose diagnostics for troubleshooting
• Update task now delegates status display to dedicated status command for consistency
• Removed complex asset checking logic in favor of straightforward rebuild recommendations
• Email system architecture now supports both delegation and built-in modes
• Mailer configuration defaults to using parent application's existing mailer when available
• Installation process automatically configures appropriate email dependencies
• Documentation restructured with detailed provider-specific setup guides
• PhoenixKit.Mailer module enhanced with delegation capabilities

Fixed

• Critical CSS integration bug where regex patterns incorrectly matched file paths containing "phoenix_kit" substring
• CSS integration now properly detects only exact PhoenixKit dependency paths (../../deps/phoenix_kit) and ignores false matches like "test_phoenix_kit_v1_web"
• Improved pattern matching specificity to prevent installation failures in projects with similar naming
• Trailing whitespace issues across multiple files for better code quality
• Unused alias imports in tasks and modules
• Dialyzer warnings by updating ignore patterns for better type checking
• Email sender configuration now properly supports custom from_email and from_name settings
• Production email setup documentation with comprehensive provider examples
• Mailer integration patterns for better parent application compatibility

1.2.2 - 2025-09-08

Added

• Comprehensive asset rebuild system with mix phoenix_kit.assets.rebuild task for automatic CSS integration
• System status checker with mix phoenix_kit.status task for installation diagnostics
• Asset management tools for PhoenixKit CSS integration updates and Tailwind CSS compatibility
• Common utility functions in PhoenixKit.Install.Common for version checking and installation management
• Helper functions for better code organization and separation of concerns
• Progress tracking and enhanced user feedback for migration operations
• Type specifications for Mix.Task modules and asset rebuild functions

Changed

• CSS integration workflow simplified with better Tailwind CSS 4 support and @source directive optimization
• Migration function refactored to reduce cyclomatic complexity and improve maintainability
• Code organization improved with extraction of helper functions across multiple modules
• Enhanced error handling and user notifications for asset rebuild operations

Fixed

• All Credo static analysis warnings (trailing whitespace, formatting issues, deep nesting)
• All Dialyzer type analysis warnings with proper function specifications
• CSS integration logic and @source directive paths for correct asset compilation
• Complex migration function broken down into smaller, more maintainable functions
• Conditional statements simplified (cond to if) for better code clarity

1.2.1 - 2025-09-07

Added

• Project title customization system with dynamic branding across all admin interfaces
• Project title integration in authentication pages (login and registration)
• Time display enhancement showing both date and time in Users and Sessions tables
• Settings-aware date/time formatting functions for consistent user preferences

Changed

• Date handling moved from PhoenixKit.Date to PhoenixKit.Utils.Date for better organization
• All admin pages now consistently display custom project title instead of hardcoded "PhoenixKit"
• Enhanced admin interface with unified project branding throughout navigation
• Login and registration pages now show custom project title in headings and browser tabs
• Changed config and magic link

Fixed

• Fixed asset rebuilding integration in migration strategy

1.2.0 - 2025-09-03

Added

• User settings system with customizable time zone, date format, and time format preferences
• Comprehensive session management system for admin interface with real-time monitoring
• Live data updates system for admin panels with automatic refresh capabilities
• Automatic user logout functionality when role changes occur for enhanced security
• DateTime formatting functions with Timex library integration for better date/time handling
• Enhanced authentication session management for improved user experience

Changed

• Authentication components updated with GitHub-inspired design and unified development notices
• Date handling refactored into separate PhoenixKit.Date module (aliased as PKDate) for better organization
• User dashboard "Registered" field now uses enhanced date formatting from settings
• Improved code quality and PubSub integration for better real-time communication

Fixed

• Missing admin routes for settings and modules sections
• Dialyzer type errors resolved across the codebase
• Live Activity link in dashboard now correctly navigates to intended destination
• Settings tab information updated with accurate user preferences display

1.1.1 - 2025-09-02

Added

• Profile settings functionality with first name and last name fields
• Profile changeset function for user profile updates
• Complete profile editing interface in user settings

Fixed

• Router integration by removing unnecessary redirect pipe for login route
• Added admin shortcut route for improved navigation
• Enhanced admin dashboard accessibility

1.1.0 - 2025-09-01

Changed

• BREAKING: Simplified role system by removing is_active column from role assignments
• Role removal now permanently deletes assignment records instead of soft deactivation
• All role-related functions updated to work with direct deletion approach
• Improved performance by eliminating is_active filtering in database queries
• Documenatation link fixed for hex

Added

• V02 migration for upgrading existing installations to simplified role system
• Enhanced migration system with comprehensive upgrade path from V01 to V02
• Pre-migration reporting with warnings about inactive assignments that will be deleted
• Rollback support for V02 migration (though inactive assignments cannot be restored)

Fixed

• Test suite updated to reflect schema new changes

Migration Notes

• Existing V01 installations can upgrade using mix phoenix_kit.update
• V02 migration will permanently delete any inactive role assignments
• New installations will use V02 schema without is_active column

1.0.0 - 2025-08-29

Initial version with basic functionality, mostly around authorization and user registration with roles. Also admin page for admin users with User section.