Changelog

Streamlined registration flow with pre-filled invitation email and automatic household assignment

Brand-compliant invitation pages with gradient backgrounds, glass card design, and emoji integration

Wider invitation containers (max-w-2xl) with improved 2-column grid layout for better readability

Smart email field handling with editable pre-filled values and clear helper text

Automatic timezone conversion for invitation expiration timestamps using household timezone settings

Enhanced Resend/Cancel buttons on household settings with gradient styling, icons, and proper spacing

Updated invitation acceptance page with centered layout, larger icons, and responsive grid design

Widened guest layout container from max-w-md to max-w-2xl for better form presentation

Applied brand guidelines throughout invitation workflow with consistent gradient themes and typography

Fixed email field validation error preventing new parent registration by correcting Blade syntax

Resolved secondary parent access denied issue for household settings by updating permission checks

Fixed invitation timezone display showing UTC instead of local time by implementing proper timezone conversion

Enhanced registration controller to handle email changes gracefully without blocking account creation

Age verification (18+) required during registration with birth date validation

Parental consent checkboxes with clear data collection disclosures

COPPA-specific database fields: `birth_date`, `coppa_consent_given`, `coppa_consent_timestamp`

Database migration to add COPPA fields to users table with proper casting

Updated registration controller with COPPA validation rules and consent enforcement

Welcome emails updated with COPPA compliance notices and parental rights information

Clear explanation of data collection practices and contact information for rights requests

Email templates include "COPPA Request" subject line instructions for parents

Registration form with data collection disclosure, parental consent, and rights notice

Profile pages display COPPA consent status, birth date verification, and parental rights

Kid creation/editing pages include data collection notices and parental rights information

Dedicated COPPA settings page (`/settings/coppa`) with full parental control interface

Navigation integration with "Privacy & COPPA" link in parent dropdown menu

Educational content explaining COPPA law and requirements in parent-friendly language

Detailed breakdown of compliance measures: age verification, data minimization, security

Interactive parental rights section with direct email links for all four COPPA rights

Trust-building content highlighting family-focused approach and transparency

Integration with Privacy Policy via prominent link in COPPA section

Complete maintenance script suite: cache clearing, log rotation, database optimization, health monitoring

One-click setup script (`setup-maintenance.sh`) for automated installation and testing

Comprehensive cron job configuration with automated scheduling

Database optimization with table cleanup and performance tuning

Log rotation system preventing disk space issues with configurable retention

System health monitoring every 30 minutes with proactive issue detection

Privacy Policy updated with prominent link to dedicated COPPA information page

Terms of Service include COPPA compliance statement and parental consent requirements

All legal pages now cross-reference COPPA compliance and parental rights

Fixed `points_ledger` table column naming from `related_id` to `reference_type`/`reference_id`

Migration to correct database inconsistencies and prevent 500 errors

Enhanced User model with COPPA field casting and fillable properties

Resolved critical 500 errors caused by database column mismatches

Implemented automated cache clearing to prevent performance degradation

Added comprehensive error handling for maintenance operations

Enhanced system monitoring with disk space, log size, and error rate tracking

Fixed missing `reference_type` and `reference_id` columns in points ledger operations

Resolved enum data truncation errors in chore instance status field

Corrected controller references to use proper database column names

Cleared all Laravel caches (application, config, routes, views) to resolve 500 errors

Fixed Redis cache pruning errors for non-Redis environments

Added graceful handling for missing Notification model in cleanup operations

Enhanced error handling in database optimization scripts

Added environment-specific checks for cache operations and model availability

Improved script robustness with try-catch blocks and informative error messages

Added FAQ and Roadmap links to home page footer navigation

Enhanced branding and navigation on FAQ page with full header/footer

Enhanced branding and navigation on Roadmap page with full header/footer

Updated roadmap timeline to reflect current dates (Q4 2025 - Q1 2026)

Added "Advanced Mobile" features section to roadmap

404 - Adventure Not Found page with search animation

419 - Session Expired page with clock animation and cache clearing

403 - Access Denied page with lock animation

429 - Rate Limited page with running animation and countdown timer

500 - Server Error page with robot animation

Compact, mobile-friendly design with gradient text styling

`ErrorNotificationService` for automated email alerts to admin

Email notifications for 419, 403, and 500 errors with detailed context

Custom exception handler integration for comprehensive error tracking

Added "Back to Home" links on login and register pages

Improved navigation flow between authentication and landing pages

Removed "Smart Home" and "Community" feature sections

Updated release timeline from 2025 to current 2025-2026 schedule

Replaced removed features with "Advanced Mobile" capabilities

Optimized error pages for better mobile experience

Reduced container sizes and improved typography hierarchy

Enhanced visual consistency with main application branding

Resolved 419 Page Expired errors caused by CSRF token/session conflicts

