> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weaverse.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Latest updates, features, and improvements to Weaverse SDK, Studio, and themes.

# Weaverse Changelog

Stay up-to-date with the latest features, improvements, and bug fixes across the entire Weaverse ecosystem.

<Update label="2026.5.6" description="May 6, 2026" tags={["API"]}>
  ### Bug Fixes

  * **Content API OpenAPI Spec**: The `/api/v1/content/openapi.json` endpoint was returning 500. It now serves the full OpenAPI 3.1 specification, ready to import into Swagger UI, Postman, or any OpenAPI code generator.
  * **OpenAPI Spec Documents Portable Text Parameter**: The `?format=portable-text` query parameter (shipped in 2026.5.4) is now formally documented for both the page and theme-settings endpoints, including the alternative `Accept: application/portable-text+json` header and the optional `?meta=true` flag.

  ### Improvements

  * **Security**: Patched several upstream dependency vulnerabilities affecting build and runtime libraries.
</Update>

<Update label="2026.5.5" description="May 4, 2026" tags={["Studio"]}>
  ### New Features

  * **Editor Layout Redesign**: Reworked the Studio workspace for better responsiveness and discoverability
    * Redesigned topbar with unified page search, grouped pages, and store URL tabs
    * Version history moved to the left sidebar with a refreshed panel
    * New browser bar and preview URL selector with inline performance scores
    * Studio settings popover consolidates preferences, project, and activity tabs

  * **New Weaverse Dashboard**: Comprehensive dashboard redesign with a cleaner, flatter visual style
    * More breathing room with a wider layout and unified visual rhythm
    * New sidebar with an inline release-notes widget

  * **Snappier Template Assignment Picker**: Reworked for better responsiveness and predictability
    * Cancel or Close cleanly discards edits without partially saving
    * No more duplicate loading between the "All" and "Assigned only" views

  ### Improvements

  * **More Consistent Studio Reactivity**: Reworked how Studio tracks page, locale, template assignment, device, and sidebar state. No visible UI change — a foundational improvement that unlocks smoother behavior across upcoming features.
</Update>

