[0.4.94] - 2026-02-27

Added

• Unified Media API: Created a consolidated /api/admin/media endpoint for GET, POST, and DELETE operations.
• D1 Media Synchronization: Mandatory database registration for all physical storage uploads (R2, Cloudinary) to ensure UI observability.
• Internal Docs Table: Created internal_docs table (Migration 133) for high-performance administrative document tracking.

Fixed

• Recent Docs Hotfix: Restored functionality to /api/admin/recent-docs by migrating from deprecated internal_pages to the new internal_docs schema.

Changed

• Storage Factory Consolidation: Refactored src/lib/storage to centralize provider selection logic in storage-config.ts.
• MediaStorage Interface: Updated list() method to support optional ListOptions for future filtering.

[0.4.93] - 2026-02-27

Added

• D1 Schema Overhaul: Consolidated pages, posts, navigation, and site_settings into new JSON-driven D1 tables.
• KV Read-Through Caching: Implemented edge caching for blog posts, pages, navigation, and site/theme settings.
• Payload Strictness: Admin APIs now reject legacy markdown strings; enforce BlockNode[] arrays.
• Diagnostic Endpoint: Added /api/admin/diagnostics/migration-check for D1/KV integrity verification.

Changed

• Navigation Migration: Transitioned from row-per-item to single JSON blob per navigation set.
• Settings Migration: Unified site/theme config into site_settings D1 table with getCachedSetting<T> helper.

[0.4.93] - 2026-02-26

Added

• Visual Editor Interaction Layer: Implemented an invisible overlay with @dnd-kit intercept and block targeting logic via data-block-id.
• Recursive Drag-and-Drop: Deep-cloned recursive block movement algorithms (moveBlock) deployed into editorStore.ts via Zustand for seamless before, after, and inside placements.
• Tree Render Engine: Reconciled Next-Gen components to accept the strict Recursive Tree JSON model (BlockNode).

Changed

• Strict Types Overhaul: Refactored src/types/blocks.ts WYSIWYG models from any into strict JSONValue type, resolving >1000 lint errors and establishing a robust serialization foundation.
• Live Preview Hydration: Expanded BlockRenderer interface and LivePreviewWrapper to hydrate the Zustand model on load side-by-side with legacy routes.
• D1 Schema Overhaul (Phases 1 & 2): Replaced legacy MDX logic with strict JSON-driven D1 database architecture.
  • Type Overhaul: Introduced strict TypeScript interfaces (PageD1, PostD1, BlockNode) to enforce the new JSON-centric schema (layout_json, seo_json, content_json). Maintained legacy Page and Post bounds for backward compatibility during the transition.
  • MDX Purge: Refactored src/lib/pages.ts to execute cleanly against D1, stripping out previous file-system delegation layers and moving purely to JSON parsing/stringification for D1 reads and writes. Standardized method names (e.g., getPageBySlug, upsertPage).
  • Downstream Type Safety: Updated 10+ consumption points—including API routes ([...slug]/route.ts, route.ts, reorder), main routing pages (app/page.tsx, features/[slug]/page.tsx), and visual renderers (PageRenderer, LivePreviewWrapper)—to cleanly accept PageD1 types, achieving zero type-check errors.
  • Reorder Logic Refactor: Adapted the admin reorder endpoint to swap updated_at timestamps instead of relying on legacy sort_order columns, maintaining UX without schema bloat.

[0.4.92] - 2026-02-11

Fixed

• Critical Cache Collision: Fixed a bug where changelog cache keys were static, causing incorrect filtered views.
• Data Fetching Logic: Corrected useState to useEffect in Admin Roadmap and Changelog pages to ensure "File Mode" banners display correctly.
• Settings API: Updated /api/admin/changelogs/settings to return full configuration (mode, path, type).

Optimized

• Production Caching: Implemented unstable_cache for file-based roadmap and changelog sources to reduce filesystem I/O on Cloudflare.

[0.4.91] - 2026-02-11

Added

• Hybrid Roadmap & Changelog System: Fully implemented the adapter-based architecture for release history and future planning.
  • Data Source Abstractions: Created ChangelogSource and RoadmapSource adapters allowing seamless switching between D1 Database and Markdown file sources.
  • Public Roadmap Page: Launched /roadmap route with a premium, responsive UI that parses development phases directly from .project/ROADMAP.md.
  • Refactored Changelog APIs: Ported all admin changelog endpoints to the new adapter pattern, ensuring 100% compatibility with UI components in all modes.
  • Database Integration: Added roadmap_items and roadmap_changelog_links tables to D1 for GUI-based roadmap management.
  • Admin UI Enhancements: Integrated "File Mode" status banners in the admin panel to clearly indicate when content is being driven by project files.
  • Dynamic Configuration: Added support for Cloudflare KV settings to control data sources without redeployment.

[0.4.90] - 2026-02-10

Added

• Roadmap & Changelog System Architecture: Designed comprehensive hybrid architecture supporting both file-based (agentic coding) and database-driven (GUI users) workflows.
  • Adapter Pattern: Created ChangelogSource interface with FileChangelogSource and DatabaseChangelogSource implementations.
  • Visibility Controls: Designed internal vs external routing architecture for public/private content separation.
  • File Integration: Specified parser for extracting public roadmap features from development roadmap.md file.
  • Handoff Documentation: Created complete implementation specs in .ai.docs/handoffs/roadmap-changelog-system/ (7 design documents, ~20-25 hour implementation plan).
  • Directory Proposal: Designed .project/ folder reorganization for CHANGELOG.md and ROADMAP.md.

[0.4.89] - 2026-02-10

Added

• Internal Changelog Search: Implemented real-time search filtering for the Platform Changelog with matching count indicator and "Jump to Latest" shortcut.
• Dynamic Page Migration Foundation: Established
  the [...slug] dynamic route and internal_pages D1 table for future content migration.
• Page-by-Page Migration Analysis: Commenced comprehensive audit of existing internal pages (Roadmap, Docs, Feature Comparison) for D1 migration suitability.

[0.4.88] - 2026-02-10

Added

• FilterPillsWidget: Created new standardized widget for filter badges in AdminHeader.
• AdminHeader: Added identity prop and layout="cards" support for dashboard-style headers.
• Dashboard Standardization: Refactored /admin (Dashboard) to use AdminHeader with DashboardIdentityCard and standardized stats/links.
• Blog Standardization: Refactored /admin/content/blog to use stats prop and FilterPillsWidget, removing bespoke JSX implementation.

[0.4.87] - 2026-02-10

Added

• Admin UI Matrix Analysis: Completed a comprehensive audit of the Admin UI architecture against the implementation matrix.
  • Findings: Documented discrepancies in Dashboard/Blog standardization and missing widget components (FilterPillsWidget, StatsMatrixWidget).
  • Report: Generated detailed findings report in .ai.docs/findings/admin-ui-matrix-analysis.md.

[0.4.86] - 2026-02-10

Fixed

• AdminHeader Responsiveness: Restored "Push Down" behavior for header actions on mobile viewports.
• Stats Matrix: Refined QuickStatsNav with a new matrix variant for better vertical stacking on small screens.
• Grid Logic: Fixed 4-column grid spanning issue where stats were compressed on desktop.

[0.4.85] - 2026-02-09

Added

• Admin Hub "Gold Standard": Established the definitive pattern for Admin Hub headers using the new Card Layout.
  • Growth Hub Migration: Fully refactored /admin/growth to use the 3-card standardized header with green color branding and glassmorphism.
  • Premium Glass Effect: Integrated backdrop-blur-md with bg-white/60 (optimized from /80) for enhanced visual depth.
• Improved Card Layout:
  • Repositioned icons next to titles in HubSectionCard for better hierarchy.
  • Standardized all hub grid layouts to 4-column desktop grids.
  • Implemented noCard prop in QuickStatsNav and QuickLinkRow to prevent recursive padding/border issues when nested in cards.

Changed

• Header Refinement: Adjusted AdminHeader.tsx to support color prop-based branding and increased transparency for better glass effects.
• Metric Optimization: Simplified Growth Hub stats by removing "Revenue" placeholder to better match header proportions.

[0.4.84] - 2026-02-09

Changed

• Content Hub Polish: Standardized Content Hub (/admin/content) header to consistent "Admin Standard" pattern.
  • Replaced legacy "Quick Actions" card with standardized AdminCommandBar actions.
  • Fixed Stats Widget loading state bug (statsLoading reference error).
  • Adopted QuickStatsNav for standardized header metrics.
• UI Localization: Renamed "Global Command Palette" to "Global Search" based on user feedback.

Added

• UI Standardization Plan: Analyzed and documented a strategy (.future-dev/admin-ui-polish/ui_standardization_analysis.md) for unifying Admin Headers project-wide using a "Card Layout" approach.
• Migration Strategy: Documented plan (.future-dev/internal-docs-platform/migration_plan.md) for migrating static admin pages to dynamic database storage.
• Future Roadmap: Added "Header Layout Customization" to admin-editor-improvements.md as a planned feature.

[0.4.83] - 2026-02-02

Changed

• Internal Hub Polish: Removed duplicate InternalDocsList component from the Internal Hub page.
• Search Architecture: Removed the confusing Global Search input from OrbitalNav in favor of a context-aware Hub Search (and future Global Command Bar).
• Link Fixes: Corrected internal documentation links to point to the correct /admin/internal routes instead of the editor.

Planned

• Global Command Bar: Finalized architecture for a global "Command-K" search to be integrated into the bottom AdminCommandBar.

Added

• Unified Internal Pages: Migrated internal documentation and testing protocols to a unified internal_pages table architecture.
• AdminPageRenderer: Implemented a dynamic page renderer with a widget registry (Changelog, Mermaid, Health Scores).
• Public/Private Changelogs: Advanced release management with 'Public' vs 'Private' release notes.
• AdminFilterBar v2: Enhanced filter bar with multi-tab support and composite filter states.

[0.4.81] - 2026-02-02

Added

• Navigation Manager Overhaul: Implemented a two-column premium edit modal with live preview.
• Icon Picker Component: Compact, searchable Lucide icon picker for navigation items.
• Dropdown Preview: Real-time feedback showing how navigation items look in Standard vs Mega layouts.
• Rich Metadata Persistence: Full E2E support for description and metadata_json in D1.
• Migration Plan: Developed comprehensive strategy for migrating static admin pages to dynamic D1 storage (migration_plan.md).

[0.4.80] - 2026-02-02

Added

• Split-Panel Mega Menu: Implemented a two-column "Mega Menu" layout for the admin navigation bar.
  • Feature Cards: Rich navigation items with icons and descriptions for technical/architecture modules.
  • Component Extraction: Extracted NavDropdown to a reusable component (src/components/navigation/NavDropdown.tsx).
• Navigation System Foundation:
  • Database Extension: Added description and metadata_json columns to navigation_items table.
  • Extended Types: Updated NavItem interface to support rich metadata for future navigation enhancements.

[0.4.79] - 2026-01-29

Fixed

• Legacy Cleanup: Removed obsolete backup and review files (AdminHeader.v0.4.73.review.tsx) to reduce codebase noise.
• Type Safety: Verified full project type safety following recent standardization efforts.
• Visual Polish: Fixed 1024px layout jump, synchronized admin alignment to 24px gutter, and centered breadcrumbs vertically.

Added

• Wiki-Style Editing (Beta): Implemented the architectural foundation for inline component editing.
  • Edit Mode: Global toggle via AdminEditContext.
  • Property Editor: New AdminEditModal for adjusting component density and padding.
  • Integration: AdminCard now supports a "Gear" trigger for rapid configuration.
• Internal Documentation:
  • CSS Strategy: Comprehensive architectural decision record (/admin/internal/architecture/css-strategy).
  • Architecture Hub: New index page (/admin/internal/architecture) organizing Database, CSS, and NavBar logic.

Known Issues

• Media Button Styling: The "Back" and "Settings" buttons on the Media Library page use a divergent style (rounded-xl) and may exhibit race-condition ordering against the new Edit button. Investigation completed; fix scheduled for next patch.

[0.4.78] - 2026-01-29

Changed

• UI Standardization: Completed the migration of all remaining Admin Hub pages to the standardized AdminPageContainer and AdminCard pattern.
• Breadcrumb Integration: Migrated breadcrumbs to AdminPageContainer for SEO Toolkit, Diagnostics, Testing, Design, System, Analytics, Newsletter, and Monetization hubs.
• Card System Adoption: Replaced inconsistent div containers with AdminCard across all admin pages, ensuring visual parity and better maintainability.
• Layout Precision: Standardized spacing, mobile gutters (2px), and header information hierarchies project-wide.
• Component Polish: Enhanced AdminCard usage with variant="inset" for tab bars and variant="dark" for technical documentation boxes.

[0.4.77] - 2026-01-29

Changed

• Header Architecture: Refactored the AdminHeader layout to move breadcrumbs out of the card and above it, solving persistent grid collisions.
• New Component: Introduced AdminBreadcrumbs, a standalone, accessible navigation component (nav ol li).
• Container Logic: Updated AdminPageContainer to handle breadcrumb rendering via a new breadcrumbs prop.
• Migration: Refactored the Database Architecture page (/admin/internal/architecture/database) to use the new pattern; established an incremental migration path for all admin pages.
• Stability: Deprecated internal breadcrumb rendering in AdminHeader to safely support both patterns during the transition.
• Wiki-Style Editing (Foundation): Laid the architectural groundwork for inline admin interface editing.
  • Context: Created AdminEditProvider and useAdminEditContext to manage global edit state.
  • Registry: Established src/config/admin-page-registry.ts to control edit button visibility per page.
  • Component: Introduced AdminCard component with registry support for future wiki-style customization.
  • Widgets: Designed a comprehensive "Widget Registry" for future dashboard customizability (Stats, Health Scores, Quick Links).

[0.4.76] - 2026-01-28

Changed

• Database Architecture Visualization: Refined the Proposed Database Architecture diagram (/admin/internal/architecture/database) with a fixed-width table layout (65px/145px/30px) and larger fonts (14px/12px) for perfect ERD alignment.
• Internal Documentation Strategy: Consolidated consolidation plan for internal/lizardware-specific reference pages into a unified internal_pages schema structure.
• Admin Pages Audit: Conducted meaningful audit of 53 admin pages to identify migration candidates for the new internal documentation system.

[0.4.75] - 2026-01-28

Added

• Floating Property Panels: Implemented a "True WYSIWYG" editing interface (FloatingPropertyPanel.tsx) that appears adjacent to the selected block in the preview.
  • Context-Aware: Dynamically positions itself relative to the block's bounding rectangle.
  • Design Tab: Real-time control over Padding, Max Width ("Horizon"), and Backgrounds ("Atmosphere").
  • Content Tab: Direct access to block-specific editable fields.