Cleared configuration, route, and view caches to fix authentication flow

Fixed session configuration for production environment compatibility

Custom `EmailService` class with branded HTML email templates

Beautiful, mobile-responsive email designs with gradients and emojis

System email filtering to skip `@kid.local` test addresses

Chore assigned to kid (with chore details and points)

Chore completed notification to parent (requires approval)

Chore approved notification to kid (with points earned)

Chore rejected notification to kid (with reason and retry encouragement)

Reward requested notification to parent (with cost and kid details)

Reward approved notification to kid (with congratulations)

Reward rejected notification to kid (with points refunded)

Welcome emails for both parents and kids with role-specific content

Custom password reset emails with branded templates

Override of Laravel's default password reset notification

Automated summary emails with chore completion stats

Points earned and current balance tracking

Rewards claimed statistics

Secure mail test page (`/mail-test`) restricted to non-production environments

Form interface to test all email types with realistic sample data

Support for all 11 email notification types

`ChoreController`: Send assignment emails when chores are created/updated

`KidChoreController`: Notify parents when kids complete chores

`ApprovalController`: Send approval/rejection emails for chores and rewards

`KidRedemptionController`: Notify parents of reward requests

`RegisteredUserController`: Send welcome emails on registration

Custom `ResetPasswordNotification` to use EmailService instead of Laravel defaults

Updated `User` model to override `sendPasswordResetNotification` method

Added Mailgun configuration to `config/services.php`

Updated `config/mail.php` to include Mailgun mailer transport

Enhanced `.env.example` with comprehensive Mailgun settings

Fixed missing `kid.dashboard` route references (changed to `kid.today`)

Added mail test routes with proper authentication middleware

Added `guzzlehttp/guzzle` for HTTP client support

Added `symfony/mailgun-mailer` for Laravel Mailgun integration

Resolved null configuration issues in EmailService constructor

Fixed PHP 8.4 deprecation warnings with proper nullable type declarations

Corrected environment variable reading for Mailgun credentials

Fixed production environment blocking of mail test functionality

Corrected all `kid.dashboard` route references to use existing `kid.today` route

Fixed mail test route accessibility and middleware configuration

Resolved missing `APP_KEY` causing encryption errors

Fixed Laravel development server startup and connection issues

Cleared configuration cache to ensure proper environment loading

Theme system with database persistence (Animal Pals, Space Cadets, Fantasy Quest, Sports Squad)

Maintenance endpoint for database migrations and seeding

Comprehensive brand system with mascots and visual identity

Stunning UI with gradient elements, glass cards, and animations

Deployment script (`deploy.sh`) for consistent environment setup

Environment configuration system with proper `.gitignore` rules

Rewards step in the onboarding flow with pre-defined reward options

Visual feedback for selected rewards with hover and active states

Complete visual transformation of the UI with modern design elements

Improved dashboard with role-aware content (parent vs kid views)

Enhanced navigation with animated indicators and gradient elements

Updated `.gitignore` to better handle environment files and deployment artifacts

Deployment process now handles environment-specific configurations

Critical bug in chore assignments where kids couldn't see assigned chores

Chore instance creation when updating assignments

Route parameter issues in chore editing

Approvals: List pending completions and approve/reject; credit points on approval.

Kid UI: Today view with "Mark Done"; instant-complete credits points and triggers confetti.

Recurring schedules: daily scheduled command `app:generate-chore-instances` creates today's instances; scheduled at 05:00.

Navigation: added Kids/Chores (parent), Approvals (parent), Today (kid).

Points: added kid points badge to Today header with subtle Motion One animation on award.

Chore create form: added hidden default for `approval_required` and Alpine.js toggles for schedule controls.

Switched Add Kid form to standard POST for redirect + validation flow.

Laravel app scaffolded in `backend/` with Breeze (Blade) and Tailwind.

Role middleware (`EnsureParent`, `EnsureKid`) and route groups.

Database migrations: users (extended), households, members, chores, schedules, chore_instances, rewards, redemptions, points_ledger, notifications, chore_templates, chore_assignments.

Seeders: chore templates + sample household/users/chores/rewards.

Parent UI: Kids list/create; Chores list/create/edit with approval toggle, assignment, scheduling (none/one-off/daily/weekly).

Re-added Stripe via Laravel Cashier to Tech Stack and README.

Selected interactivity approach: HTMX (Livewire optional later).

Selected animation library: Motion One + confetti micro-lib.

Documented selected theme packs: Animal Pals, Space Cadets, Fantasy Quest, Sports Squad.

Initial project planning docs: `project-summary.md`

Tech stack selection: Laravel + Blade + Tailwind + Alpine + HTMX/Livewire

Checklist scaffold: `checklists/2025-09-05_mvp-planning.md`

`README.md` and `CHANGELOG.md` scaffolds