<Update label="2026.5.4" description="May 2, 2026" tags={["API", "Studio"]}>
  ### New Features

  * **Portable Text Content API**: Opt-in `?format=portable-text` (and `Accept: application/portable-text+json`) on the page and theme-settings endpoints
    * Default `weaverse` format unchanged — zero migration for existing integrations
    * Rich-text fields convert from HTML strings to structured [Portable Text](https://www.portabletext.org/) blocks for multi-channel rendering and AI consumption
    * Optional `?meta=true` on the page endpoint adds `_weaverse: { id, schemaVersion }` to each custom block for round-tripping
    * See [Get Page › Portable Text format](/content-api/get-page#portable-text-format) for the full mapping

  ### Bug Fixes

  * **Multi-Store Studio 404**: Fixed 404s when switching between stores in a multi-store account — Studio now resolves the active shop directly from the URL.

  ### Improvements

  * **Accessibility**: Loading buttons now expose an `aria-busy` state, so screen readers announce when an action is in flight.
</Update>

<Update label="2026.4.22" description="April 22, 2026" tags={["Studio", "API"]}>
  ### New Features

  * **Agent Discovery Endpoints**: 12 new `.well-known/*` endpoints for AI bot interoperability — API catalogs, agent skill discovery, MCP server cards, and machine-readable site metadata. Aligned with the [isitagentready.com](https://isitagentready.com) audit so AI agents can reliably discover and interact with Weaverse Studio.

  * **Public Custom Pages API**: New unauthenticated endpoint for sitemap and crawler integrations
    * `GET /api/public/v1/projects/:projectId/custom-pages` — returns paginated, locale-filtered published custom pages
    * CDN-cacheable and rate-limited (60 req/min per IP per project)

  ### Improvements

  * **Faster, Cheaper Translation Calls**: Disabled redundant model reasoning that was adding latency and cost without improving translation quality.

  * **More Reliable Translation Fallbacks**: Default-locale fallbacks now merge cleanly with translated bundles — untranslated keys consistently fall back to the default value rather than appearing as raw keys.
</Update>

<Update label="2026.4.21" description="April 21, 2026" tags={["Studio"]}>
  ### New Features

  * **Session Drafts**: Edits now live in session draft state until you explicitly save — fewer interruptions while editing, and you stay in control of when changes commit.

  ### Bug Fixes

  * **Studio Refresh Race**: Fixed UI flicker and occasional lost edits when background updates landed mid-keystroke.
</Update>

<Update label="2026.4.10" description="April 10, 2026" tags={["Studio", "Translation"]}>
  ### New Features

  * **Translation Feature Launch**: Rolled out the full translation system to production
    * Manage translated content per locale across pages and theme settings
    * See the [translation guide](/features/translation) for setup details

  ### Improvements

  * **Unified Subscription Status**: Subscription enforcement messages now surface consistently in both the Dashboard and the Studio. The modal no longer re-fires on every navigation, and dismissal continues to respect the 24-hour cooldown for non-blocking notices.

  * **More Accurate Usage Reporting**: Usage counts now match billed traffic more closely — the previous bot-filtering layer was undercounting real visits.

  ### Bug Fixes

  * **Store Index Redirect**: Added a redirect at the store index and fixed the dashboard return button
  * **Staging Domain**: Prevented the staging environment from redirecting to the production domain
</Update>

<Update label="2026.4.8" description="April 8, 2026" tags={["Studio", "Marketing"]}>
  ### New Features

  * **Blog Listing Improvements**: Refreshed blog index UX
    * "View More" and "View All" buttons in the top-right of each section
    * Pagination shows a clickable page-number list with previous/next arrow icons
    * Improved toolbar: labeled search on the left, series dropdown, and labeled sort
    * Buttons and inputs unified to rounded shapes for consistency
    * Clear (X) button on the search input

  * **Blog Details Improvements**: Refined article reading experience
    * Table of contents is now scrollable while reactions stay visible below
    * Discussion section forced to light theme for readability
    * Fixed tooltip overflow on reactions
    * Reactions: server-side negative-value safeguard, client-side fetch, and auto-revalidation on window focus

  * **Smarter Lifecycle Emails**: Plan changes, uninstalls, and reinstalls now drive the right mailing-list segments automatically — you'll receive only the messages that match your current state.
</Update>

<Update label="2026.4.3" description="April 3, 2026" tags={["Studio"]}>
  ### Improvements

  * **Store Handle Resolution**: Resolve the store handle from the current request URL first for more predictable multi-store behavior

  ### Bug Fixes

  * **Staging Environment**: Improved staging deploys with more reliable build steps
  * **Public Demo Route**: Fixed routing for the public demo route
  * **Deploy Timeout**: Increased timeout tolerance to prevent intermittent deploy failures
</Update>

<Update label="2026.4.1" description="April 1, 2026" tags={["Studio"]}>
  ### New Features

  * **Multi-Store Session Isolation**: Agencies can now work with multiple Weaverse storefronts simultaneously in the same browser
    * Session cookie stores a `shops` map per store handle — no more overwriting when switching stores
    * Store-scoped URLs follow the familiar Shopify Admin pattern (`/store/{store_handle}/...`)
    * OAuth flow adds stores additively to the session map without disrupting existing ones
    * **Store Switcher UI**: New store switcher in the dashboard topbar replaces the old profile dropdown
    * Legacy `/dashboard/*` and `/projects/:id` URLs auto-redirect to the correct store-scoped path

  * **Component Detectability Warning**: Studio now shows a warning when a component exists in data but can't be found in the DOM
    * Muted gray info icon appears on the selected outline item when `data-wv-id` is missing (e.g. `{...props}` not spread or component returns `null`)
    * Tooltip explains possible causes and links to documentation
    * Detection happens at selection time for better performance — no upfront DOM scanning during outline building

  ### Improvements

  * **Faster Studio Builds**: Upgraded the underlying bundler for noticeably quicker dev-server cold-starts and incremental rebuilds.

  * **Smoother Editor Inputs**: Eliminated lag in continuous controls (color picker, range slider) — inputs now stay buttery-smooth even on long editing sessions.

  ### Bug Fixes

  * **Localization Reset**: Fixed a critical bug where resetting a localized page could delete the original default page instead of only the localized clone. A server-side guard now refuses any reset that would touch the default page.

  * **Translation API Security**: Hardened authentication on the translation API — all internal endpoints now require project access. The public storefront-facing endpoint is unchanged.

  * **Editor Stability**: Fixed sporadic errors during navigation and unmount, and updated AI model versions.
</Update>

<Update label="2026.3.26" description="March 26, 2026" tags={["API"]}>
  ### New Features

  * **Content API**: New authenticated REST API for headless content access
    * `GET /api/v1/content/projects` — list all projects in your shop
    * `GET /api/v1/content/projects/:projectId/pages` — list page assignments with type/locale filtering
    * `GET /api/v1/content/projects/:projectId/pages/:type/:handle` — get full page content with component items
    * `GET /api/v1/content/projects/:projectId/theme-settings` — get theme design tokens
    * `GET /api/v1/content/openapi.json` — OpenAPI 3.1 specification

  * **API Key Authentication**: Bearer token authentication scoped per shop
    * Cached token validation (5-minute TTL) for fast lookups
    * Per-shop access control prevents cross-tenant data leakage

  * **Usage Tracking**: Billing-integrated API metering
    * API hits share the same billing pool as storefront page views (1 request = 1 page view)
    * Non-blocking tracking with zero latency impact on responses

  * **Cursor-Based Pagination**: Efficient pagination for list endpoints
    * Base64-encoded cursors for stable iteration
    * Configurable page size (default 50, max 100)

  * **Locale Fallback**: Automatic locale resolution for page content
    * Falls back from requested locale to project default to English

  See the [Content API documentation](/content-api/overview) for full details and code examples.
</Update>

<Update label="2026.2.5" description="February 5, 2026" tags={["Studio", "SDK", "Theme"]}>
  ### Weaverse Studio

  #### New Features

  * **AI Agents Section**: Enhanced AI assistant capabilities
    * Improved AI agent management interface
    * Better integration with development workflows

  * **Dashboard Redesign**: Updated dashboard experience
    * Enhanced project organization and navigation
    * Improved visual hierarchy and user flow

  * **Import/Export**: Enhanced project portability
    * Improved import/export functionality for projects
    * Better handling of project data migration

  * **Page History & Scheduling**: Enhanced content management
    * Updated page history revision tracking
    * Improved scheduling feature for content publishing

  #### Improvements

  * **Billing & Pricing**: Updated pricing structure
    * Daily billing capping for better cost control
    * Enhanced pricing page with clearer information

  ***

  ### Weaverse SDKs

  #### Improvements

  * **Schema Simplification**: Removed deprecated input types
    * Removed 'swatches' input type (use color picker alternatives)
    * Cleaner schema definitions with reduced complexity

  #### Package Updates

  * **All SDKs**: Released v5.9.1 with internal improvements

  ***

  ### Weaverse Pilot Theme

  #### New Features

  * **Klaviyo Integration**: Enhanced email marketing
    * Improved newsletter signup flow
    * Better customer data synchronization

  #### Improvements

  * **Add-on Pricing**: Corrected add-on price calculations
    * Fixed pricing display for product add-ons
    * Better handling of variant pricing

  * **Account Dashboard**: Enhanced styling
    * Improved account page layout
    * Better responsive design
</Update>

<Update label="2026.1.10" description="January 10, 2026" tags={["Studio", "Theme"]}>
  ### Weaverse Studio

  #### New Features

  * **Shopify Admin API Proxy**: Powerful new API integration for advanced Shopify functionality
    * New `/api/admin-graphql` endpoint with built-in rate limiting and caching
    * Proper error handling for reliable Shopify Admin API requests
    * Enhanced proxy caching layer for improved performance
    * Complete type definitions for type-safe development

  * **Optional Scopes Authorization**: Enhanced permission management for Shopify apps
    * Visual UI for managing Shopify app permissions with selectable scopes
    * Authorization flow via `admin.shopify.com` for secure access control
    * Granular control over app capabilities and store access
    * Revamped account settings interface with scope management

  * **Maison Theme**: New professional theme option for Hydrogen storefronts
    * Modern design with enhanced visual appeal
    * Optimized performance and improved integrations
    * Production-ready with full Weaverse Studio support

  #### Improvements

  * **Studio Architecture Overhaul**: Complete restructuring for better maintainability
    * Restructured studio modules and features for clearer organization
    * Improved import paths with better modularity
    * Enhanced dashboard editor with new data binding hooks
    * Refined component structures for optimal performance

  * **Dashboard Enhancements**: Cleaner interface and better user experience
    * Updated dashboard routes with improved navigation
    * Removed unused dependencies and hooks for faster loading
    * Enhanced error handling components with better feedback
    * Optimized consent and binding context management

  * **Development Workflow**: Improved local development experience
    * Custom Shopify app runner with tunnel support (`shopify-runner.mjs`)
    * Updated dev configuration files (`shopify.app.dev.toml`, `shopify.web.toml`)
    * Enhanced documentation with Bun-based setup instructions
    * New rate limiting documentation for API proxy

  #### Deprecations

  * **Sections App Deprecated**: Legacy sections app functionality removed
    * Migrate to component-based architecture for better flexibility
    * Improved theme development workflow with modern patterns

  ***

  ### Weaverse Pilot Theme

  #### Improvements

  * **Code Quality**: Enhanced Tailwind class organization with Biome
    * Updated package dependencies for better compatibility
    * Fixed package lock file inconsistencies
    * Improved build stability and performance

  #### Version Update

  * **Pilot Theme**: v7.1.2 with maintenance updates and optimizations
</Update>

<Update label="2025.11.30" description="November 30, 2025" tags={["Studio", "SDK", "Theme", "Docs"]}>
  ### Weaverse Studio

  #### New Features

  * **Project Hierarchy & Variants**: Create multiple versions of your store with automatic content inheritance
    * Build seasonal storefronts, A/B test layouts, or support multiple markets from one parent project
    * Content automatically flows from parent to variants with option to override specific pages
    * Visual badges clearly show variant relationships in project cards
    * Quick variant switcher for easy navigation between versions

  * **Enhanced Dashboard Experience**: Complete dashboard redesign with better organization
    * New horizontal card layout with improved information density and visual hierarchy
    * Search and filter functionality to quickly find projects
    * Sort options for better project organization
    * Variant badges and parent project indicators at a glance

  * **Improved AI Assistant**: More reliable AI chat for building your store
    * Faster response times and better suggestions
    * Improved context understanding for more relevant help
    * Enhanced reliability when assisting with theme development

  #### Improvements

  * **Locale Enhancements**: Better internationalization support
    * Improved locale selector with clearer UI
    * Enhanced fallback logic for page assignments
    * Better article search for multi-language stores
    * Fixed locale detection and validation

  #### Bug Fixes

  * **Project Configuration**: Fixed null theme handling in project validation
  * **Content Management**: Improved page assignment locale handling
  * **Security**: Improved Shopify mandatory GDPR webhooks for compliance
  * **Data Persistence**: Better error handling in variant creation and updates

  ***

  ### Weaverse SDKs

  #### New Features

  * **Multi-Project Architecture**: Full support for project hierarchy
    * SDK packages support inheritance metadata in API responses
    * Enhanced HydrogenPageAssignment type with variant information
    * Improved type safety for parent-child project relationships

  #### Improvements

  * **WeaverseClient Optimization**: Major refactor for better maintainability
    * Enhanced caching strategy with improved fallback page behavior
    * Better localhost detection for local development
    * Optimized type safety and error handling
    * Clearer code structure for easier maintenance

  * **Package Updates**: Synchronized releases across ecosystem
    * Core packages: v5.7.0 → v5.9.0
    * React package: v5.7.0 → v5.9.0
    * Hydrogen package: v5.7.0 → v5.9.0
    * Shopify package: v5.7.0 → v5.9.0 (archived, no longer maintained)
    * Schema package: v0.7.3 (independently versioned)

  #### Bug Fixes

  * **API Response Handling**: Restored fallback page behavior for invalid responses
  * **Schema Validation**: Improved integration with @weaverse/schema package
  * **Multi-Project Support**: Enhanced test coverage and validation

  ***

  ### Weaverse Pilot Theme

  #### New Features

  * **Complete Cart Overhaul**: Enhanced shopping cart functionality
    * Discount code handling with apply/remove functionality
    * Gift card redemption support in cart summary
    * Cart note functionality for special instructions
    * Improved loading states with better user feedback

  * **Cart Summary Improvements**: Better discount and pricing display
    * Redesigned discount code display with clear messaging
    * Gift card management with add/remove capabilities
    * Clearer pricing breakdown with taxes and discounts
    * Enhanced button spinner animations

  #### Improvements

  * **Input Components**: Consistent form design system
    * Updated input and textarea styles across theme
    * Enhanced quantity inputs with better validation
    * Restructured CSS with default styles for inputs
    * Improved form validation and error states

  * **Dependencies**: Updated to latest SDK versions
    * @weaverse/hydrogen: v5.9.0
    * @weaverse/schema: v2.3.6
    * Enhanced Biome configuration with @weaverse/biome
    * Updated React Router to v7.9.6

  #### Version Update

  * **Pilot Theme**: v7.1.1 with enhanced cart and form improvements

  ***

  ### Documentation

  #### New Features

  * **Cloudflare Workers Deployment Guide**: Complete step-by-step guide for deploying Pilot theme to Cloudflare Workers
    * Comprehensive configuration instructions for React Router and Vite
    * Environment setup with wrangler.json best practices
    * Pre-deployment validation and testing workflows
    * Custom domain configuration and Git-based auto-deployment
    * Troubleshooting guide and performance optimization tips
</Update>

<Update label="2025.10.31" description="October 31, 2025" tags={["Studio", "SDK", "Theme"]}>
  ### Weaverse Studio

  #### New Features

  * **Improved AI Assistant**: More reliable AI chat with automatic failover
    * Always available when you need help building your store
    * Faster response times and better code suggestions
    * Smarter understanding of your theme structure

  * **Better Preview Experience**: Enhanced error overlay with auto-dismiss
    * Clearer error messages help you fix issues faster
    * Transient errors disappear automatically
    * Smoother theme editing workflow

  * **Faster Performance**: Global performance improvements
    * Faster loading times across all Studio features
    * Reduced latency for international users
    * More responsive editing experience

  #### Improvements

  * **Smoother Billing**: Improved subscription management
    * Easier plan changes and upgrades
    * Better error handling during checkout
    * Clearer pricing and overage information

  #### Bug Fixes

  * **Better Stability**: Fixed connection and template issues
    * More reliable saving and publishing
    * Improved template assignment handling
    * Enhanced email notification delivery

  ***

  ### Weaverse SDKs

  #### Improvements

  * **91% Faster Performance**: Major speed improvement for data connectors
    * Your storefronts load significantly faster
    * Better customer experience with reduced page load times
    * More efficient data processing

  #### Package Updates

  * **All SDKs**: Updated to v5.7.1 with performance optimizations

  ***

  ### Weaverse Pilot Theme

  #### New Features

  * **Modern Navigation**: New menu system with smooth interactions
    * Enhanced dropdown menus with hover support
    * Fully accessible navigation
    * Custom animations for polished experience

  * **Review Integration**: Enhanced Judge.me reviews display
    * Better review images and layout
    * Improved product page integration
    * More consistent review experience

  * **Complete Account System**: Full customer account management
    * Account dashboard with order history
    * Enhanced address management
    * Better form validation and error handling

  #### Improvements

  * **Better Mobile Experience**: Enhanced responsive design
    * Improved layouts on all screen sizes
    * Smoother interactions on touch devices
    * Enhanced footer and navigation

  #### Bug Fixes

  * **UI Improvements**: Fixed visual issues
    * Resolved popover scroll problems
    * Fixed header and slideshow layering
    * Better external link handling

  #### Version Update

  * **Pilot Theme**: v7.1.0 with enhanced navigation and account features
</Update>

<Update label="2025.10.01" description="October 1, 2025" tags={["Studio", "Docs"]}>
  ### Developer Documentation

  #### Improvements

  * **Easier Navigation**: Completely redesigned documentation structure makes it faster to find what you need
    * Improved search functionality helps you discover features and solutions quickly
    * Better organized content with clearer categories and sections
    * Enhanced mobile experience for learning on the go
    * Modern design with improved readability and code examples

  * **Updated Community Support**: Easier ways to get help and connect with other developers
    * Join our new Slack community for real-time support and discussions
    * More responsive community engagement from the Weaverse team
    * Better resources for troubleshooting common issues

  * **Modernized Guides**: All tutorials and examples updated to current best practices
    * Code examples aligned with React 19 patterns
    * Fixed outdated links and references throughout documentation
    * Clearer explanations and step-by-step instructions

  ***

  ### Weaverse Studio

  #### New Features

  * **Flexible URL Redirects**: Create more powerful redirect rules for your storefront
    * Support for dynamic path forwarding to handle complex URL structures
    * Better control over how legacy URLs redirect to new pages

  #### Bug Fixes

  * **Improved Reliability**: Fixed issues that could cause unexpected behavior when working with templates
    * Better handling of saved templates and page assignments
    * More stable editing experience with fewer interruptions
</Update>

<Update label="2025.09.25" description="September 25, 2025" tags={["Studio", "SDK", "Theme"]}>
  ### Weaverse SDKs

  #### New Features

  * **Data Connectors**: Powerful new feature to create dynamic content in your components
    * Bind any text field to data from your Shopify store (products, collections, pages, etc.)
    * Reference data from anywhere in your theme using simple template syntax
    * Build components that automatically update when connected data changes
    * Works seamlessly with product data, collection information, and custom page content

  #### Improvements

  * **Faster Performance**: Significant speed improvements for your production storefronts
    * Optimized data loading and component rendering
    * Reduced page load times for better customer experience
    * Smaller bundle sizes mean faster downloads

  * **Better Developer Experience**: Improved tools and feedback while building your theme
    * Enhanced autocomplete and type checking in your code editor
    * Clearer error messages when something goes wrong
    * More reliable theme development workflow

  #### Package Updates

  * **All SDKs**: Updated to v5.5.0 with data connector support and performance improvements

  ***

  ### Weaverse Studio

  #### New Features

  * **Data Connector Interface**: Visually connect your components to dynamic data without writing code
    * Point-and-click interface to select data from your Shopify store
    * Real-time preview of connected data as you build
    * Autocomplete suggestions make it easy to find the right data
    * Support for complex data paths to access nested information

  #### Improvements

  * **Polished Editing Experience**: Multiple refinements to make theme editing smoother
    * Cleaner, more intuitive input fields across all components
    * Improved URL picker for easier link management
    * Better rich text editor that preserves your formatting
    * More responsive interface with better layout

  #### Bug Fixes

  * **Reliable Saving**: Fixed issue where saving changes could cause unexpected page reloads
  * **Text Editor**: Corrected formatting issues in the rich text editor
  * **Data Binding**: Improved handling of complex data paths and special characters

  ***

  ### Weaverse Pilot Theme

  #### Improvements

  * **Data Connector Support**: Full support for the new data connector feature
    * Example components showing how to use data connectors effectively
    * Updated to latest SDK with all performance improvements
    * Better integration with Weaverse Studio editing features
</Update>

<Update label="2025.09.08" description="September 8, 2025" tags={["Studio", "Theme"]}>
  ### Weaverse Studio

  #### Improvements

  * **Enhanced Preview URL Management**: Improved preview URL handling system with better type safety and error handling
    * Optimized preview URL system with server-side initialization for faster loading
    * Better error handling when preview URLs are not available or malformed
    * Improved reliability of preview functionality across different theme configurations
    * Streamlined preview URL setup process with clearer instructions for developers

  ***

  ### Weaverse Pilot Theme

  #### New Features

  * **Enhanced Judge.me Reviews Integration**: Complete review system overhaul with improved reliability
    * New `JudgemeReviewsBadge` component for better product review display
    * Improved API data handling with enhanced error management
    * Better review data fetching and display consistency across product pages

  #### Improvements

  * **Modular Product Page Architecture**: Complete refactor of product components for better maintainability
    * Refactored Main Product Section into focused, reusable components
    * Enhanced `ProductTitle`, `ProductVendor`, and `ProductPrices` components with cleaner interfaces
    * Improved component architecture with single-responsibility principle
    * Streamlined schema configurations for better customization options

  * **Enhanced Featured Products**: More flexible product collection options
    * Added collection-based product selection alongside manual selection
    * Improved product display flexibility and configuration options

  #### Version Updates

  * **Pilot Theme**: Updated to v5.7.0
  * **Dependencies**: Latest compatibility with Weaverse SDK and Shopify Hydrogen
</Update>

<Update label="2025.09.04" description="September 4, 2025" tags={["Studio", "SDK", "Theme"]}>
  ### Weaverse Studio

  #### New Features

  * **Hydrogen Deployment Guide**: Complete step-by-step guide to deploy your Hydrogen storefront to production
    * Direct links to Shopify Admin settings for seamless configuration
    * Integrated deployment workflow with clear instructions
    * Performance optimization guidance for faster storefronts
    * Self-service deployment reduces support wait times

  * **Modernized Dashboard**: Refreshed dashboard experience with improved usability
    * Cleaner project management interface with quick actions
    * Real-time changelog to stay updated on new features
    * Enhanced navigation and project switching
    * Better visual hierarchy and modern design elements

  #### Improvements

  * **Enhanced Performance**: Significantly faster loading times across the Studio interface
  * **Better User Experience**: Streamlined project creation with improved error handling
  * **Improved Mobile Preview**: More accurate mobile preview rendering and styling consistency
  * **Universal Theme Support**: Enhanced compatibility with all Hydrogen theme versions, including legacy themes

  #### Bug Fixes

  * **Editor Stability**: Fixed crashes that could occur when working with complex page layouts and nested components
  * **Production Reliability**: Resolved issues that could affect live website performance and loading
  * **API Connection**: Fixed intermittent connection issues that could interrupt editing sessions
  * **Content Loading**: Resolved problems with content files not loading properly in production environments

  ***

  ### Weaverse SDKs

  #### New Features

  * **Modern Caching System**: Upgraded to the latest caching technology for faster website loading
    * Improved cache strategies for better performance
    * Enhanced response validation and error handling
    * Optimized cache key generation for more efficient storage

  * **Flexible Configuration**: More options for configuring your Hydrogen storefront environment
    * Multiple fallback options for easier setup
    * Better environment variable handling
    * Simplified configuration process for developers

  #### Improvements

  * **Better API Performance**: Enhanced API responses with reduced loading times
  * **Improved Developer Experience**: Better error messages and debugging capabilities
  * **Updated Dependencies**: Latest compatibility with Shopify Hydrogen and React Router v7
  * **Enhanced Build Quality**: Improved code quality tools for more reliable builds

  #### Package Updates

  * **Core SDKs**: All packages updated to v5.4.2 for better consistency and compatibility

  ***

  ### Weaverse Pilot Theme

  #### Improvements

  * **Latest SDK Integration**: Updated to v5.6.0 with all new SDK improvements and features
  * **Enhanced Performance**: Faster loading times from improved caching and optimization
  * **Better Compatibility**: Full integration with latest Weaverse Studio features
</Update>

<Update label="2025.08.22" description="August 22, 2025" tags={["Studio", "SDK", "Theme"]}>
  ### Weaverse Studio

  #### Improvements

  * **Enhanced Billing Dashboard**: Improved billing transparency with real-time usage tracking, detailed overage calculations, and cost projections
  * **Better User Experience**: Continued improvements to Studio interface with faster loading times and better responsiveness
  * **Mobile Preview**: Better mobile preview accuracy and styling consistency for theme development

  ***

  ### Weaverse SDKs

  #### New Features

  * **CLI v4.0.0**: Complete modernization with interactive prompts and better developer experience
    * Interactive project setup with guided prompts for missing options
    * Enhanced template descriptions to help choose the right starting point
    * Improved error handling with actionable feedback
    * Better project creation output with clear next steps

  #### Improvements

  * **Comprehensive Documentation Overhaul**: Complete reorganization and modernization of all developer guides
    * Updated API documentation with latest patterns and best practices
    * Fixed broken internal links across the entire documentation site
    * Enhanced troubleshooting guides and FAQ updates
    * Improved navigation and content organization for better developer experience

  * **Enhanced Development Tools**:
    * **Biome v2.2.0**: Updated linting configuration with improved rules and performance
    * **Better TypeScript Integration**: Stricter type safety and improved IDE support for developers

  #### Bug Fixes

  * **CLI Stability**: Resolved various project creation and template selection issues
  * **Type Definitions**: Corrected TypeScript configurations for better developer experience

  #### Package Updates

  * **Core SDKs**: All packages synchronized at v5.3.4 for compatibility
  * **CLI**: Updated to v4.0.0 with breaking improvements
  * **Biome Config**: Released v1.6.0 with enhanced linting rules

  ***

  ### Weaverse Pilot Theme

  #### New Features

  * **Enhanced E-commerce Features**:
    * Combined Listings support for intelligent product grouping
    * Shopify Bundles integration with smart badge detection
    * Newsletter popup with Klaviyo integration and customizable timing
    * Enhanced product media zoom and variant selection

  #### Improvements

  * **Better Mobile Experience**: Improved responsive layouts and touch interactions
  * **Enhanced Product Display**: Better product cards, badges, and cart recommendations
  * **Performance Optimizations**: Faster loading times and reduced bundle size

  #### Bug Fixes

  * **Build Stability**: Resolved development server and build configuration issues
  * **Type Safety**: Fixed TypeScript definitions and integration issues
  * **Component Reliability**: Improved component state management and error handling

  #### Version Updates

  * **Pilot Theme**: Updated to v5.5.0
</Update>

<Update label="2025.08.12" description="August 12, 2025" tags={["Studio"]}>
  ### Weaverse Studio

  #### New Features

  * **Complete Studio Interface Redesign**: Revolutionary new design system with modern, intuitive interface and streamlined workflows
  * **Advanced AI Chat System**: Persistent conversations, reliable tool integration, and enhanced development assistance
  * **Enterprise Billing Transparency**: Real-time usage tracking with overage calculations and cost projections
  * **Professional Error Pages**: Beautiful 404 and error handling with clear navigation

  #### Improvements

  * **Enhanced Performance**: Faster loading times and better responsiveness across all Studio features
  * **Improved Mobile Preview**: Better styling and layout consistency for mobile theme previews
  * **Streamlined Navigation**: Simplified app structure with cleaner user flows

  #### Bug Fixes

  * **AI Chat Reliability**: Fixed deadlock issues that could freeze the AI assistant
  * **Studio Interface**: Resolved UI rendering and interaction issues
  * **Mobile Preview**: Fixed component backgrounds and responsive layouts
  * **Billing Accuracy**: Corrected Growth and Scale plan overage calculations
</Update>

<Update label="2025.07.22" description="July 22, 2025" tags={["Studio", "Theme"]}>
  ### Weaverse Studio

  #### New Features

  * **Brand New Dashboard**: Complete redesign with modern UI for better user experience
    * Beautiful animated welcome banner
    * Real-time changelog to stay updated
    * Improved project management with quick actions
    * Enhanced navigation and project switching
    * New billing and usage visualization
  * **AI Assistant (Beta)**: Free AI-powered coding assistant to help build Hydrogen stores faster
    * Context-aware chat interface with real-time code generation
    * Multi-mode support: general queries, code generation, and documentation search
  * **Account Management**: New settings page to manage API keys and personal access tokens
  * **Figma Integration**: Import designs directly from Figma with OAuth authentication

  #### Improvements

  * Significantly faster dashboard loading with optimized data fetching
  * Dark mode support across all new components
  * Better error messages and form validation

  #### Bug Fixes

  * Fixed AI chat interface stability issues
  * Improved authentication and project access validation

  ***

  ### Weaverse Pilot Theme

  #### New Features

  * **Quick Shop Modal**: Browse and select product variants without leaving collection pages
  * **Product Bundles Support**: Full Shopify bundles integration with badges and special cart handling
  * **Newsletter Popup**: Smart email capture with customizable timing and Klaviyo integration
  * **Enhanced Product Display**: New zoom functionality, dynamic badges, and improved variant selector

  #### Improvements

  * Switched to Cabin Variable font for better readability
  * Enhanced cart experience with bundle support
  * Implemented sorted Tailwind classes with Biome
  * Optimized image loading and pagination

  #### Bug Fixes

  * Fixed quick shop variant selection
  * Corrected logo visibility with transparent headers
  * Fixed pagination links and cart form submissions
  * Improved media zoom responsiveness
</Update>

<Update label="5.0.0" description="May 27, 2025" tags={["SDK"]}>
  ### MAJOR RELEASE: React Router v7 Migration

  This major release migrates Weaverse Hydrogen from Remix to React Router v7, aligning with [Shopify Hydrogen's May 2025 release](https://hydrogen.shopify.dev/update/may-2025).

  #### Added

  * **React Router v7 Foundation**: Complete migration to React Router v7 as the core architecture
  * **Enhanced Type Safety**: Improved TypeScript definitions and better type inference
  * **Comprehensive Migration Guide**: Step-by-step documentation for upgrading existing projects
  * **Updated CLI Templates**: Weaverse CLI generates React Router v7 compatible themes by default
  * **Performance Optimizations**: Better tree-shaking and build-time optimizations
  * **Modern Development Experience**: Enhanced hot module replacement and error reporting

  #### Changed

  * **BREAKING**: Migrated from Remix to React Router v7 architecture
  * **BREAKING**: Updated data loading patterns from Remix loaders to React Router v7 loaders
  * **BREAKING**: Replaced `@shopify/remix-oxygen` dependencies with React Router equivalents
  * **BREAKING**: Updated component APIs and imports to match React Router v7 conventions
  * **BREAKING**: Changed TypeScript module declarations from `@shopify/remix-oxygen` to `react-router`
  * **Dependencies Updated**:
    * `@shopify/hydrogen`: >=2025.5.0
    * `react-router`: ^7.0.0
    * Removed `@shopify/remix-oxygen` dependency

  #### Deprecated

  * **Remix Integration**: `@weaverse/remix` package is deprecated in favor of React Router v7

  #### Removed

  * **Remix Dependencies**: Removed all Remix-specific dependencies and code paths
  * **Legacy Loaders**: Removed Remix-style loader patterns

  #### Migration Guide

  * **Existing Projects**: Follow the [migration guide](/migration-advanced/v5-migration) to upgrade to v5
  * **New Projects**: Use `npx @weaverse/cli@latest create` for React Router v7 projects
  * **Theme Compatibility**: All starter themes updated for React Router v7
</Update>