• Block Consolidation (Universal Architecture): introduced two powerful "Super Blocks" to replace legacy specialized components.
  • UniversalText: Consolidates Hero, GradientHero, CTA, and RichText into a single flexible component with variant switching.
  • SmartList: Consolidates FAQ, Testimonials, FeatureGrid, and UseCaseCards into a unified list engine with 4 layout variants (Grid, Cards, Accordion, Testimonials).
• Block Registry Upgrade: Updated BLOCK_REGISTRY to include the new universal blocks and reorganized the Block Library categories ("Essentials", "Marketing", "Specialized", "Legacy").
• Icon Picker 2.0: Completely overhauled the Icon Selection Modal (IconPickerModal.tsx) for a premium experience.
  • Smart Collections: Standardized 9 core collections (Featured, Essentials, Tech, etc.) with exactly 24 curated icons each.
  • Responsive Grid: Fluid layout scaling from 6 columns (desktop) to 2 columns (mobile) with persistent sidebar.
  • Visual Polish: Animated "breathing" search bar, formatted icon names (Align Justify), and refined button typography.
  • UX Enhancements: Keyboard navigation (Escape to close) and improved infinite scroll performance.

Changed

• Editor Sidebar: Removed the legacy "Block Properties" form from the sidebar, fully transitioning property editing to the new floating panel.
• Selection Logic: Updated BlockRenderer and InlineText to broadcast precise broadcast bounding box data (rect) to support floating panel positioning.
• Internal Documentation: Refined the Proposed Database Architecture diagram (/admin/internal/architecture/database) with a fixed-width table layout, larger fonts (14px/12px), and perfectly aligned columns for a professional ERD visual.

Fixed

• Admin Navigation Stability: Restored the "Gold Standard" staggered responsive collapse behavior for the Orbital Navigation bar.
  • Logic: Shortcuts (XL) -> Internal/Testing (LG) -> System (MD) -> Left Wing (SM) -> Hamburger.
  • Correction: Fixed regression where the primary "Left Wing" navigation (Content/Growth/Design) was hiding prematurely at 1024px instead of 640px.
  • Mobile Polish: Synchronized Shortcuts button visibility with System hub to prevent clutter on tablet viewports.

[0.4.74] - 2026-01-24

• Adaptive Layout System: Implemented flexible width presets (tight, narrow, standard, wide, extra-wide, full) using min(vw, px) logic to ensure consistent content bounding across devices.
• Enhanced Block Alignment: Added independent ctaAlignment for Hero and CTA blocks, and standardized horizontal padding in BlockRenderer to align with site navigation.
• Migration Conflict Resolution: Established a migrations/archive strategy to handle redundant column migrations (e.g., featured_image_id, meta_description, bio) which previously caused db:reset failures on fresh installs.
• Type Safety: Updated block types to support customMaxWidth and adaptive width presets, ensuring full TypeScript coverage.

[0.4.72] - 2026-01-24

Fixed

• Critical Data Safety: Corrected deploy-migrations.js logic that was unconditionally running blank.sql (destructive seed) on every deployment. This prevents data loss for existing installations.
• Admin Security: Implemented a "Setup Gate" in middleware. Access to /admin routes is now strictly blocked until the Setup Wizard is completed (verified via database state).
• Seed Content Repair: Fixed critical data integrity issues in Marketing, Restaurant, and Service seed files where missing Author definitions prevented blog posts from appearing.
• Seed Content Refinement: Standardized all generic business seeds (SaaS, Marketing, Service, Blog) to remove hardcoded CTAs from About pages. Refined SaaS copy to focus on individual software rather than operating systems, and permanently removed the redundant /features page. Verified all seeds use the blocks layout consistently.

All notable changes to Lizardware CMS will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[0.4.71] - 2026-01-24

Added

• Seed Image Strategy: Implemented a comprehensive strategy for including featured images in blog posts across all business types (SaaS, Marketing, Software Dev, etc.).
• Blog Seed Overhaul: Comprehensive update to the "Blog" business type:
  • Fixed navigation label from "Articles" to "Blog".
  • Corrected blog post dates to ensure they appear in the past.
  • Centered hero alignment on About page for better visual balance.
  • Replaced sparse homepage richtext with a structured "What I Write About" feature grid.
  • Refined Contact and Support pages to remove redundant CTAs and unnecessary whitespace.
• D1 Migration 120: Added featured_image_id column to the posts table to support featured images.
• Enhanced Seed Data:
  • Updated all 8 seed files with placeholder image metadata (using placehold.co) for immediate visual impact without bloating database storage.
  • Global Post Back-dating: Standardized all blog post dates across every business type (SaaS, Marketing, Software Dev, etc.) to the past (e.g., -1 to -28 days) to ensure a realistic and populated feel upon initial setup.
  • Added new sample blog posts to the "SaaS Product" business type.
  • Standardized INSERT statements to support new media-rich content structure.

[0.4.70] - 2026-01-24

Added

• System Resource Registry: Implemented a new registry component in the System Hub to track real-time status of Cloudflare resources (KV, D1, R2, GitHub) with synchronization indicators.
• System Registry API: Created /api/admin/system/registry endpoint for consolidated resource health monitoring.
• Admin Command Bar Global Actions: Added "Launch Site" and "Global Settings" buttons to the main Admin Dashboard for streamlined navigation.

Fixed

• Setup Wizard UX:
  • Restored dynamic border radius support by correctly setting the --border-radius CSS variable on the root element.
  • Reduced excessive vertical spacing across all wizard steps (Resource Check, Theme, Business Type, etc.) to optimize for laptop viewports.
  • Fixed "Execute Launch Sequence" button contrast by switching to a solid background and improved layout spacing.
• Typo Corrections: Globally renamed "Genetic Logs" to "System Logs" across navigation, changelogs, and documentation for professional consistency.

[0.4.69] - 2026-01-23

Changed

• Setup Wizard Polish:
  • Overhauled "Complete" step by removing redundant resource confirmation and renaming actions to focus on "View your site!" and "Visit Admin Command Dashboard".
  • Standardized all wizard descriptions to text-xs (12px) and widened containers (max-w-xl) for significantly improved readability and wrapping.
  • Implemented theme-aware "Step X of X" indicator using dynamic page-subtitle tokens.
• Theme Tropical Teal Rebranding: Renamed "Terminal Protocol" to "Tropical Teal" and transitioned its palette from muted slate/greys to vibrant mint and deep teal for high visual impact.
• Interactive UI Enhancements: Added premium scale-transform and glow effects to setup action buttons, ensuring tactile feedback and better user engagement.

Fixed

• Typography Alignment: Resolved vertical centering issues in setup action buttons using flexbox and zero-line-height techniques.
• Contrast Refinements: Brightened MSP Classic Dark and Tropical Teal text colors to eliminate "washed out" appearances and improve accessibility.

[0.4.68] - 2026-01-23

Changed

• Setup Description Polish: Increased font size and widened text constraints across all wizard steps to prevent premature wrapping.
• Theme Text Standardization: Updated multiple themes (MSP, Neon, Monolith) to use theme-colored body text instead of generic greys.

Fixed

• MSP Dark Contrast: Updated page text to Blue-200 for better visibility against dark backgrounds.

[0.4.67] - 2026-01-23

Added

• New Theme: Introduced "Traffic Cone Orange," a high-energy vibrant orange theme with building-grade visibility.
• Theme Ordering: Reorganized theme presets to place Traffic Cone Orange after MSP Classic.

Changed

• MSP Classic Reversion: Restored the light mode to its original professional navy/slate identity while keeping the signature orange accent for interactive elements.
• Neon Purple Refinement: Shifted the "Neon Purple" palette from fuchsia/pink to deep, electric purple across both light and dark modes.
• Improved Neon Buttons: Dark mode buttons in Neon Purple are now more purple and less pink, matching the overall neon aesthetic.

Fixed

• Light Mode Palettes: Removed "pastel" washed-out colors in MSP and Neon Purple themes, ensuring higher energy and visibility.

[0.4.66] - 2026-01-23

Added

• Design System Documentation: Authored a comprehensive border-radius-reference.md guide for developers.
  • Documents the 6-tier multiplier system (sm to 3xl).
  • Provides a complete calculation matrix across all 6 theme presets (Monolith Rose to Cloud Venture).
  • Establishes clear usage guidelines for popups, cards, and buttons.

Changed

• Setup Border Radius Integration: Refactored the entire setup wizard to integrate with the core dynamic border radius system.
  • Removed parallel --border-radius variable logic.
  • Replaced inline calc() styles with standard Tailwind rounded-* classes mapped to the theme base.
• Button Sizing Standardization: Unified button heights across all setup steps to a premium py-3 (12px) standard with consistent text-xs typography.
• Popup System Refinement: Enhanced AdminPopupProvider to be fully theme-responsive.
  • Fixed "pill-shape" distortion in extreme themes (e.g., Cloud Venture) by standardizing on rounded-lg (1.5x) to match info-card aesthetics.

[0.4.65] - 2026-01-23

Changed

• Setup Wizard Modularization: Completely refactored the massive Setup Wizard (/setup) by extracting step-specific logic into independent, type-safe components.
  • File Optimization: Reduced src/app/(setup)/setup/page.tsx from ~2000 lines to ~300.
  • Component Extraction: Created dedicated files for WelcomeStep, ResourcePrerequisitesStep, ThemeSelectionStep, BusinessTypeStep, SiteInfoStep, ReviewStep, and CompleteStep.
  • Shared UI: Centralized SetupIcons and CopyButton for better reusability.
• UI & Motion Standardization:
  • Unified all setup step entry animations to a standard slide-in-from-bottom-4 motion pattern.
  • Standardized form labels with consistent typography (text-[10px] font-bold uppercase tracking-widest text-zinc-500).
  • Balanced vertical spacing (space-y-6) across all setup screens for a more cohesive experience.
• Type Safety Hardening: Eliminated generic any casts in setup-related API responses and theme preset handling.

[0.4.64] - 2026-01-21

Changed

• Dev Environment Polish: Updated the dev environment banner to intelligently detect storage mode (Wrangler vs. JSON Fallback) and display accurate status messages.
• Setup UI Polish: Enhanced the "Get Started" button with a vivid gradient and improved glow effects for better visibility in light/dark modes.
• Documentation Audit: Archived 40+ stale documentation files and reorganized .ai.docs structure.
• Template Sanitization: Hardened template synchronization script (.future-dev blacklist, strict log wildcards, built-in edge runtime check).

[0.4.63] - 2026-01-21

Added

• Security Hub: New Security & Sessions dashboard (/admin/system/security) for managing authentication policies.
  • Freshness Control: Configurable "Freshness" requirement (default: 60 mins) for sensitive operations (/setup, System Settings).
  • Session Duration: Adjustable admin session timeout (30 minutes to 14 days).
  • Live Monitoring: Real-time session age display with stale session warnings.
• Orbital Nav Update: Added direct access to "Security & Sessions" under the System hub gear icon.
• Edge-Safe Auth: Implemented lightweight, runtime-agnostic JWT decoding for high-performance edge middleware.

Fixed

• Settings Robustness: Implemented "Upsert" logic for security settings API to ensure configuration persistence even on fresh installs with missing config rows.

[0.4.62] - 2026-01-21

Changed

• Setup Auth Flow: Enhanced security by enforcing authentication during Setup.
  • Existing Users: If admin users exist, the wizard now redirects to /admin/login (or Clerk) instead of showing the creation form.
  • Freshness: Added "Fresh Session" requirement to the Setup Wizard to prevent stale session access.
  • Clerk Integration: Fully aligned redirect logic with Clerk's external authentication flow.

[0.4.61] - 2026-01-21

Added

• Live Preview Block Controls: Implemented "True WYSIWYG" block manipulation controls directly within the preview iframe.
  • Floating Toolbar: Dedicated controls for Move Up/Down, Duplicate, Delete, and Settings appear on block hover/selection.
  • Premium UI: Controls are positioned top-left with a primary-colored glow effect for high visibility.
  • Direct Settings Access: "Gear" icon instantly opens the block's property panel in the sidebar.
• Iframe Bridge: Enhanced postMessage architecture to handle complex block manipulation events (BLOCK_MOVE, BLOCK_DUPLICATE, BLOCK_DELETE) directly from the preview context.

Changed

• Sidebar Cleanup: Removed the legacy "Layers" tab and redundant block manipulation buttons from the sidebar, favoring the direct manipulation model.
• Visual Feedback: Added active state scaling and opacity transitions to block controls for a snappier feel.

[0.4.60] - 2026-01-21

Added

• True WYSIWYG Architecture: Implemented Option A (In-Preview ContentEditable) foundation for the Page Builder.
• Preview Bridge: Established postMessage communication between iframe preview and editor state for real-time content sync.
• Inline Editing: Enabled contentEditable for Hero, GradientHero, Testimonial, and CTA blocks.
• Block Migrations: Created an automated migration system to handle data model refactors (implemented for ComparisonMatrix).

Fixed

• Comparison Matrix: Completely refactored the data model to use keyed cells (Record<string, string>) instead of positional arrays, preventing data loss when columns are reordered or deleted.

[0.4.56] - 2026-01-20

Added

• Block Persistence: Implemented revalidatePath in Admin API to ensure page updates bypass cache immediately.
• Roadmap: Added v0.6.0 goal to eliminate Tailwind CSS in favor of custom modules.
• Block Builder 2.0: Enabled array/list editing for 7 major blocks (faq, comparison-matrix, feature-grid, etc.) with recursive field rendering.

Fixed

• Block Styles: Unlocked ComparisonMatrix implementation to respect Global Style settings (Background/Width).
• Preview Engine: Identified circular dependency causing preview sync failures (Fix documented in Handoff).
• Block Properties: Resolved build error and implemented recursive field rendering for complex block types.
• Type Safety: Corrected strict type errors in testing/page.tsx and BlockProperties.tsx.

[0.4.55] - 2026-01-18

Added

• Official Business Preset: Finalized the "Lizardware Official" business type (lizardware-official) with comprehensive feature page content.
  • Feature Pages: Restored and enriched 6 key feature pages (Content, Theme, Publishing, Dev, Perf, Security) with premium block layouts.
  • Seed Content: Updated lizardware-official.sql to include high-fidelity content, icons, and gradient hero blocks.
• Testing Hub Update: Added v0.4.55 milestone to /admin/testing to track this release.

Fixed

