Product record
What has changed inside Hearthlight.
A dated record of shipped features, reliability work, content additions, and product polish across the kitchen planner.
Release ledger
The app's public record, kept like notes in the grimoire.
Kroger Pricing Integration & Witchy Correspondences
Real-Time Kroger Grocery Pricing
Integration with Kroger API provides live pricing data for 100+ common ingredients. Recipe cost estimates now reflect real grocery store prices from your local Ralphs, Kroger, or affiliated stores.
70+ Ingredient Magical Correspondences
Comprehensive database of witchy ingredient properties including planetary rulers, elemental energies, chakra alignments, magical associations, and culinary wisdom. Search any ingredient to discover its hidden powers.
Smart Ingredient Matching
AI-powered ingredient matching connects your pantry items to the best grocery products. Understands variations, synonyms, and ingredient aliases for accurate price lookups.
Recipe Cost Transparency
Every recipe now displays estimated cost per serving with last-updated timestamps. See exactly how much your magical meals cost to prepare.
Pricing Health Monitoring
Background system keeps ingredient prices fresh with automatic updates. Daily cron jobs ensure pricing data stays current without manual intervention.
Witchy Affiliate Product Catalog
Curated collection of magical tools, crystals, herbs, and spiritual supplies with Amazon affiliate links. Each product tagged with magical properties and correspondences.
Shopping List Export - CSV, Print & Email
CSV Export for Shopping Lists
Export your shopping lists to CSV format for use in Excel, Google Sheets, or other spreadsheet applications. Perfect for offline shopping or sharing with family members.
Print Shopping Lists
Print your shopping lists with a clean, optimized format designed for in-store use. Features checkboxes to mark items as you shop, category grouping, and optional price display.
Email Shopping Lists
Send your shopping lists via email to yourself or family members. Beautifully formatted with category grouping, optional pricing, and summary totals—perfect for coordinating grocery trips.
Smart CSV Formatting
Exported CSVs include item names, quantities, units, categories, and prices—all organized by category with summary totals at the bottom.
Print-Optimized Layout
Printed shopping lists use large, readable text with checkboxes for each item. The layout automatically hides navigation and UI elements, showing only your list items organized by category.
Email Template with Hearthlight Branding
Email exports feature a beautiful gradient header, organized category sections, and a professional summary footer. Works perfectly in Gmail, Outlook, and Apple Mail.
Special Character Handling
Robust CSV escaping ensures special characters, commas, and quotes display correctly in all spreadsheet applications.
Timestamped Filenames
Downloaded files automatically include the list name and export date for easy organization: hearthlight_grocery-list_2025-11-21.csv
Phase 2: UX Polish & Secret Santa Reliability
Nova UX Loading Skeletons
Consistent loading experience across all major views with beautiful skeleton screens. No more jarring content shifts—see placeholder content while data loads.
Secret Santa Email Logging System
Complete email delivery tracking with retry capabilities. Monitor every Secret Santa email sent, track delivery success, and automatically retry failed sends.
Admin Email Stats Dashboard
Real-time monitoring of email success rates with failure alerts. Admins can now track Secret Santa email health and quickly identify issues.
Global Secret Santa Monitoring
New admin analytics endpoints provide comprehensive visibility into Secret Santa email operations across the entire platform.
Enhanced Dashboard Loading States
6 dashboard widgets now feature polished loading skeletons (Tarot, Recipes, Protein, Pricing, Moon, and Garden widgets) for a smoother experience.
Recipe List Loading Experience
Recipe browsing now shows elegant RecipeCardSkeleton placeholders while content loads, maintaining visual consistency.
Secret Santa View Loading Boundaries
Secret Santa assignment and reveal pages now gracefully handle loading states with clear visual feedback.
Pricing Widget Polish
Pricing widgets now display StatsGridSkeleton during data fetching for a more professional appearance.
Commerce Phase 3 Decision Summary
Published comprehensive documentation outlining the Kroger and Amazon Fresh API integration roadmap with technical specifications and timeline.
Dashboard Reliability & Pricing Turbo Boost
Public Recipe Browsing Restored
Updated the recipes API to gracefully handle anonymous sessions so Hearthlight recipes stay accessible even when you’re not signed in. 180 regression tests now pass again.
Pricing Engine 10,000× Faster
Optimized the nightly meal price updater (200 recipes/second) so the entire catalog refreshes in minutes instead of days—no more console log bottlenecks.
Metadata Case Normalization
Meal types, protein tags, and dietary flags now land in Pascal Case, ensuring enriched recipes immediately surface in filters and coverage dashboards.
Header & Menu Readability
Refined navigation hover/active states (desktop + mobile + dropdown menus) with high-contrast navy text so the UI stays legible against accent backgrounds.
Protein Widget Reliability
Widget now handles empty protein slots with graceful fallbacks, telemeters missing data, and respects dinner/protein filters so suggestions never disappear.
Tarot Flip Consistency
Daily Tarot interactions now mirror the TarotCard component—hover/touch animations stay on the revealed face and redraws animate smoothly.
Pricing Everywhere
Recipe cards, widgets, and lists now show emerald cost chips with last-updated timestamps, giving transparent pricing context across the dashboard.
Recipe Cost Module Polish
Optimistic refresh button, detailed missing-price messaging, and better handling of partially priced ingredients make cost breakdowns trustworthy.
Always-on Monitoring
The alert service now boots with the app runtime, enabling protein widget, tarot, and pricing health checks without manual intervention.
Bug Bash Playbooks & Docs
Published BUG_BASH_QUICKSTART.md, BUG_BASH_RESULTS.md, OPTIONAL_HARDENING_CHECKLIST.md, DEPLOYMENT_READINESS_SUMMARY.md, refreshed release notes, and support FAQ so every agent can QA, triage, and deploy with confidence.
Homepage Redesign & Interactive Tarot Experience
Interactive Tarot Card Cascade
Beautiful animated hero section featuring flowing tarot cards that respond to mouse movement, creating an immersive magical experience on the homepage.
Unified Navigation
Standardized navigation across all marketing pages for seamless browsing between features, pricing, and changelog.
Enhanced Feature Descriptions
Updated all marketing pages with comprehensive details about the 70+ magical correspondences, virtual garden, and grimoire lessons.
Homepage Access Restored
Fixed redirect issue that was preventing visitors from viewing the landing page and exploring features before signing up.
Ingredient Correspondence System
Dynamic Correspondence Database
70+ pre-seeded ingredient correspondences with automatic generation for any ingredient on demand. Includes magical properties, planetary rulers, elemental energies, chakra alignments, and culinary wisdom.
Intelligent Fuzzy Matching
Smart search that understands variations, aliases, and common misspellings—finds 'basil' even if you type 'bazil' or 'sweet basil'.
Alias Learning System
Database learns from user searches and automatically associates new ingredient names with existing correspondences.
Rate Limiting & Caching
Free tier: 2 lookups/day, Kitchen Mystic: 10/day. Results cached for instant retrieval.
Virtual Garden Enhancement
Advanced Plant Management
Track individual plants with planting dates, care schedules, moon phases, companion planting recommendations, and harvest yields.
Plant Care Logging
Record watering, fertilizing, pruning, and harvesting activities with moon phase associations and quantity tracking.
Companion Planting Database
Comprehensive database of plant relationships—know which herbs and vegetables thrive together and which to keep apart.
Garden Calendar Integration
Moon phase-based planting calendar with optimal timing suggestions for planting, pruning, and harvesting.
Grimoire Educational Library
7 Comprehensive Lessons
79 minutes of educational content covering kitchen witchery fundamentals, herb magic, moon cooking, seasonal eating, intention setting, and kitchen altar creation.
Lesson Progress Tracking
Mark lessons as complete and track your learning journey through the curriculum.
Professional Content
Beginner-friendly lessons with practical exercises and real-world applications for everyday kitchen practice.
OAuth & Social Login
Facebook Login
Sign in with your Facebook account for quick and secure access.
Apple Sign In
Use Apple ID for enhanced privacy and streamlined authentication.
Discord Integration
Connect with Discord for Coven features and community integration.
Account Linking
Link multiple OAuth providers to the same account with enhanced PrismaAdapter integration.
Community Hub
Create & Join Communities
Form collaborative communities with like-minded practitioners. Share recipes, plan group gatherings, and connect.
Shared Recipe Library
Community members can share their favorite recipes and magical workings within the group.
Group Sabbat Planning
Coordinate celebration plans, assign tasks, and organize group rituals.
Mentorship Matching
Community hosts can offer mentorship to newer practitioners seeking guidance.
Meal Planning Overhaul
Faster Generation
Reduced meal plan generation time by 40% with optimized prompts and caching.
Better Variety
Improved algorithm ensures greater recipe diversity and prevents repetition.
Nutrition Balancing
System now considers macronutrient balance across the entire meal plan period.
Pantry Prioritization
Meal plans now prioritize ingredients nearing expiration to reduce food waste.
Receipt Scanning
OCR Receipt Processing
Scan grocery receipts with your phone camera—items automatically added to inventory.
Spending Tracking
Track grocery spending patterns and see how smart meal planning reduces costs.
Inventory Accuracy
Receipt scanning ensures inventory quantities stay accurate and up-to-date.
Sabbat Planning Tools
Wheel of the Year
Complete sabbat planning for all eight seasonal celebrations with traditional recipes.
15+ Ritual Templates
Pre-written ritual structures for kitchen magic, herb blessings, and seasonal ceremonies.
Traditional Recipes
Historically accurate seasonal recipes for each sabbat celebration.
Group Planning
Coordinate sabbat celebrations with your Coven, including task assignments and potluck coordination.
Advanced Inventory
Expiration Alerts
Get notified when ingredients are approaching expiration with configurable alert windows.
Quantity Tracking
Track exact quantities with unit conversions—know if you have enough for your recipe.
Category Organization
Better categorization with custom tags and smart sorting by expiration date.
Usage Analytics
See which ingredients you use most and optimize your shopping patterns.
Moon Phase Integration
Real-time Astronomy
Live astronomical calculations for accurate moon phase data, illumination percentage, and phase transitions.
Cooking Recommendations
Phase-specific cooking guidance—know what foods and activities align with current lunar energies.
Named Moons
Traditional moon names by month (Wolf Moon, Beaver Moon, etc.) with cultural significance.
Recipe Alignment
Filter recipes by moon phase compatibility and magical intentions.
Planetary Hours
Hour Calculator
Calculate planetary hours for your location with sunrise/sunset data.
Activity Suggestions
Get recommendations for cooking, baking, and ritual timing based on planetary influences.
Calendar Integration
See current planetary hour and upcoming transitions throughout the day.
Energy Journal
Daily Tracking
Log how different foods, recipes, and moon phases affect your energy levels.
Pattern Recognition
Automatically identifies correlations between your food choices and energy patterns over time.
Mood & Clarity
Track mental clarity, physical energy, and emotional well-being alongside your meals.
Smart Shopping Lists
List Optimization
Shopping lists now auto-organize by store section and eliminate duplicate ingredients.
Price Comparison
Get price estimates and cost-effective alternative suggestions.
Multi-Recipe Consolidation
Add multiple recipes and the system consolidates ingredients intelligently.
Enhanced Tarot Readings
Daily Tarot
Receive daily tarot guidance with culinary and practical applications.
Multiple Spreads
Choose from single card, three-card, and Celtic Cross spreads.
Reading History
Save and review past readings to track spiritual insights over time.
Tarot Journal
Add personal notes and reflections to your readings.
Hearthlight Launch
Recipe Suggestion Engine
Launch of core recipe suggestion engine with pantry-based recommendations.
Recipe Storage
Save unlimited recipes with photos, notes, and custom tags.
Basic Inventory
Track pantry ingredients with manual entry.
Three-Tier Pricing
Free Hearth Keeper, $7 Kitchen Mystic, and $15 Coven Leader tiers.
More updates are in progress
Send feature suggestions tosupport@hearthlight.app