• Feature Page Rendering: Resolved issue where feature pages were not rendering correctly by ensuring layout_id='blocks' is set in seed data.
• Database Bundle: Re-bundled migrations to ensure install-sql.ts reflects the latest seed updates.

[0.4.54] - 2026-01-16

Added

• New Documentation Guides: Added comprehensive guides for Content Management, Theme Customization, End-Users, and Troubleshooting to docs-content.ts.
• Support Section: Introduced a dedicated Support category in the documentation index (/docs) for easier troubleshooting.

Changed

• Quick Start Overhaul: Rewrote the Quick Start guide to focus on a "Zero-Config" GitHub Fork workflow.
  • Added explicit Cloudflare deployment steps and resource verification details.
  • Included deployment time expectations (2-4 minutes) and "Smart Login" guidance.
• Documentation Index: Redesigned /docs index with a cleaner category-based hierarchy (Getting Started, Setup & Platform, Advanced Usage, Support).
• Slug Standardization: Unified documentation slugs by removing redundant prefixes for all new guides.

Fixed

• JSX Syntax Handling: Fixed unescaped character errors in documentation screenshot placeholders.

[0.4.53] - 2026-01-16

Added

• CTA Block Implementation: Added the missing Cta.tsx block to the registry, resolving "Unknown Block type: cta" errors.
  • Supports title, text, button configuration, and center/left alignment.
• Universal Block Styling: Enabled styleOptions (Background, Padding, Max Width) for all major blocks in the registry.
  • Editors can now select "Primary", "Secondary", "Alternate", or "Transparent" backgrounds for any block section.
  • Included Hero, FeatureGrid, RichText, FAQ, Testimonial, ComparisonMatrix, and more.

Changed

• 100% Seed Styling Parity: Enhanced all 7 business presets (lizardware-official, marketing, blog, restaurant, service, software-dev, and blank) with the new visual system.
  • Visual Rhythm: Applied alternating background colors and consistent vertical padding to create high-end marketing layouts for every business type.
• Route Maintenance: Cleared stale Next.js type cache to resolve phantom errors from previous route renames.
• Documentation: Created comprehensive handoff for legal page restoration, detailing the strategy for replacing placeholder content with business-specific legal text.

[0.4.52] - 2026-01-16

Fixed

• Template Variable Rendering: Fixed {{siteName}} and {{siteDescription}} not replacing on initial page load due to SSR hydration issue.
  • Updated BlockRenderer to accept server-side config via props, prioritizing SSR values over client-side hook.
  • Modified PageRenderer and LivePreviewWrapper to pass site config from server to ensure variables render correctly.
• Navigation Centering: Fixed navigation links appearing slightly right of center in header.
  • Updated grid layout to grid-cols-[1fr_auto_1fr] for balanced columns.
  • Added justify-self-start to logo, justify-self-center to nav, and justify-self-end to theme toggle for perfect alignment.
• Pages Playground: Fixed 404 error when clicking "Create New Page" button.
  • Corrected route from /admin/content/pages/new to /admin/editor/page/new to match unified editor structure.
• Database Setup: Fixed "duplicate column" errors during fresh database initialization.
  • Patched migrations 113, 117, and 119 to handle redundant schema changes safely.
• Admin Editor: Fixed 404 errors when editing pages with nested slugs (e.g., features/content-management).
  • Upgraded editor route from [slug] to catch-all [...slug] to support hierarchical content paths.
  • Updated API route api/admin/pages to support nested slug operations (GET/PUT/DELETE).

[0.4.51] - 2026-01-16

Added

• Global Seed Enrichment: Transformed all business type presets into launch-ready templates.
  • Block-First Architecture: Converted Home, About, and standard content pages across all seeds to use layout_id='blocks'.
  • Core Page Additions: Injected missing Privacy, Terms, Support, and Contact pages with tailored placeholder blocks for every business type.
  • Official site Mastery: Finalized lizardware-official.sql with premium gradient heroes, feature matrices, and full support/legal pages.
• Enhanced Positioning: Refactored OrbitalNav centerpiece to use absolute centering, fixing "drifting" action buttons on unbalanced navigation bars.

Changed

• Home Page Standardization: Unified home_page_slug to 'home' project-wide (Seeds + Logic), eliminating routing discrepancies between business types.
• Navigation Content Restoration: Audited and corrected navigation structures for all business types during setup.
  • Blog Fix: Resolved critical issue where the "Personal Blog" preset had no navigation items.
  • Marketing Enhancement: Added a complete 2-tier navigation structure (capabilities, blog, about, pricing) to the marketing/official preset.
  • Dynamic Flags: Navigation items now correctly respect module feature flags (Blog, Changelog) during initial seeding.

[0.4.50] - 2026-01-16

Changed

• Seeded Data Enrichment:
  • Taxonomy Defaults: Added default blog categories ("Engineering", "Product", "Tutorials", etc.) to all relevant business types.
  • SEO Meta Defaults: Integrated default meta_description and home_page_slug configurations into all seed SQL files to ensure perfect SEO out of the box.
• Business Type Configurations:
  • Restaurant Module Alignment: Enabled the "Blog" feature by default for the Restaurant preset to support "News & Events" updates.
  • SQL Cleanup: Removed redundant page definitions and duplicate logic in lizardware-official.sql.

[0.4.49] - 2026-01-16

Added

• Global Layout Control: Implemented "Site Max Width" setting in Visual Identity (/admin/design/identity).
  • Range Slider: Granular control (1024px - 1920px) over the maximum width of the site's main container.
  • Dynamic Theme Variable: Updates --site-max-width CSS variable in real-time via ThemeConfig.
  • Universal Application: Automatically applies to Header, Blog, Standard Pages, and Admin wrapper.
• Deep Linking Engine: Enhanced Accordion and OrbitalNav to support direct ID linking.
  • Auto-Open: URLs with hashes (e.g., #layout-structure) now automatically open the target accordion and scroll it into view.
  • Nested Navigation: Added "Layout & Style" usage shortcut to the Design Hub navigation with indentation logic.

Changed

• Content Readability: Added max-w-4xl constraints to StandardPageLayout text containers to prevent line-length issues on ultra-wide screens.
• Admin Nav: Refined "Visual Identity" dropdown structure with nested "Layout & Style" item for faster access.

[0.4.48] - 2026-01-15

Changed

• Orbital Navigation Polish: Implemented persistent color branding and visual refinements for the main admin navigation.
  • Persistent Colors: Hub dropdowns (Content, Growth, Design, System) now retain their branded colors (Purple, Green, Sky, Orange) persistently, not just on hover.
  • Specialized Branding:
    • Testing Hub: Updated to Yellow branding for high visibility.
    • Internal Hub: Updated to Monochrome (White/Zinc) branding with "🦎 Internal" formatting.
    • Design Hub: Enhanced contrast by using sky-600 for both active and hover states.
  • Hub Labels: Increased prominence of "Hub" links inside dropdowns with vibrant gradients and larger text.
• Mobile Navigation: Achieved 100% visual parity with desktop changes, ensuring correct color coding and conditional visibility for Internal/Testing sections.

[0.4.47] - 2026-01-14

Changed

• Header Intelligence: Standardized AdminHeader widget architecture across Design and System hubs.
  • System Advanced: Migrated custom health indicators to the unified <HealthScoreWidget> component, aligning visual language with other hubs.
  • Design Hub: Introduced "Design System Health" widget to the Design Hub index.
• Widget Consistency: Verified and solidified the "Dashboard Widgets" pattern (Center: Health/Stats, Right: Actions) across all admin surfaces.

[0.4.46] - 2026-01-14

Changed

• Admin Command Bar: Completed the standardization of AdminCommandBar across the entire admin suite.
  • Replaced legacy labelCollapse props with standardized buttonType ("back", "settings", "launch") in System, Content, Growth, Design, and Testing hubs.
  • Ensured "Launch Site" buttons use the correct variant="ghost" and buttonType="launch" for consistent styling.
  • Verified all command bars follow the gold-standard 3-zone layout (Left: Navigation, Center: Actions, Right: Launch).

[0.4.45] - 2026-01-14

Changed

• Header Standardization: Reverted SEO Health Widget to compact design and standardized Right-Quarter widgets across all updated pages to the 3-pill gold standard pattern.

Added

• Global Header Enrichment: Successfully migrated all remaining high-priority admin pages to the standardized AdminHeaderWidget system.
• Hub Optimization: Migrated "Quick Stats" from the main body of Content, Design, and Growth hubs into the centerWidget using a high-density matrix layout.
• Testing & SEO Integration: Integrated complex status tracking (Active Testers, Health Scores, System Phase) directly into the header, reducing vertical eye travel.
• System Stability Indicators: Added live D1/R2 storage provider manifests and runtime environment tracking to the System Hub.
• Secondary Detail: Updated Blog Authors and Categories with "Broadcaster Registry" and "Taxonomy Mode" status widgets.
• UX Refinement: Removed redundant secondary status cards and grids project-wide, achieving a cleaner "Single-Zone" information hierarchy.

[0.4.44] - 2026-01-14

Added

• AdminHeaderWidget Component: Introduced a standardized system for status indicators (pills/badges) with support for icons, dynamic variants (success, info, warning, danger), and pulsing animations.
• Architecture: Extended AdminHeader with widgets (pills) and centerWidget (custom content) props to centralize page-level status reporting.
• Prototyping: Successfully migrated Analytics, SEO Redirects, and Pages Playground to the new widget architecture.

[0.4.43] - 2026-01-14

Added

• Final Hub Standardization: Completed the migration of remaining complex pages to the AdminCommandBar pattern, achieving true 100% coverage.
  • Growth Hub: Migrated GrowthIndex (/admin/growth).
  • Design Hub: Migrated VisualIdentity (/admin/design/identity).
  • Content Hub: Migrated PagesManager (/admin/content/pages) and Changelogs (/admin/content/changelogs).
• Legacy Cleanup: Removed all remaining useAdminActions legacy hooks and AdminHeader badge/action props from the migrated pages.
• Badge Audit Task: Added roadmap item to audit preserved badge props (e.g., Analytics status) for future Phase 2 header enhancement.

[0.4.42] - 2026-01-14

Added

• Staggered Responsive Collapse: Extended CommandBarButton to support lg, xl, and 2xl breakpoints for sophisticated overlapping prevention on dense pages.
• Layout Standardization: Migrated Newsletter, Pages, SEO, and System Config to the AdminPageContainer component, ensuring consistent 2px mobile gutters and page margins.
• Consistency Polish: Standardized "Launch Site" button behavior and button collapse priorities across major hub pages.

[0.4.41] - 2026-01-14

Added

• System Hub Completion: Finalized the 3-zone AdminCommandBar migration for all remaining system pages.
  • Standardized Pages: Config, Logs, Updates, Roadmap, and Changelog.
  • Three-Zone Layout: Enforced Left (Back/Settings), Center (Primary Actions), and Right (Launch Site) pattern.
  • Explicit Navigation: Migrated all back buttons to use window.location.href or hardcoded router paths for navigation reliability.
• Global Coverage: Achieved 100% completion (40/40 pages) for the Admin Navigation Standardization Phase 1.

Changed

• AdminHeader Simplification: Removed actions and badge props project-wide from AdminHeader components, aligning with the new streamlined navigation strategy.
• Sitemap Clarification: Verified that /admin/growth/seo/sitemap is a dynamic root route and does not require a dedicated admin UI page, marking the Growth Hub as 100% complete.

[0.4.40] - 2026-01-14

Added

• Advanced Blog Management: Achieved full feature parity with Media Library.
  • Bulk Operations: Multi-select mode for batch capabilities (Publish, Draft, Delete) via floating action bar.
  • Grid Architecture: Responsive 4-column grid layout for blog posts with unified card design (rounded-3xl on desktop).
  • Search & Filter: Full-text search (Title, Slug, Excerpt) integrated into orbital bar with Author and Sort filtering.
• Orbital Navigation Refinements:
  • Smart Collapse: Search bar now intelligently resizes to 50% width on tablet viewports to prevent layout breaking.
  • Conditional Actions: "Launch Site" button auto-hides when contextual actions (Bulk Select) are active to reduce clutter.
  • Portal Architecture: Implemented Right-Wing portal target in OrbitalNav for dynamic action injection.

Changed

• Visual Consistency: Unified BlogList and MediaLibrary card backgrounds (bg-zinc-50 dark:bg-zinc-900/50) and orbital action bar styles (whitespace-nowrap).
• Responsive Logic: "Data Source" labels now collapse earlier (lg:block) to preserve single-row toolbar layout on tablets.
• Navigation Standardization: Massively progressed migration of legacy "Back" buttons to AdminCommandBar, achieving 100% completion for Testing Hub and 90%+ for Growth/Design Hubs.
  • Explicit Paths: All back buttons now use hard-coded routes (e.g., /admin/growth) instead of browser history.
  • Launch Site: Added "Launch Site" button to the right portal on all migrated pages.
  • Responsive: Implemented labelCollapse prop for optimized mobile spacing.

[0.4.39] - 2026-01-14

Added

• AdminPageContainer: Introduced a standardized page container component to manage responsive gutters and layout architecture.
  • Layout Neutralization: Implemented a built-in "breakout" logic to counteract parent layout padding on mobile, ensuring full-width content capability without manual hacks.
  • Standardized Gutters: Established a default 2px mobile gutter for all migrated admin pages, providing a premium floating card aesthetic.

Changed

• Media Vault Layout Refactoring: Migrated the Media Library page to the new AdminPageContainer system.
  • Negative Margin Elimination: Removed heavy-handed -mx-3.5 and w-[calc(100%+1.75rem)] hacks from page-level code.
  • Polished Corners: Restored consistent rounded-3xl aesthetic globally on mobile.
• Blazing Blogger Layout Refactoring: Migrated the Blog management page to the new AdminPageContainer system.
  • Component Decoupling: Refactored BlogList to remove internal layout hacks, allowing it to function as a clean, reusable component inside the standardized container.
  • Card Aesthetic: Standardized blog post cards with rounded-2xl on mobile and rounded-3xl on desktop.
• Storage UI Polish:
  • Unified Aesthetics: Consolidate storage provider text into badges (e.g., R2 CLUSTER) for cleaner layout.
  • Visual Harmonization: Aligned icons and colors between the Storage Status Bar and Filter Bar (Orange=R2, Green=Cloudinary, Blue=D1).
  • Layout Stability: Fixed status bar width shifting and text wrapping issues.

Fixed

• Type Safety: Verified all layout transitions and container props with a full project type-check.

[0.4.38] - 2026-01-13

Added

• Responsive Admin Layout: Major layout update for Media Library to support full-width rendering on mobile/tablet devices.
  • Full-Width Logic: Removed horizontal constraints (px-6) on small screens, allowing content to bleed to edges for maximum density.
  • Flat Design: Admin cards now seamlessly flatten (rounded-none, border-x-0) on mobile viewports while retaining their floating aesthetic on desktop.
• Orbital Navigation Physics:
  • Grid Architecture: Migrated Orbital Bar to a 3-column Grid layout for mathematically perfect button centering.
  • Intelligent Collapse: Delayed Top Navigation collapse until md (768px) breakpoint to better support tablets.
  • Priority Visibility: Optimized "Back" button to collapse label earlier than "Settings" button to prevent overlap.

Changed

• Media Library UX: Refined button placement and spacing in the orbital action bar.
• Orbital Filters: Refined flex behavior to maintain a unified toolbar row on intermediate devices (up to 1024px), preventing jumping and search bar displacement by centering the search on a dedicated second row.
• Blazing Blogger Design: Applied responsive full-width layout to the blog management interface, standardizing mobile card presentation and migrating actions to the orbital navigation system.

[0.4.37] - 2026-01-13

Added

• Media Library 2.0: Comprehensive overhaul of the digital asset management system in preparation for Beta.
  • Tagging System: Full support for organizing assets with custom tags (e.g., "nature", "banner").
  • Bulk Operations: Multi-select mode for batch tagging (Add/Remove/Overwrite) and efficient asset management.
  • Metadata Editor: Side-panel in Preview Modal for updating Alt Text, Captions, and Tags without re-uploading.
  • Smart Filtering: New "Orbital" filter bar with Tag Filters and Sorting controls (Date, Name, Size).
  • Unified Picker: Refactored MediaPickerModal to use the full MediaLibrary engine, bringing advanced filtering and upload capabilities to the Editor.
• Unified Image Editing: Integrated powerful in-line image manipulation directly within the block editor.
  • In-Line Controls: Floating toolbar for instant alignment, resizing, and rotation adjustments.
  • Visual Filters: Real-time controls for Brightness, Contrast, and Grayscale toggling.
  • Live Preview: WYSIWYG rendering of all image properties in the editor canvas.
  • Smart Resizing: Preset width controls (25%, 50%, 75%, 100%) for rapid layout adjustments.
• Media Integration:
  • Asset Picker: "Select from Library" button in Block Properties opens the new MediaPickerModal.
  • Direct Updates: New onUpdateBlock architecture allows blocks to self-mutate without full editor re-renders.

Fixed

• Admin Layering: Resolved Z-Index conflicts by porting MediaPickerModal and VariableInserterModal to createPortal (rendering at body root).
• Block Registry: Reordered and expanded the image block definition with comprehensive default props for new filters.
• Database Schema: Added tags JSON column to media table via migration 119.

[0.4.36] - 2026-01-13

Added

• Storage Status Intelligence:
  • Live Provider Badges: Media library now displays highly visible badges ([ R2 ], [ DB ]) indicating the active storage source.
  • Context-Aware Feedback: Storage quota bar now intelligently reports "Showing X assets in [Provider]" based on active filters.
  • Deep-Link Integration: Unconfigured storage providers in the status bar now offer direct "Configure ->" links that teleport to the System Forge.
• Advanced Settings Navigation:
  • Teleportation Engine: URL-based deep linking (?section=storage&highlight=r2) that automatically expands accordions and highlights specific configuration targets.
  • Visual Beacons: Added pulsing ring highlights to draw attention to deep-linked settings.

Fixed

• Usage Stats API: Implemented graceful fallback for unconfigured providers (e.g. R2) to prevent 500 errors and allow UI "Unavailable" states.
• Provider Normalization: Standardized storage provider identifiers (r2 vs Cloudflare R2) to ensure consistent UI badge rendering.
• Deployment: Fixed D1 massive transaction timeout by implementing incremental migration executor.
• Deployment: Fixed missing navigation in fresh installs by seeding blank canvas data after migrations.
• Deployment: Made R2 bindings optional by removing r2_buckets section when R2 is not configured.
• Blog: Fixed missing thumbnails in public blog cards and post pages by allowing direct featured image URL usage.

[0.4.35] - 2026-01-13

Added

• Media Vault Settings: New sub-modal in Media Library for managing vault-specific configuration.
  • Vault Naming: Ability to set a custom display name for the Media Library.
  • Provider Centralization: Integrated selection of the default storage provider (D1, R2, Cloudinary, Local).
• Strategic Storage Deep-Linking: Implemented a "Teleportation" system for storage infrastructure.
  • Clicking "Configure" on unprovisioned storage options now navigates directly to the System Forge.
  • Auto-Expansion: Automatically opens the "Media Logistics" accordion on arrival.
  • Visual Beacon: Highlights the target configuration section with a distinct glowing ring.
• Enhanced Responsive UI:
  • AdminHeader: Redesigned for fluid stacking on tablet and mobile viewports.
  • Orbital Filters: Minimized the search toggle and "Launch Site" buttons on narrow screens to maximize filtering real estate.
  • Search UX: Search input now expands on-demand via a focused icon toggle on mobile.
• Media Preview/Edit Refinements:
  • Reset Button: Added a dedicated "Reset" trigger to revert all visual adjustments (rotation, brightness, contrast, grayscale) to default states.
  • Desktop Layout Refactoring: Moved the editor panel to the bottom of the modal in a wide 3-column grid, maximizing the image canvas area.
  • Scroll Management: Implemented a global body-scroll lock when modals are active to prevent background page drifting.
  • Mobile Layout Optimization: Redesigned the preview modal with a fixed-height canvas and scrollable control sidebar for significantly improved usability on small devices.

Fixed

• Media Library Icons: Corrected a ReferenceError by adding the missing HardDrive icon import.
• Storage Quota Precision: Refined the usage bar visuals and text alignment for improved readability on small screens.

Fixed

• Setup Wizard Authentication: Resolved "Unexpected token '<'" error by whitelisting setup-related API routes (/api/admin/check-kv, /api/admin/setup/*) in middleware.ts.
  • Prevents public setup calls from being redirected to the HTML login page.
• R2 Provisioning Template: Added missing R2 binding configuration to scripts/wrangler.template.jsonc.
  • Ensures dynamic R2 bucket names are correctly injected during GitHub Actions deployment.
• Production Build Workflow: Corrected understanding of wrangler.jsonc generation in CI/CD pipeline (uses generate-wrangler-config.js + template, not init-config.js).

[0.4.33] - 2026-01-12

Fixed

• Edge Runtime Bundling: Isolated internal dependencies in API routes using dynamic imports, resolving OpenNext build errors.
• D1 Migration Stability: Implemented Schema Consolidation for Media tables, fixing SQLITE_ERROR: no such column: file_size during fresh installations.
• Table Rebuild Strategy: Deprecated destructive migration patterns in favor of consolidated base schemas.
• Production CI/CD: Fixed serverExternalPackages configuration for better compatibility with Cloudflare Workers runtime.
• Dev Mode API Compatibility: Relaxed Edge Runtime constraints on bulk operations to enable filesystem fallbacks in development.

[0.4.32] - 2026-01-12

Added

• Unified Categorization System: Integrated categories for both Pages and Blog Posts.
  • New CategorySelect component for consistent admin UI.
  • API support for fetching and managing classifications across all content types.
• Enhanced Pages List:
  • Category Filtering: Added classification dropdown to filter pages by category.
  • Visual Badges: Content cards now display color-coded category labels.
  • D1 Integration: Database schema updated (migrations/115) to support page-to-category relationships.
• Environment Parity:
  • Implemented graceful fallbacks for categories in DEV mode when D1 is uninitialized.
  • Added type-safe media usage auditing to prevent breaking links when deleting assets.

Fixed

• Type Safety: Resolved multiple unknown type errors in admin media APIs and components.
• Consistency: Unified classification terminology across the entire administrative suite.

[0.4.31] - 2026-01-12

Added

• Storage Quota System: Implemented D1 Media Storage safeguards to prevent Free Tier exhaustion.
  • Soft Limit (100MB): Triggers "Upgrade Recommended" warnings in UI.
  • Hard Limit (125MB): Rejects new uploads to protect database health.
  • Dynamically calculates usage based on blob size.
• Storage Usage UI: Added visual progress bar to Media Library sidebar.
  • Shows current usage vs 100MB Display Limit (e.g., "45.2MB / 100MB").
  • Visual Feedback: Green (<50%), Yellow (50-70%), Amber (70-85%), Red (>85%), Pulsing Red (>100% "Over Limit").
• Usage Stats API: Added /api/admin/media/usage-stats endpoint.

[0.4.30] - 2026-01-12

Added

• D1 Database Storage: Implemented "Zero-Config" media storage using Cloudflare D1.
  • Images are stored as binary blobs directly in the database (media_blobs table).
  • Automatically used as the fallback provider in Production if R2/Cloudinary are not configured.
  • Includes max file size limit (5MB) to protect database health.
• Blob Serving API: Added /api/media/blob/[id] endpoint to serve images directly from D1 with proper caching headers.
• Admin UI: Added "D1 Database" option to Advanced Settings -> Media Storage selector.

[0.4.29] - 2026-01-12

Fixed

• Dev Server Performance: Implemented Request Memoization (React cache) for key data-fetching functions to deduplicate filesystem reads.
• Console Noise: Silenced verbose logs from Cloudflare/Navigation libraries in development.
• Preview Redirect Loop: Fixed infinite redirect to /setup in Preview environment.
• Media Storage Error: Resolved "No provider available" error in Dev with LocalStorage provider.

Added

• Local Media Security: Implemented public/media/dev-uploads/ strategy for safe local testing.
  • Development uploads are namespaced to dev-uploads.
  • Added .gitignore rules to exclude dev-uploads.

[0.4.28] - 2026-01-10

Changed

• R2 Provisioning Logic: simplified the on-demand R2 setup by making CF_PROJECT_NAME optional and implementing robust bucket existence checks.
  • Added checkR2 function to provision-cloudflare.js to verify bucket existence via Cloudflare API.
  • Improved error logging to distinguish between optional skips and permission failures.
  • System falls back to default project name (lizardware-cms) if none provided.
• Auto-Provisioning: Aligned initial setup wizard with simplified variable requirements.
• System Token API: Updated /api/admin/setup/check-system-token to return default project name when env vars missing.

Added

• Config Verification: New scripts/verify-bindings.js script to validate wrangler.jsonc bindings (KV, D1, R2) in CI/CD pipelines.
• Database Migration: Added migrations/114_fix_media_schema.sql to resolve schema desync on existing production databases (adds original_filename, size_bytes, etc.).

Fixed

• CI/CD JSON Parsing: Suppressed console warnings in provision-cloudflare.js when running with --json flag to prevent jq errors in GitHub Actions.
• Production Uploads: Resolved "D1_ERROR: table media has no column named original_filename" by aligning production schema with codebase.
• Cloudflare Variable Verification: Confirmed CF_PROJECT_NAME is a custom project-level variable.

[0.4.27] - 2026-01-10

Added

• Media Library UI: Drag-and-drop file upload interface with visual feedback for upload progress and deletion confirmations.
  • Grid-based gallery view with responsive layouts
  • Loading states and refresh functionality
  • Integration with R2 backend API endpoints (/api/admin/media/*)
• Editor Integration: Seamless media selection within content editors.
  • Blog/Page Editor: Featured image selection via MediaPickerModal with live preview
  • Rich Text Editor: New ImageInserterButton component for inserting images directly into content
  • Inline image insertion support for Tiptap editor
• Visual Identity Integration: Logo upload functionality connected to R2 storage.
  • File size validation (2MB max for logos)
  • Loading states and success feedback
  • Immediate preview updates

Security

• Server-Side Validation: Critical security hardening for production deployment.
  • File size enforcement (10MB max) to prevent storage cost attacks
  • MIME type whitelist (images, videos, PDFs) to block malicious file uploads
  • R2/D1 rollback mechanism to prevent orphaned files on database insert failures
  • Error message sanitization in production (prevents internal implementation disclosure)

Changed

• MediaPickerModal: Updated to use new R2 API structure with camelCase properties (altText, createdAt)
• MediaAsset Interface: Standardized across all components for type consistency

Value: Complete R2 media storage integration with production-grade security controls. Users can now upload, manage, and embed media assets throughout the CMS with confidence.

[0.4.26] - 2026-01-10

Changed

• Setup Wizard Density: Aggressively compacted the setup wizard UI to ensure a single-screen experience on 1080p desktop displays without scrolling.
  • Layout: Removed min-h-screen viewport forcing, allowing the wizard to naturally fit within the available space between headers/footers.
  • Vertical Centering: Restored perfectly balanced vertical centering by converting the main container to a flex column.
  • Create Admin Step: Significantly condensed headers, inputs (py-1.5), and internal margins to eliminate scroll triggers.
  • Status Window: Replaced large empty voids with a tighter, high-density layout for status indicators and success messages.
• Admin Layout: Fixed AdminHeaderHider to allow specific routes like /setup to control their own vertical expansion behavior.

[0.4.24] - 2026-01-10

Changed

• Content Navigation: Renamed "Blog Dashboard" to "Blazing Blogger" across the admin interface to align with new branding.
• Orbital Hierarchy: Implemented hierarchical nesting in the main navigation. Child items (e.g., "Categories", "Traffic Control", "System Logs") now appear indented with a ↳ symbol under their parent hubs.
• Navigation Regrouping: Relocated the Design Hub to the left-aligned "Creative Wing" alongside Content and Growth, leaving the right wing dedicated to System and Testing infrastructure.
• Content Hub: Updated the Content Hub (/admin/content) section cards to reflect the new "Blazing Blogger" branding and real-time media counts.

Fixed

• Admin Popups: Fixed popup.success() and popup.error() methods to accept optional options parameter, resolving "cannot read properties of undefined (reading 'duration')" error when creating authors.
• Homepage Fallback: Corrected JSX syntax errors in the root landing page that were causing TypeScript compilation failures.
• Header Navigation: Prevented navigation items from wrapping to multiple lines when using longer site names by:
  • Adding whitespace-nowrap to site name and all navigation links
  • Reducing gap between nav items from 48px to 16-24px (responsive)
  • Expanding header container width from 1024px to 1280px (max-w-7xl)
  • Centering navigation items for balanced layout
• Unified Editor: Optimized toolbar by surfacing Underline, Strikethrough, and Inline Code options; fixed WYSIWYG line-break rendering consistency.
• Setup Wizard: Overhauled the /setup experience for desktop with increased information density, refined typography, and scaled-down components.

[0.4.23] - 2026-01-10

Changed

• Admin Modals: Standardized all system popups (MediaPicker, VariableInserter, ShortcutsHint, Settings, Confirmation) to a compact, top-aligned "High-Density" design language.
  • Positioning: Moved from center-screen to top-third (pt-32 or pt-20) to reduce eye travel on desktop.
  • Density: Reduced padding, font sizes (text-[8px] labels), and input heights for maximum information density.
  • Z-Index: Unified layer stacking to z-[9999] to ensure modals float above fixed headers/navs.
• Route Picker: Drastically compacted the route selection component used in the Navigation Editor to fit within the new high-density modals.
• Media Library: Enabled the Media Library feature across the admin interface (nav link and hub card) by removing arbitrary feature flag gating.

[0.4.21] - 2026-01-10

Added

• Analytics Module: New dedicated dashboard at /admin/growth/analytics supporting Google Analytics, Plausible, and custom scripts.
• Newsletter Module: Full subscriber management system (/admin/growth/newsletter) with database storage, CSV export, and manual entry tools.
• Nav Editor Enhancements: Added "Add New Nav Button" workflow, restored RoutePicker, and enabled click-to-edit on all items.

Changed

• Testing Hub: Converted the Testing Hub (/admin/testing) into a toggleable feature module, disabled by default to prevent leaking into template/production builds.
• SEO Dashboard: Replaced "Analytics Coming Soon" placeholder with operational link to the new Analytics module.
• Navigation UX: Fixed "ghost item" bug by ensuring new items are only persisted upon explicit confirmation.
• Admin Dashboard: Simplified Data Matrix to show only essential metrics (Pages, Blog Posts, Media) to prevent header bloat.
• Template Sync: Enhanced scripts/sync-template.js to preserve local node_modules during cleanup, preventing 3+ minute reinstalls after syncs.

Fixed

• Content Hub: Corrected the "Custom Pages" metric which was stuck at 0 due to API response structure mismatch.
• Recent Activity: Fixed 404 errors on dashboard activity links by updating them to point to the Unified Editor (/admin/editor/...) using slugs.
• System Hub: Resolved 404 errors for /admin/system/logs (missing page) and /admin/system/roadmap (missing content in template builds).
• Cleanup: Permanently removed the deprecated "Services" module flags and database entries.
• Navigation Editor: Restored missing <button> tag in nav editor that was causing build failures.
• Migration Sequencing: Fixed migration 107 to add home_page_slug column before attempting to update it, preventing SQLITE_ERROR in fresh deployments.
• Template Deployment: Ensured database schema changes are self-contained and execute correctly in template repositories.
• Build Stability: Resolved multiple TypeScript "unknown" type errors and missing type definitions in Admin and Setup pages, ensuring successful production builds.

[0.4.20] - 2026-01-09

Fixed

• Upgrade Path Restoration: Restored ALTER TABLE statements in migrations 023, 029, and 103 that were removed during schema consolidation.
• Production Hotfix: Reverted ALTER TABLE statements to prevent "duplicate column" errors in production deployments via Wrangler CLI.
• Dual-Mode Migrations: Fresh installs use consolidated schemas (004/005); seed-only migrations (023/029/103) handle data population only.
• UI Regressions: Fixed Testing Hub showing stale version and missing "Distribution Strategies" card.
• Cleanup: Removed deprecated "Services" module and legacy filesystem-based feature pages, fully migrating to CMS-driven content.
• Git Safety: Enabled tracking of .ai.docs/ directory on develop branch while excluding it from template, preventing accidental documentation loss.
• Features: Fixed environment detection filter to correctly display the "Testing" module in Preview and Production environments while hiding it in Template builds.

[0.4.16] - 2026-01-07

Changed

• Database Migration Resilience: Enhanced init-database API with comprehensive idempotency error handling.
  • Detects and safely skips duplicate column name errors (from ALTER TABLE re-runs).
  • Improved logging: skipped statements now show ⏭️ Skipped (already applied) for upgrade tracing.

Fixed

• FS Bundling: Fixed npm run dev crash by guarding fs imports.
• Layout Inversion: Fixed Admin Dashboard footer rendering at top.
  • Ensures all migrations 021, 023, 025, 026, 029 can be re-run safely without crashes.
  • Impact: Users can now run Setup Wizard multiple times, or upgrade from partial migrations, without database errors.

v0.4.19 (2026-01-07) - Migration System Hardening

• Schema Consolidation: Consolidated pages and site_config columns into base schemas to prevent unsafe ALTER TABLE errors.
• Idempotency Fixes: Updated all seeding migrations to use INSERT OR IGNORE to safely handle re-runs.
• Dev Fallbacks: Implemented filesystem fallback for Changelog module when D1 is unavailable (dev mode).
• Cleanup: Removed redundant/conflicting migration files (104, 023, 029, 103).

[0.4.18] - 2026-01-07

Fixed

• Preview Build Stability: Resolved EPERM and module resolution errors in npm run preview by isolating server-side feature logic.
• Home Page Redirect: Fixed infinite redirection loop in Preview mode by ensuring site_config table is properly seeded in local D1.
• Rich Content Restoration: Restored rich block content for Privacy, Terms, and Support pages via metadata_json migration.
• Layout Rendering: Enabled dynamic BlockRenderer for generic pages by migrating them to layout_id='blocks'.
• Dev Mode Sync: Fixed "Module not found: fs" errors by creating environment-safe features-server.ts.

Added

• Content Sync Script: Added scripts/sync-dev-pages.js to automatically keep local MDX fallbacks in sync with D1 database content (crucial for dev/preview parity).

[0.4.17] - 2026-01-07

Added

• Navigation Database Migration: Fully migrated navigation storage from static JSON to D1 database (navigation_items table).
• Navigation Admin UI: Refactored Navigation Editor (/admin/design/nav) to support CRUD operations directly against D1.
• Navigation APIs: Added endpoints for item management (/api/admin/navigation/item) and reordering (/api/admin/navigation/reorder).

Fixed

• Navigation Inconsistency: Resolved discrepancy between Dev (filesystem) and Preview (D1) navigation by removing hardcoded legacy configs.

• Features Dropdown: Now populates dynamically from D1 pages (nav_parent='features') across all environments.

• Module Cleanup: Removed obsolete "Services" module feature flag; simplified nav.json.

• Migration: Updated SQL migrations to properly nest About, Contact, Platform, and Support pages under the Features dropdown.

• FS Bundling: Fixed npm run dev crash by guarding fs imports.

• Layout Inversion: Fixed Admin Dashboard footer rendering at top.

[0.4.15] - 2026-01-07

[0.4.15] - 2026-01-07

Fixed

• CRITICAL: Database Initialization (Local/Preview): Resolved persistent "no such table: users" error during Setup Wizard in local development.
  • Re-enabled INSTALL_STRUCTURE_SQL execution in /api/admin/init-database for consistent table creation.
  • Ensures local development matches production build-time behavior.
• Navigation Dropdown Missing: Resolved issue where "Features" dropdown was empty.
  • Root Cause: Manual migrations (manual_migration_features.sql) were running before table creation due to sorting logic.
  • Fix: Renamed manual migrations to 097_, 098_, 099_ to ensure they execute last.

[0.4.14] - 2026-01-07

Added

• Content Creation Shortcuts: Added a "Content Generation" sidebar to the Navigation Editor with quick links for creating Pages, Blog Posts, and Changelogs.
• Improved Nomenclature: Rebranded "Add Master" as "Add Top-Level Item" across the Navigation Editor for better clarity.

Fixed

• Admin Visibility Filtering: Disabled modules are now visually dimmed in the Navigation Editor and automatically filtered from parent selection dropdowns in Module Settings.

[0.4.13] - 2026-01-07

Added

• Navigation Settings UI: Added "Discovery Settings" to module admin pages (Changelog, Blog) to control visibility and placement in public navigation.
• Feature-Aware Navigation: Public site header now strictly respects feature flags and module settings, ensuring disabled modules are hidden.
• Hybrid Navigation Architecture:
  • Development: Persists navigation changes to nav.json for git tracking.
  • Production/Preview: Uses Cloudflare KV for performant, distributed navigation storage.
• Admin UX: Added "Settings" buttons to module headers for quick access to configuration.

[0.4.12] - 2026-01-06

Added

• Changelog Management System (Complete):
  • Admin UI: Full CRUD interface with filtering (status, category), search, bulk actions, and settings modal.
  • Public Pages: Premium timeline design at /changelog with category theming, archive section, and dynamic column layouts.
  • Detail Pages: Individual version pages at /changelog/[version] with ES2017-compatible markdown rendering and breaking change warnings.
  • Settings API: Configurable archive threshold and column layouts (/api/admin/changelogs/settings).
  • Navigation Integration: Added to both public site navigation (nav.json) and admin Content Hub.
  • Feature Flag: Enabled changelog module in Module Manager with description.
  • Development Fallbacks: Local JSON file support for all APIs in dev mode.
  • Archive Management: Separate "Legacy Archive" section with independent grid configuration and visual badges.
  • Rich Text Editor: Integrated UnifiedEditor for markdown-based release notes.
  • Semantic Versioning: Strict validation with regex and conflict detection.
  • Database Migration: Robust 037_create_changelogs_table.sql with IF NOT EXISTS patterns.
• Reusable Comparison Matrix Component: Built foundational comparison matrix UI architecture for use across Pages, Blogs, and other CMS features.
  • Supports dynamic row definitions with custom content types
  • Multi-column layout with flexible data rendering
  • Interactive tab-based navigation with hover/active states
• Enhanced Tab Navigation: Extended NavHeader component with additional color variant support and flexible badge system.

Changed

• Matrix Architecture: Implemented dynamic column ordering system that can be configured via data structure rather than hardcoded layout.

[0.4.11] - 2026-01-05

Fixed

• Setup Lockout "Smart Access": Implemented "No User = No Lock" policy in setup API.
  • If the users table is empty or missing, the Setup Wizard is now unlocked automatically, even if setup_completed flag is true.
  • Fixes the "infinite lockout" loop for users with corrupted installations or failed migrations.
• SQL Migration Stability: Audited and fixed all 31 migration files.
  • Replaced unsafe INSERT INTO with INSERT OR IGNORE INTO for all seed data (seo, pages, settings).
  • Fixed all 24 CREATE INDEX statements in forum migrations (014-019) to use IF NOT EXISTS.
  • Removed redundant migrations (022, 024) that caused duplicate column errors.
  • Fixed ALTER TABLE statements in 029 to use constant default values conformant with SQLite strict mode.
• Roadmap: Added "Proper Upgrade Process" as a prioritized roadmap item.

[0.4.10] - 2026-01-05

Added

• Distribution Strategy Overhaul: Comprehensive guide for GitHub Fork deployment.
• Workers Only Policy: Enforced Cloudflare Workers as the exclusive deployment target (removed all Pages references).
• Comparison Matrix: Updated strategy comparison with new "Audience", "Customization", and "Local Setup" rows.

Changed

• Documentation: Updated environments.md and memories.md to reflect the Workers-only policy.
• UI: Polished DistributionStrategyPage with new 10-step fork guide (subsequently simplified in v0.4.11).

[0.4.8] - 2026-01-05

Added

• Setup Wizard First-Run Experience: Automatic redirection from / to /setup if the site is unconfigured.
• Enhanced Token Guidance: Conditional help section in Setup Wizard with direct links and instructions for Cloudflare API tokens.
• Admin Dashboard Recent Activity: New Sidebar widget powered by a unified activity API to track recent pages, posts, and media changes.
• Loading States & Skeletons: Improved perceived performance on the Admin Dashboard with skeleton loaders for statistics and content counts.
• White-Labeling Foundations: Unified SiteConfig type and dynamic header navigation driven by site configuration.

Fixed

• Critical API Stability: Resolved 500 errors in Cloudflare Workers caused by static fs imports in pages library.
  • Implemented dynamic imports wrapped in environment checks.
• Database Auto-Healing: Added self-recovery logic for posts, pages, categories, and authors tables.
  • APIs now automatically create missing tables on write operations, preventing "no such table" crashes in production.
  • CRUD operations output strict warnings instead of crashing when tables are missing during reads.
• GitHub Repository Fallbacks: Updated hardcoded repository references to match the current Lizardware-Dev location.
• Media Library Count Logic: Corrected API responses for media and content counts to ensure accurate dashboard statistics.

[0.4.7] - 2026-01-05

Added

• Distribution Strategy Infrastructure: Built the foundation for dual-model distribution (GitHub Fork vs Direct ZIP).
  • Created docs/SETUP-FORK.md and docs/UPDATING.md for GitHub Fork users.
  • Created docs/SETUP-DIRECT.md for direct ZIP-based deployments.
  • Built scripts/package-release.js (PowerShell-based) with branch safety locks to ensure clean release artifacts.
  • Created .agent/workflows/release-process.md to formalize the release cycle.
• Admin Update Hub: New system dashboard at /admin/system/updates for version tracking and update management.
  • Implemented src/lib/git-detection.ts to identify deployment mode.
  • Added mock /api/admin/updates/check API layer for update availability.

Fixed

• Development Environment Access: Resolved critical issue where npm run dev required authentication (redirecting to login) despite missing D1 bindings.
  • Implemented NODE_ENV === 'development' bypass in src/middleware.ts
  • Restored ability to access /admin routes locally without configuring a database
  • Maintains security by strictly enforcing auth in Preview and Production environments
• Dev Server Stability: Resolved npm run dev hang/crash by decoupling blocking documentation generation script (next.config.ts) and handling uninitialized OpenNext context safely.
• Production API Stability: Fixed critical 500 error in /api/admin/features caused by static fs/path imports in Cloudflare Workers.
  • Converted to dynamic imports (await import()) inside process.env.NODE_ENV === 'development' blocks.
  • Restores "Features" toggles in Production admin dashboard.
• Auto-Healing Database: Implemented self-recovery for missing feature_flags and media tables.
  • API routes now automatically create schema on first write if tables are missing (resolves 500 errors).
  • Added default fallback data for read operations to prevent dashboard crashes.
• Setup Wizard Resilience: Added "Login as Existing User" workflow in Admin Creation step.
  • Detects "Username already taken" errors and offers inline login verification.
  • Unblocks setup flow for users with pre-existing admin accounts.
• Documentation Recovery: Restored docs/developers/ and /admin/testing/ modules that were inadvertently removed during template branch synchronization.

[0.4.6] - 2026-01-05

Fixed

• CRITICAL: Database Initialization - Build-Time Migration: Resolved "Too many subrequests" error by splitting database initialization into two phases:
  • Phase 1 (Build-Time): Run structural migrations via wrangler d1 execute in GitHub Actions workflow (Step 6.5), bypassing Cloudflare Worker subrequest limits
  • Phase 2 (Runtime): Setup Wizard now only runs lightweight business-type seed data (~10 statements), staying well under 50 subrequest limit
  • Updated .github/workflows/deploy.yml to automatically initialize D1 database structure after build, before deployment
  • Modified /api/admin/init-database to remove INSTALL_STRUCTURE_SQL execution, now only applies business-type seeds
  • Fixes "D1_ERROR: no such table: users" error during admin account creation
  • Impact: Database is fully initialized before first user request, eliminating runtime initialization errors

Admin & Testing

• Distribution Strategy Hub: Added interactive /admin/testing/distribution-strategy page to compare GitHub Fork vs Direct Deployment workflows.
• Testing Navigation: Added "Strategic" quick-link card to Testing Hub index.

Template Branch (Genericization)

• Public Content White-Labeling: Removed specific "Lizardware" branding from default content, schema, block registry, and SEO metadata.
• Seed Data Refactor: Genericized source SQL files for software-dev preset and sitemap generation.
• Documentation: Simplified README.md to serve as a user-friendly "Starter Template" guide.
• Cleanup: Removed internal developer documentation (docs/) to reduce clone size.

Changed

• Production Deployment Strategy: Documented recommended approach using native Cloudflare Dashboard integration with environment variables instead of GitHub Actions-only deployment
• Quick Start Documentation: Fixed incorrect "Select Pages tab" instruction to correct "Select Get started next to Import a repository" (Workers deployment flow)

Added

• Deployment Documentation: Created comprehensive production deployment guide (production-deployment-walkthrough.md) with step-by-step instructions
• Repository Strategy Guide: Documented decisions on repository structure, template repository feature usage, and naming conventions
• Manual Database Init Guide: Created fallback guide for initializing database via Cloudflare Dashboard Console

Fixed (Jan 5, 2026 - Session 2: Wrangler Authentication)

• CRITICAL: Wrangler CLI Authentication: Resolved persistent authentication errors blocking local database management
• Fixed GitHub Actions Step 6.5 script: Changed from require('./wrangler.jsonc') to fs.readFileSync() + JSON.parse() to handle .jsonc extension
• Identified and removed .env.local file containing placeholder values (your_api_token_here) that wrangler auto-loaded
• Cleared stale wrangler authentication cache from ~/.wrangler and AppData/.wrangler
• Re-authenticated via OAuth (browser-based) instead of unreliable API token method
• Successfully initialized production database via Cloudflare Dashboard Console after wrangler CLI proved unreliable for large SQL files
• Wrangler Configuration: Updated wrangler.jsonc with correct production resource IDs (KV: 3b2de033748f4b158765b473e767e6e2, D1: e580d5ed-280a-4ee1-8532-021dc1bd1dbd)

Action Required

CRITICAL: GitHub repository secrets contain incorrect Cloudflare Account ID. The CLOUDFLARE_ACCOUNT_ID secret must be updated from 4c2b9264fa7406616421045aa3019326 to 49fdf4c3f5ee28fcb734d719f1c26f2d (Production Account) in repository Settings → Secrets and variables → Actions. Without this, automated deployments will fail to access Cloudflare resources.

Fixed (Jan 4, 2026 - Prior Entry)

• Database Initialization: Fixed critical SQL parsing bug where inline comments (e.g., -- uuid) caused silent failure of table creation during setup/upgrades.
  • Updated runSql in init-database API to preserve newlines, ensuring comments don't swallow subsequent code.

[0.4.5] - 2026-01-04

Fixed

• Theme Persistence System: Resolved critical bug where saving a theme preset deleted global design tokens (border radius, spacing), causing the entire admin UI to revert to square corners.
  • Implemented Deep Merging in /api/config/theme to preserve existing architecture tokens when only colors/typography are updated.
  • Added robust CSS Variable Fallbacks in CustomThemeManager to prevent UI breakage if theme data is incomplete.
  • Expanded Tailwind Radius Scale to include rounded-3xl mapping in globals.css and theme-tokens.css.
• Development Environment Compatibility: Fixed /api/admin/setup-lock to gracefully handle missing D1 bindings in npm run dev mode.
  • API now defaults to "unlocked" state in dev mode (unless overridden by local config) without attempting D1 queries.
  • Mirrors behavior of setup-status API for consistent local development experience.

[0.4.4] - 2026-01-04

Added

• Build-Time Provisioning: Automated Cloudflare resource creation (KV, D1, R2) via scripts/provision-cloudflare.js in prebuild pipeline.

  • Zero-config setup: Auto-detects project name from wrangler.jsonc

  • Eliminates runtime API token exposure in Setup Wizard

  • Provisions resources automatically on first build/deploy

• R2 Deployment Fix: Updated build scripts to conditionally include R2 bindings only if explicitly configured, preventing build failures for accounts without R2 enabled.
• System Diagnostics: New /admin/diagnostics page showing real-time connection status for KV, D1, and R2 bindings.
• Error Reporting: Enhanced Setup Wizard error details with expandable JSON/Stack trace views.
• Documentation: Rewrote Deployment Guide and Quick Start to prioritize the new automated GitHub Actions workflow over manual configuration.
• Documentation Audit: Comprehensive overhaul of .ai.docs/environments.md to reflect v0.4.4 architecture and created .ai.docs/environments-archive.md for legacy methods.

Changed

• Setup Wizard Flow: Removed resource provisioning steps from runtime wizard (now handled at build time). Wizard now focuses solely on content seeding.
• Environment Configuration: Added .env.example with build-time provisioning variables (CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_API_TOKEN).
• Runtime Persistence: Injected build-time Cloudflare variables into runtime environment via next.config.ts to support automatic provisioning in CI/CD (Pages/Workers) environments.

Fixed

• CRITICAL: Changed Cloudflare resource naming from hyphens to underscores (lizardware_cms_config_kv instead of lizardware-cms-config-kv) to comply with Cloudflare API validation requirements
• D1 Migration Parser: Fixed critical bug where inline SQL comments (-- comment) caused "Incomplete input" errors during migration execution.
• Authentication Error Handling: Improved guidance for API token permission errors during setup/build.
• Multi-User Forks: Fixed project name collision issue by adding dynamic project naming to generate-wrangler-config.js
• GitHub Actions Workflow: Resolved ENOENT: no such file error by creating scripts/wrangler.template.jsonc and adding robustness to configuration generation.
• Alpha Testing Guide: Improved usability with always-visible copy buttons and comprehensive troubleshooting section for deployment failures.

Fixed (Session Patch)

• Admin Route Standardization: Updated legacy admin links in documentation (getting-started.mdx, alpha-tester-notes) to point to new hub-based routes (/admin/content/blog, /admin/design/theme, etc.).
• Codebase Hygiene: Resolved syntax errors (mismatched tags) in monetization, seo, and diagnostics pages that were blocking type-checking.
• Component Integrity: Fixed missing props (badge) in AdminHeader usage across diagnostics and profile pages.
• Navigation Sync: Corrected import in admin/design/nav to ensure Navigation Intelligence works correctly.

[0.4.3] - 2026-01-03

Changed

• Admin Navigation Architecture: Complete restructuring into hierarchical hubs for improved scalability and UX
  • Content Hub (/admin/content): Blog, Pages, Media, Categories, Authors
  • Design Hub (Visual Forge) (/admin/design): Visual Identity, Theme Transformer, Features, Navigation
  • Growth Hub (/admin/growth): SEO Toolkit, Monetization
  • System Hub (/admin/system): Advanced Settings, Documentation, Roadmap, Changelog, Configuration
• Global Navigation Sync: Updated OrbitalNav component and mobile drawer to reflect new hierarchy
• Hub Card Gradient System: Standardized color tokens in admin-hub-styles.ts (added indigo gradient to CARD_GRADIENTS)
• Theme System Refinement: Introduced Tier 1.5 theme variables for granular component control
  • Added accordionBackground, buttonBackground, cardBackground, and inputBackground variables
  • Updated all 6 theme presets with calibrated component palettes
  • Migrated Homepage, Accordion, ContactForm, and Block components to use new variables
  • Reorganized Theme Transformer UI into logical foundations, components, and sections

Fixed

• 500 Internal Server Errors: Resolved critical production errors caused by static fs/path imports in non-Node environments
  • src/lib/theme-server.ts: Converted to dynamic imports in getTheme() function
  • src/app/api/config/site/route.ts: Converted to dynamic imports in GET/PUT handlers
  • Impact: Fixed crashes on /admin/design and /favicon.ico routes in Cloudflare Workers
• Server-Side Rendering Compatibility: Prevented Node.js module loading errors in Edge runtime
• Auto-Provisioning Failure: Fixed critical SQL parsing bug in executeD1Migration where valid SQL statements were discarded if they were preceded by comments (causing "no such table" errors during setup).
• Troubleshooting & Support: Integrated comprehensive troubleshooting documentation and "Build Token" error resolution
  • Added "Troubleshooting Guide" links to Setup Wizard and Quick Start documentation
  • Documented Cloudflare API Token requirements and Workers CI/CD error resolutions

Files Changed: 34 files (255 insertions, 160 deletions)
Git Commit: f22020f
Value: Scalable admin architecture for future module expansion; eliminated critical deployment blockers.

Visual Polish (Session Patch)

• Admin Dashboard Layout: Removed min-h-screen and redundant padding from all admin pages to eliminate "ghost scrolling" behavior. The main layout now handles vertical spacing globally.
• Accordion Component: Introduced a new hub variant for admin dashboard section cards, featuring glassmorphism, accent colors, and refined interaction states.
• Admin Header Standardization: Applied the standardized AdminHeader component to Blog Authors, Categories, Media, and Content pages, ensuring a unified visual hierarchy.
• Content Styling: Standardized backgrounds (bg-site-background) and corner radii (rounded-[2rem]) across Feature Modules and Content Hub quick actions for a premium feel.
• Footer Visibility: Added explicit bottom margin (mb-14) to the footer to prevent it from being obscured by the fixed bottom navigation bar, and ensured text contrast is accessible.

[0.4.2] - 2026-01-03

Added

• Block-Based Page Builder Core (Phase 1): Initial implementation of the block-based editing system
  • Block Registry: Foundation for modular, reusable UI components (registry.tsx)
  • Block Renderer: Recursive rendering engine for nested block structures (BlockRenderer.tsx)
  • Drag-and-Drop Infrastructure: Integrated @dnd-kit for visual block reordering
  • Block Storage: JSON-based serialization for page metadata persistence
  • Block UI Library: Sidebar library for discovery and insertion of new blocks
  • Properties Panel: Dynamic configuration UI with support for Rich Text, selects, and color pickers
• Database Resilience: Refactored SQL seeds to use INSERT OR IGNORE, preventing user content overwrites during upgrades.
• New Business Presets: Added restaurant.sql, blog.sql, service.sql, and blank.sql with specialized placeholder content.
• Live Preview Engine: Refactored the preview renderer with a reactive client-side wrapper (LivePreviewWrapper), enabling instant hot-refresh for Page Architecture (Layout) changes.
• New Page Layouts: Added 2 new specialized page layouts for the Classic Editor: "Documentation" (Sidebar Right) and "Hero Power" (Full Width).
• Block Rendering Fixes: Resolved issue where HTML tags from the WYSIWYG editor rendered literally in block previews.
• Documentation Refactor: Split roadmap.md into tech-stack.md, architecture.md, strategy.md.

[0.4.1] - 2025-12-30

Added

• Cloudflare API Automation: setup/auto-provision endpoint for creating KV, D1, R2 resources.
• Setup Wizard Integration: "Instant Provisioning" UI.

[0.3.35] - 2026-01-02

Changed

• Setup Wizard Safety Enhancement: "Keep Existing Content" checkbox now defaults to checked for safer database operations.
  • Changed default state from false to true in BusinessTypeStep
  • Prevents accidental data loss during template/seed application
  • Particularly important for version upgrades and testing scenarios

Added

• Visual Warning System for Setup Wizard:

  • Implemented red "Danger" mode styling when "Keep Existing Content" is unchecked
  • Added contextual messaging: "Safe Mode" vs "Destructive Mode"
  • Pulsing "Danger" badge appears when user opts for destructive database wipe
  • Explicit warning text: "This will WIPE your entire database and replace it with template defaults"

• Admin UI Standardization - Phase 2: Extended compact header design to 5 additional pages:

  • /admin/config (Settings Studio)
  • /admin/nav (Navigation Manager)
  • /admin/docs (Documentation Hub)
  • /admin/roadmap (Project Roadmap)
  • /admin/changelog (Release History)
  • Applied same design pattern: integrated breadcrumbs, p-5 md:p-6 padding, pt-0 containers
  • Smaller decorative elements with pointer-events-none

Value: Completed visual unification of all 13 major admin pages and significantly improved setup safety to prevent accidental data loss.

[0.3.34] - 2026-01-02

Changed

• Admin Hub Layout Polish: Comprehensive refinement of all admin hub pages and sub-pages for improved space efficiency and visual consistency.
  • Compact Header Design:
    • Integrated breadcrumbs into header cards (saves vertical space)
    • Reduced padding throughout headers: p-5 md:p-6 (from p-6 md:p-8)
    • Reduced page top padding: pt-0 for hub containers, pt-1 for admin layout
    • Smaller title sizing for better hierarchy: text-2xl md:text-3xl
    • Inline descriptions on desktop with vertical separator
    • Condensed mobile descriptions
    • Smaller decorative elements with pointer-events-none
  • Pages Updated:
    • Hub Pages: /admin/growth, /admin/content, /admin/appearance, /admin/system
    • Sub-Pages: /admin/pages, /admin/blog, /admin/advanced, /admin/visual-identity
  • Action Hook Standardization:
    • Migrated all pages from manual createPortal to useAdminActions hook
    • Standardized bottom navigation bar action buttons
    • Removed deprecated portal logic and mounted state
  • Design Tokens Updated:
    • HUB_PAGE_STYLES.topPadding: pt-4 → pt-0
    • Admin layout main padding: pt-8 → pt-1

Fixed

• Removed unused mounted state from Pages Playground, Blog Manager, Advanced Settings, and Visual Identity pages
• Fixed missing imports for useAdminActions and ArrowLeft icons

Value: Minimized wasted vertical space across the admin dashboard, creating a more efficient and professional user experience. All hub pages now follow a consistent, compact design pattern.

[0.3.32] - 2025-12-30

Fixed

• Admin Navigation: Fixed React Error #310 in /admin/nav caused by useMemo hook placed after conditional returns - moved to top of component for consistent hook ordering
• Edge Runtime Compliance: Removed incompatible runtime = 'edge' export from routes API, allowing proper Node.js runtime via OpenNext
• Environment Safety: Refactored src/lib/blog.ts to use dynamic imports for Node.js modules (fs, path, glob, gray-matter, marked), preventing Edge bundling errors
• Setup Wizard Mobile UX: Improved copy button layouts with flex-wrap and responsive breakpoints for better mobile experience
• Documentation: Corrected Flash model references from "Gemini 2.0" to "Gemini 3.0" in project documentation

Changed

• Blog utilities now lazy-load filesystem dependencies only when needed, improving compatibility with Cloudflare Workers runtime

Value: Restored critical admin functionality and ensured codebase compliance with multi-environment architecture patterns.

[0.3.30] - 2025-12-30

Added

• Navigation Intelligence System:
  • Route Registry (src/lib/routes.ts): Centralized list of all system routes and dynamic content paths.
  • RoutePicker Component (src/components/admin/RoutePicker.tsx): Smart autocomplete input for internal linking with 404 detection.
  • Menu Builder Integration: Updated Admin Nav structure editor to use RoutePicker.
• Setup Wizard Flow Improvements:
  • Reordered onboarding flow: Welcome Screen (Step 0) now appears before Technical Prerequisites (Step 1).
  • Validated step counting and progress bar visualization.

Fixed

• Improved "Magic String" handling in navigation editor - users can now discover valid paths instead of guessing.

[0.3.29] - 2025-12-30

Added

• Feature Flags Implementation: Made existing feature flags fully functional across the application.
  • Feature Utilities (src/lib/features.ts, src/hooks/useFeatures.ts): Server and client-side functions for checking feature flags.
  • Navigation Filtering: OrbitalNav now dynamically shows/hides menu items based on feature flags (Blog, Media Library, Revenue Streams, Analytics, Newsletter).
  • Route Guards: Added protection to /admin/blog, /admin/media, and /admin/monetization pages - redirects to admin dashboard with warning if feature is disabled.
  • Disabled Feature Warning: Admin dashboard displays a yellow alert banner when users are redirected from disabled features, with link to Advanced Forge.
  • Enhanced UI in Advanced Forge: Feature flags now display with:
    • Status badges ("Active" / "Disabled")
    • Color-coded backgrounds (emerald for enabled, gray for disabled)
    • "(Hidden from navigation)" warning below disabled features
    • Improved toggle styling and accessibility

Changed

• Feature flags are no longer just cosmetic placeholders - they now control actual application behavior
• Navigation dropdown items are filtered based on user's enabled features
• Advanced Forge feature section includes explanatory text about navigation hiding

Value: Completes the Business Type Architecture by making feature flags functional. Users can now truly customize their admin experience based on their business type, reducing clutter from unused features.

[0.3.28] - 2025-12-29

Added

• Admin Hub Pages: Created centralized landing pages for Content and System sections.
  • Content Hub (/admin/content): Overview page with quick stats (Posts, Pages, Categories, Authors), section cards, and quick action buttons for creating new content.
  • System Core (/admin/system): System administration page with version info, status indicators, and links to all system tools (Core Forge, Docs, Roadmap, Changelog, etc.).

Changed

• Navigation Structure: Updated OrbitalNav dropdown links to point to proper hub pages.
  • Content dropdown now links to /admin/content (was /admin/blog)
  • System dropdown now links to /admin/system (was /admin/advanced)

Value: Improved navigation consistency and provides users with a helpful overview before diving into specific admin sections.

[0.3.27] - 2025-12-29

Added

• Business Type Architecture: Comprehensive unification of template, theme, and seed selection into a cohesive system.
  • Business Type Registry: 5 business types (Software Dev, Restaurant, Blog, Service, Blank Canvas) with recommended themes and feature flags.
  • Unified Setup Flow: New BusinessTypeStep combines business type selection with automatic database deployment.
  • Merge Mode: "Keep existing content" checkbox allows merging new seed data with existing database content.
  • Feature Integration: Each business type automatically configures feature flags based on business needs.

Changed

• Setup Wizard Reordering: Moved "Welcome" (Forge Your Digital Realm) to Step 1, before infrastructure checks.
• Reduced Steps: Setup flow now 6 steps (down from 7) - Welcome → Resources → Business Type → Site Info → Review → Complete.
• Removed Template Step: Template selection unified with Business Type selection for streamlined onboarding.
• Simplified Apply Process: No longer applies complex theme configurations during setup - focuses on business type and feature flags only.

Removed

• Separate Template Selection Step: Functionality absorbed into Business Type step.
• Template Theme Application: Removed complex theme override logic from setup wizard.

Technical

• Removed SiteTemplate from setup wizard state (now uses BusinessType).
• Updated init-database API to accept keepExisting parameter.
• Cleaned up setup wizard to remove getAllTemplates() and template-related imports.

Value: Dramatically simplified onboarding experience while providing smart defaults. New users get coherent, business-appropriate starting content without manual coordination of disconnected systems.

[0.3.26] - 2025-12-29

Added

• Unified Editor Theme Sync: Complete synchronization of dark/light mode across the Editor Sidebar, Toolbar, and Live Preview iframe.
  • Global Context: Rich Text Editor now consumes next-themes context.
  • Cross-Window Comms: SET_THEME message broadcast to live preview for instant switching.
• Page Layout Architecture: Added ability to select "Standard" or "Minimal" layouts for custom pages.

Changed

• Admin Header Polish: Refined "Data Matrix" (Quick Stats) component.
  • Responsive Layout: Stacks vertically on desktop (sidebar style) and flows horizontally on mobile.
  • Typography: Context-aware font sizing for better information density.
• Unified Editor: Standardized "Back" button and layout behavior.

[0.3.24] - 2025-12-29

Changed

• Admin Popups Overhaul: Replaced all native browser alert() and confirm() dialogs with a custom, promise-based AdminPopupProvider.
  • Consistent UI: All confirmations and alerts now match the application's glassmorphism design system.
  • Enhanced UX: Added "Danger" variants for destructive actions and success/error variants for feedback.
  • Affected Areas: AuthorManager, VisualIdentity, ThemeEditor, SetupWizard, and UnifiedEditor.

Removed

• ConfirmationModal: Removed the legacy ConfirmationModal component (superseded by AdminPopupProvider).

[0.3.23] - 2025-12-29

Added

• Software Development Preset: Added a new "Software Dev" content preset with specialized migrations and seed content.
• Content Seeding: Pre-populated "About," "Features," and "Pricing" pages for the software preset.

[0.3.22] - 2025-12-29

Changed

• Strategic Navigation Overhaul: Complete refactor of the Admin Navigation system.
  • OrbitalNav: New unified component for top/bottom navigation bars.
  • Pathfinding Station: Enhanced Navigation Editor with "Orbital" design system and real-time preview theater.
  • State Management: Fixed drag-and-drop glitches and persistence issues in the nav editor.
  • Mobile Optimization: Improved drawer behavior and touch targets.
• Breadcrumb Intelligence: Auto-generated breadcrumbs based on URL structure, removing manual boilerplate from 5+ admin pages.

[0.3.21] - 2025-12-29

Added

• Navigation Architecture Overhaul: Reorganized the Admin Navigation into logical hubs: Content, Growth, Design, and System.
• Media Library & SEO Toolkit: Promoted these critical tools to the primary desktop navigation.
• Reusable Dashboard Components: Created modular DashboardBanner, QuickLinkRow, and SystemStatusBubble components for consistent admin UX.
• Accordion State Persistence: All admin dashboard sidebar cards now remember their expanded/collapsed state across sessions.
• Responsive Quick Actions: Vertical stack on desktop (space-efficient), horizontal row on mobile (height-efficient).

Changed

• Navigation Refactoring: Merged "Appearance" and "Structure" into Design Studio; merged "Advanced" and "Docs" into System Core.

• Deduplicated Site Configuration: Removed redundant Site Name and Description fields from the Advanced Settings page; Visual Identity is now the single source of truth.

• Standardized Action Buttons: Verified all SEO and content management pages use the AdminCommandBar (Bottom Portal) for primary actions, removing non-standard inline buttons.

• Dashboard Header: Replaced "Quick Connection" card with functional "Quick Actions" navigation (Write Post, Manage Pages, Theme Transformer).

• Dynamic Versioning: All version displays now pull from centralized VERSION constant for consistency.

• Redundant Quick Access: Deleted sidebar accordion (functionality moved to primary header).

• Legacy Config: Deleted src/app/(admin)/admin/config (redundant).

• Advanced Settings: Removed duplicate "Site Information" form (now exclusively in Visual Identity).

• Legacy Config: Deleted src/app/(admin)/admin/config (redundant).

• Advanced Settings: Removed duplicate "Site Information" form (now exclusively in Visual Identity).

[0.3.20] - 2025-12-29

Removed

• Deprecated MarkdownEditor component.

Security / Performance

• Performance baseline established (docs/performance/v0.3.20-baseline.md).
• Validated admin dashboard dark mode stability.

[0.3.19] - 2025-12-29

Added

• Deployment Activity Tracking - Integrated a "Last Updated" timestamp in the Admin Command Center to track the latest edge deployment.

Changed

• Navigational Layout Optimization - Moved the "Launch Site" button to the bottom status bar to consolidate external actions and improved the "Edge: Operational" status badge alignment.

[0.3.18] - 2025-12-29

Changed

• Breadcrumb & UI Polish - Standardized breadcrumb placement and improved navigational flow across admin sub-pages.

[0.3.17] - 2025-12-29

Added

• Dynamic Wrangler Configuration - Transitioned wrangler.jsonc to a generated build artifact, ensuring local build stability while maintaining CI/CD security.
• Environment ID Injection - Integrated scripts/init-config.js to automatically populate resource IDs from .env.local or Cloudflare Build Variables.
• Simplified Local Setup - Introduced npm run setup:bindings CLI tool to guide developers through configuring local Cloudflare bindings.
• Comprehensive Configuration Guide - Added docs/developers/wrangler-configuration.md covering architecture, setup, and troubleshooting.

Changed

• Blog List Standardization - Comprehensive visual and functional overhaul to match the Pages Playground design.
• Enhanced Content Metrics - Integrated a new statistics bar showing live/draft transmission counts.
• Smart Filtering & Sorting - Implemented status-based filter tabs and a unified sorting system (Date, Title, Views).
• Proactive Search - Improved search engine matching across titles, slugs, excerpts, and authors with real-time feedback.
• Git Hygiene - Added wrangler.jsonc to .gitignore to prevent configuration drift and accidental secret commits.
• Build Pre-requisites - npm run build is now the mandatory entry point for all bundled deployments to ensure config generation.

Fixed

• Cloudflare Build Stability - Resolved D1_ERROR: no such table: posts by explicitly skipping static generation during the production build phase (generateStaticParams).
• OpenNext Bundle Compatibility - Removed unsupported edge runtime declaration from setup-lock API route.
• Admin Navigation - Fixed broken blog editor link in AdminLayout to correctly point to the unified editor.

[0.3.16] - 2025-12-29

Added

• Setup Wizard Visual Update - Complete "Next-Gen" visual overhaul for /setup with glassmorphism and animations.
• Sticky Environment Banners - Environment indicators now stick to top/bottom of viewports site-wide for better developer visibility.
• Dedicated Setup Layout - /setup now has a focused layout (no global admin nav/footer) to reduce distraction.

Changed

• AdminHeaderHider - Enhanced logic to handle /setup route specifically.
• EnvironmentBanner - Updated to be fully opaque and sticky-aware to prevent content scroll-through.
• Page Transitions - Added kinetic entrance animations to setup steps.

[0.3.15] - 2025-12-29

Added

• Resizable Editor Layout - 50/50 split view with draggable divider for Unified Editor.
• Live Preview Polish - High-contrast "Breathing" status badge and reduced padding.
• Variable Rendering - Live preview now resolves {{variables}} in real-time.

Changed

• Editor Toolbar - Consolidated formatting options into dropdowns for cleaner UI.
• Preview Behavior - Improved pointer event handling during resizing.

[0.3.7] - 2025-12-29

Added

• Environment-Aware Default Content - New seeding system with three options (Professional, Demo, Blank)
• Enhanced Setup Wizard - Integrated environment selection into the database initialization step
• Branch Management Strategy - Established main → develop → feature/* workflow
• Git Cleanup - Automated deletion of 14+ stale local and remote branches
• PR Template - New .github/PULL_REQUEST_TEMPLATE.md with content audit checklist
• Seed Optimization - Separated structural migrations from seed content for lean production deployments

Changed

• Database Initialization - API now supports targeted seeding based on user choice in wizard
• Migration Structure - Seed data moved from numbered migrations to migrations/seeds/

[0.3.6] - 2025-12-28

Added

• Typography Controls Enhancement - Converted all font sizes from rem to px for user familiarity
• Separated Page Description Control - Independent slider for site description (10-60px range)
• Environment Architecture Documentation - Comprehensive guide in .ai.docs/environments.md
• Bundled Migration SQL - Generated TypeScript file for edge-compatible initialization
• Database Init Resilience - API now handles redundant migration statements (e.g. duplicate columns) gracefully

Fixed

• Admin Config Page Errors - Resolved undefined nested object access (seo, links, openGraph)
• Merge-with-Defaults Pattern - API routes now always return complete config structure
• Database Init in Preview - Fixed fs.readFileSync error and redundant column errors in Cloudflare Workers
• Site Config Corruption - Prevented incomplete saves from wiping nested fields

Changed

• Typography Ranges - More intuitive px-based sliders (Title: 12-120px, Description: 10-60px, Body: 8-48px)
• Default Typography - Updated to px values (Title: 60px, Subtitle: 30px, Description: 24px, Base: 16px)

[0.3.5] - 2025-12-27

Added

• Categories Management UI - Full CRUD for blog categories in the admin dashboard.
• Author Personnel System - Migration of authors from JSON to D1 with a dedicated management UI.
• SEO & Social Preview - Real-time Google Search and Social Card preview in the blog editor.
• Post View Tracking - Automatic view count incrementation for public posts.
• Scheduling Logic - Backend logic to hide "Published" posts until their scheduled_date has passed.
• Database Migration 023 - Expanded posts table and added categories, authors, media, and blog_settings.

Changed

• Blog UI - Public blog posts now display featured images, categories, and view counts.
• Admin Navigation - Reorganized blog section to include Taxonomy (Categories) and Personnel (Authors).
• Type Safety - Improved API route typing and explicitly casted JSON responses.

[Unreleased]

Planned for v0.4.1+

• Version alignment and documentation updates
• Admin dashboard standardization and polish
• Content management improvements (draft/published status, bulk actions)
• Performance and build optimization
• Authentication system (Clerk integration - CRITICAL FOR BETA)
• Beta preparation and genericization
• Testing and validation suite

v0.5.0 Beta Target Features

• Proper admin authentication (replacing Cloudflare Access)
• Role-based access control (Owner, Admin, Editor)
• Genericized codebase (removed Lizardware-specific branding)
• Complete end-user documentation
• Security audit and testing

[0.3.3] - 2025-12-26

Added

• White-Label Footer Support - Optional "Powered by Lizardware CMS" attribution with whiteLabel prop
• Blog Post Status System - Draft vs Published status toggle for blog posts
• Database Migration 022 - Added post status tracking to database
• Generic Template Content - Removed hardcoded "Lizardware" branding from service pages and templates

Changed

• Mobile Navigation - Improved header and admin header responsiveness
• Blog Editor - Enhanced with status management UI
• Quick Start Guide - Updated with latest deployment instructions
• Documentation Generation - Improved generate-docs.js script

Fixed

• Mobile navigation display issues on smaller screens
• Generic content references to maintain white-label readiness

Purpose: Alpha release preparation - ensuring site name/logo editing, page management, and white-label capabilities for first external tester.

[0.4.0] - 2025-12-30

Summary

Milestone Release: Consolidated work from v0.2.x releases into v0.4.0 baseline. This version represents completion of Phase 3 (Admin Foundation) and partial Phase 4 (Content Management Suite) features.

Added - Authentication (Critical)

• Authentication: Clerk integration, Role-Based Access Control (RBAC).
• Security: Middleware protection for /admin routes.
• User Management: /admin/profile and role badges.
  Consolidated work from v0.2.x releases into v0.4.0 baseline. This version represents completion of Phase 3 (Admin Foundation) and partial Phase 4 (Content Management Suite) features.

Added - SEO Toolkit

• URL redirect management (301/302) with admin UI
• Robots.txt editor
• SEO setup wizard (6-step flow)
• Meta tag management (Open Graph, Twitter Cards)
• XML sitemap auto-generation
• SEO health score dashboard
• Database tables: redirects, seo_config, seo_global_settings, seo_checkups, robots_txt

Added - Theme System

• Theme Transformer with advanced controls:
  • 7-shade color system with 10 swatches
  • Hero gradient system (start/end colors)
  • 4 Artstyle presets (Quick theme switching)
  • Design architecture controls (navbar height, spacing, shadows, corners)
  • Real-time preview synchronization
• Appearance Dashboard:
  • Theme preset system (4 built-in: Lizard Classic, Midnight Pro, Nature's Edge, Clean Minimal)
  • Social links configuration
  • Layout settings (nav style, footer config)
  • Custom CSS injection
• Visual Identity System:
  • Logo and favicon management
  • Banner and social media assets
  • Typography controls

Added - Content Platform

• Pages Editor: MDX-based custom page creation with full CRUD
• Template System: 5 industry templates (MSP, Restaurant, Blogger, Service, Healthcare)
• Setup Wizard: 6-step onboarding (template selection, site info, environment config)
• Feature Flags: Database-backed feature management
• Storage Abstraction: MediaStorage interface with GitHub/R2 scaffolding
• Advanced Settings Dashboard: Template switcher, env vars UI, feature toggles

Changed

• Admin tool names rebranded with creative, alliterative naming
• Navigation structure reorganized (Blog top-level, docs categorized)
• Dark mode for Next.js/Turbopack error overlay
• Header component now responsive to --spacing-header CSS variable

Fixed

• Setup wizard input focus bug
• Theme API errors during template application
• KV migration errors
• D1 database integration issues
• ESLint warnings reduced to 0 errors

Database Migrations

• Posts, pages, site_config, feature_flags
• SEO tables (010-013, 021)
• Forum prep work: migrations 014-020 (deferred to Phase 8 post-Beta)
• Setup lock mechanism (007)

Added

• Theme Selector v0.2.3 - Major theming system overhaul
  • Advanced color picker with theme shades and classic swatches
  • Floating color panel with visual shade selection
  • Hero gradient system with start/end color controls
  • Gradient toggle for hero sections
  • Quick Artstyles preset system for rapid design changes
  • Redesigned UI with creative workflow language
  • Real-time preview synchronization status indicator
  • Fixed sidebar layout with sticky header and footer
• Design Architecture Controls - Comprehensive spacing and styling
  • Navbar height slider (2rem - 6rem) now controls actual header height
  • Section Breath slider (0.25rem - 8rem) for vertical spacing
  • Inner Padding controls for container spacing
  • Element Gaps for grid/flex layouts
  • Shadow Density slider for elevation effects
  • Corner Roundness presets (0, 0.25, 0.5, 0.75, 1, 1.25rem)
• Developer Experience Improvements
  • Dark theme for Next.js/Turbopack error overlay
  • Comprehensive error styling to prevent eye strain during development
  • CSS variables for all design tokens

Changed

• Header Component - Now responsive to --spacing-header CSS variable
• Theme Transformer UI - Reorganized with sections:
  • Global Atmosphere (light/dark mode toggle)
  • Quick Artstyles (theme presets)
  • Canvas & Backdrop (site backgrounds)
  • Reading Experience (typography colors)
  • Navigation & Identity (header/footer)
  • Component Ecosystem (info boxes, CTAs)
  • Impact Elements (hero section with gradient support)
  • Design Architecture (spacing, shadows, radius)
• Theme Variable Injection - Enhanced preview listener with all variables
  • Added hero gradient variables
  • Improved sidebar CSS variable scope
  • Better real-time sync

Fixed

• Navbar Height slider now correctly controls height (previously controlled width)
• Section Breath range updated to include fractional values (0.25, 0.50, 0.75, 1, 1.25)
• Element Gaps minimum changed from 0.5 to 0.25 for finer control
• Rounded corners updated to use 1.25rem instead of 1.5rem
• Theme Transformer sidebar scroll behavior (fixed header/footer)
• Hero gradient colors now properly sync to preview

[0.2.3] - 2025-12-20

Added

• Theme Selector Branch - Advanced color picker development
• Initial gradient support implementation
• Color picker UI with swatches and shades

[0.2.2] - 2025-12-20

Added

• Appearance Settings Dashboard - New centralized UI at /admin/appearance
  • Site Identity: Logo, favicon, and banner/OG image management
  • Social Links: GitHub and Twitter/X integration
  • Display & Layout: Default color mode, navigation bar style, footer configuration
  • Advanced Customization: SEO defaults (title template, meta description), custom CSS
  • Collapsible sections using ThemeSection component
  • Cross-linking to Theme Transformer for granular design control
• Theme Presets System - 4 pre-built themes
  • Lizard Classic (signature slate/orange)
  • Midnight Pro (high-contrast violet)
  • Nature's Edge (earth-toned green)
  • Clean Minimal (neutral blue)
• Hero Section Theming - Dedicated controls
  • Hero background color
  • Hero text color
  • Integration with theme presets

Changed

• Navigation label updated from "Settings" to "Documentation"
• Admin dashboard now links to Appearance hub

[0.2.1] - 2025-12-20

Changed

• Feature Pages Content - Professional, detailed content for all 6 feature pages
• Enhanced descriptions with real-world examples and use cases
• Added specific benefits and metrics to performance and security features

[0.2.0] - 2025-12-19

Added

• Site Template System - Industry-specific quick-start templates
  • 5 templates: MSP, Restaurant, Blogger, Service Industry, Healthcare
  • Each template includes custom navigation, theme presets, and feature configurations
• Setup Wizard - 6-step onboarding flow for new sites
  • Welcome screen with feature highlights
  • Template selection with preview
  • Site information collection
  • Environment configuration
  • Review and confirmation
  • Completion with quick actions
• Feature Flag System - Database-backed feature management
  • Toggle features on/off per site
  • Supports: blog, gallery, newsletter, monetization, comments, service pages, menu, booking, customer portal, analytics
• Environment Configuration - Deployment settings management
  • Site URL configuration
  • Cloudflare Account ID
  • Storage provider selection (GitHub/R2)
  • GitHub token and repository (optional)
  • Creates .env.local automatically
• Storage Abstraction Layer - Dual provider support
  • MediaStorage interface for pluggable storage
  • GitHub storage implementation (scaffolded)
  • R2 storage implementation (scaffolded)
  • Factory pattern for runtime provider selection
• Advanced Settings Dashboard - Central configuration UI at /admin/advanced
  • Template switcher
  • Site information editor
  • Environment variables UI
  • Feature toggle controls
  • Reset to defaults option

Added - Core

• Next.js App Router migration (from Pages Router)
• Route Groups: (pages), (categories), (admin) organization
• Component architecture: ui/, layout/, sections/ folders
• Logic separation: src/lib/ utilities
• TypeScript strict mode enabled
• Tailwind CSS 4 integration
• Dark Mode: Persistent theme switching with next-themes
• Metadata System: Proper SEO for all pages
• Favicon: Site branding improvements

Changed

• Admin Dashboard Rebranding - Creative, alliterative tool names
  • Blog Editor → Blazing Blogger 🔥
  • Pages Editor → Page Playground 🎪
  • Theme Engine → Theme Transformer ✨
  • Navigation Editor → Nifty Navigation 🧭
  • General Settings → Settings Studio 🎛️
  • Integrations → Sync Station 🔄
  • Site Analytics → Traffic Tracker 📊
  • Monetization Engine → Revenue Reactor 💸
  • Activity Logs → History Hub 📜
• Navigation Structure - Reorganized for better UX
  • Blog moved to top-level navigation
  • Documents organized into categories (Getting Started, Configuration, Content Management, Help)
  • Services renamed to Features with CMS-focused content
• Version Bumped - From 0.1.7 to 0.2.0 (major feature release)

Fixed

• Setup Wizard Input Focus Bug - Fixed React re-render causing focus loss in form fields
• Theme API Error - Fixed error when applying template theme colors
• Blog API MDX Fallback - Improved error handling for missing content
• Navigation 404 Errors - Fixed markdown rendering with marked library
• Documentation Rendering - Enhanced GitHub-style markdown styling

[0.3.0] - 2025-12-20

Added - Admin Dashboard & Blog Engine

• D1 database integration with hybrid storage (D1 + MDX)
• Blog API endpoints (full CRUD operations)
• MDX pipeline with frontmatter support
• WYSIWYG editor (Tiptap) with custom CSS styling:
  • H5/H6 headers, horizontal rules, clear formatting
  • Code blocks, task lists, text alignment
  • Link, image, and table support
• GitHub API integration for Git-backed storage
• Author & tag taxonomy with directory/detail pages
• Slug UX (auto-populate from title, manual override)

Added - Admin UI

• Cloudflare Access protection
• Blog post editor with live preview
• Theme editor with semantic color controls
• Navigation config editor (JSON-backed)
• Site config editor (SEO, branding, social)
• Monetization admin (AdSense, Amazon, banners)

Infrastructure

• Tooling upgrades (npm audit, dependencies)
• Build optimization (OpenNext --noMinify)
• KV-based theme loading for Cloudflare Workers
• Next.js 15.1.3 compatibility documented

Added

• Pages Editor - WYSIWYG editing for static pages
  • Admin UI at /admin/pages with list and editor views
  • D1 database integration for page metadata
  • MDX-based page storage architecture
  • API routes: /api/admin/pages/*
• D1 Database Migrations - Structured schema changes
  • Pages table with metadata
  • Migration tracking

Fixed

• Theme Editor 500 Errors - KV migration complete
• Config Editor 500 Errors - KV migration complete
• Blog Editor GitHub Token Errors - D1 migration complete
• ESLint Warnings - Reduced to 0 errors

Changed

• KV Storage Migration - Theme and config now use Cloudflare KV for production
• Build Optimization - OpenNext deployment improvements

Added

• Dark Mode: Persistent theme switching with next-themes
• Metadata System: Proper SEO for all pages
• Favicon: Site branding improvements

Fixed

• Build Errors - Resolved local development issues
• Deployment Pipeline - Cloudflare Pages integration working

[0.1.5] - 2025-12-09

Added

• Blog Publishing Workflow - Enhanced WYSIWYG editor
  • Tiptap editor with custom styling
  • H5/H6 support, horizontal rules, clear formatting
• MDX Content Support - Hybrid D1 + MDX storage
• Author & Tag Taxonomy - Directory and detail pages

Changed

• Navigation Layout - Improved responsive design
• Component Architecture - Organized into ui/, layout/, sections/

[0.1.0] - 2025-12-10

Initial Release

• GitHub repository setup
• Cloudflare Pages + Workers deployment pipeline
• Lizardware brand identity (logo, colors, typography)
• Dark mode with next-themes persistence
• Basic blog engine (D1 + MDX)
• Admin dashboard skeleton
• Navigation management
• Responsive dark/light theme system

Added

• Initial Release - Lizardware CMS launched
• Next.js 15 - Modern React framework with App Router
• Cloudflare Pages - Edge deployment
• Cloudflare Workers - Serverless API routes
• D1 Database - SQLite at the edge
• Blog Engine - CRUD operations for blog posts
• Admin Dashboard - Protected with Cloudflare Access
• Theme Customization - Visual theme editor
• Navigation Management - JSON-backed navigation config
• Site Configuration - SEO, branding, social settings
• Monetization - AdSense, Amazon Affiliates integration
• Tailwind CSS 4 - Utility-first styling

---

Version Numbering Strategy (Updated Dec 26, 2025)

Moving Forward:

• v0.4.x - Quick wins + Beta preparation (current phase)
• v0.5.0 - BETA RELEASE 🚀 (target milestone)
• v0.6.x - Beta improvements
• v0.7.x - White-label & polish
• v1.0.0 - Production release (stable, public)

Increment Rules:

• Patch (0.4.X): Bug fixes, minor improvements
• Minor (0.X.0): New features, major milestones
• Major (X.0.0): Production-ready releases

Current Version: 0.4.0 (SEO Toolkit & Theme System)
Next Milestone: 0.5.0 (First Public Beta Release)

Roadmap Alignment Note:
As of December 26, 2025, version tracking is now strictly aligned with the roadmap. All changes will be properly versioned and committed to Git.

---

Last Updated: January 3, 2026
Branch: main