Weaverse Changelog
Stay up-to-date with the latest features, improvements, and bug fixes across the entire Weaverse ecosystem.Weaverse Studio
Fixes
- Find the right page in SEO Manager: Studio shows the page for your selected language and market instead of duplicate-looking homepages, so you can update SEO for the page your storefront uses.
- Retry a stuck preview: Retry now restores the preview when you switch pages, even if Studio is still loading the new page.
Weaverse Studio
Improvements
- Clearer pricing for every plan: Compare included page views and extra usage charges. Developers can build experiments, targeting, and custom integrations on any plan; each separately installed Shopify store is billed separately.
Fixes
- Shopify connections renew automatically: Studio renews eligible expiring Shopify access tokens before Admin API calls. Stores whose authorization has lapsed may still need to reconnect.
Weaverse Studio
Fixes
- Save as global section tells you to publish first: If you try to save a section as a global section before it has been published, Studio now asks you to publish the page first, instead of showing a generic error. See Global Sections.
Weaverse Studio
Fixes
- Manage previews fits on screen again: Long detected hostnames no longer push the content past the edges of the dialog, the preview lists no longer leave empty space below them, and the dialog scrolls on smaller screens.
- Clearer help when a local preview can’t connect: If you’re developing locally or using an AI coding agent, Studio now asks you to make sure your local dev server is running. If you’re not, it points you to Manage previews to switch to your live storefront domain running the Weaverse Hydrogen theme.
Weaverse Studio
New Features
- Save global sections as drafts: Save changes to a shared section without changing your live storefront, then reopen that draft from another page that uses the section.
- Publish a section without publishing the page: Use Publish section to update a global section across the pages that use it while keeping other page edits unpublished. Page publishing leaves your global-section changes separate.
Weaverse Studio
Fixes
- Publishing no longer gets stuck on “Not found”: If you published a page and then hit Publish again, Studio could keep rejecting it until you reloaded. It now recovers on its own and tells you what happened.
- Hidden elements no longer open another element’s settings: Selecting a hidden row in the Page Outline used to leave the settings panel showing whatever you had selected before, so edits could land on the wrong element. The panel now says the element is hidden, and elements inside a hidden parent explain which parent is hiding them.
- The outline tells you when the preview drops: When the preview connection fails for good, the Sections list no longer sits on placeholder rows forever. You get a clear message and a retry button.
- Clearer message when the preview is blocked: Running Studio against a local theme over an insecure address now says your browser blocked the preview and how to fix it, instead of claiming your dev server is not running.
- Product and collection pickers work in the demo: Browsing resources in the demo project returned an error. It works again.
Improvements
- Media Manager exclusions now live in theme code: File exclusions move from a project setting to your theme, set store-wide or per image and video input, so every project on the theme behaves the same and merchants no longer need to configure it. Requires
@weaverse/hydrogen5.21.2 or newer.
Content API
- Internal template pages are labelled: The page list marks internal template markers so you can filter them out, and they can no longer be deleted by handle.
Weaverse Studio
New Features
- Agent Skills for your coding assistant: The Deployment Guide is now an Agent Skills catalog. Install the skill pack once, pick the task you want — project setup, theme updates, Figma to Weaverse, analytics, markets and localization — and copy a ready-made prompt into Claude Code, Codex, Cursor or another assistant.
- See and control the hostnames using your project: Manage previews now lists every hostname observed requesting your project’s content, when it was first and last seen, and whether it is a saved preview. Add one as a preview, or block it, in a click.
Improvements
- Usage read straight from Shopify: If your usage is billed through Shopify, the figure in your dashboard is now read directly from Shopify, so it matches the usage Shopify has recorded against your current cap cycle.
- Translation progress you can trust: Translation jobs now report when they fail instead of finishing quietly, and an accepted translation refreshes right away instead of showing the previous version.
Bug Fixes
- Saved translations no longer go missing on your storefront: Translations for fields you left empty in your default language are now served on the live storefront instead of being filtered out.
- Previews stay on the page you are editing: The editor keeps the preview pointed at the right page and the right preview address through page switches, reloads and slow connections.
- Page history survives a repair: Restoring an earlier version still works on pages that have been repaired.
Weaverse Pilot Theme
New Features
- Eight more languages: Pilot now manages every storefront string through the Weaverse Translation Manager and ships with eight additional languages. Switching language loads the matching content instead of leaving text from the previous one behind.
- Deploy to Cloudflare Workers: Pilot includes the configuration and environment setup for running your storefront on Cloudflare Workers.
Bug Fixes
- Shoppers stay in the market they chose: Adding to cart, signing in, signing out and following a redirect all keep the shopper on the market they were browsing, so prices and currency stay consistent.
- A cleaner media picker: Generated thumbnails and product media are hidden from the Media Manager by default, so you see the files you actually uploaded. The hotspots picker still shows everything.
Weaverse SDKs
New Features
- Choose what the media picker hides: Themes can declare which generated or imported media to exclude from image and video pickers, in the theme schema. Released in
@weaverse/hydrogenv5.21.0.
Improvements
- Storefronts identify themselves: A storefront now sends its own origin with theme-settings requests, which is what the new hostname list in Manage previews reads. Released in
@weaverse/hydrogenv5.21.2.
New Features
- Page translations over the Content API: Read and write a page’s translations programmatically, so your own tools and AI assistants can localize content without opening Studio. See the Content API overview.
Improvements
- A way forward from an empty Scheduled publishing list: The Scheduled publishing manager now explains how to schedule a page instead of showing an empty screen.
- Media Manager search and sort refresh properly: Changing a search term or sort order reloads the gallery instead of leaving the previous results on screen.
- Safer resets and version history: Resetting a localized page is recoverable, and version history no longer breaks on an incomplete saved version.
Bug Fixes
- Create pages in a market that has none yet: Adding a page to a secondary market with no existing pages now works.
- Edits stay with the page you selected: Renaming or editing a custom page applies to the page in view, and a pending rename survives switching away and back.
- Imports keep their language and market: Imported pages keep the locale and market they were exported from.
New Features
- Save a draft of a page that is already published: Choose Save draft from the Publish button to store your work on a live page. The published page stays exactly as it is until you press Publish.
- Pick up a teammate’s draft: Opening a page that has a saved draft resumes it automatically, so two people can work on the same live page without one overwriting the other. Your unsaved edits are never replaced by an incoming draft.
Improvements
- Project and page changes save together: A save now applies to the project and the page as one operation, so a partial save can no longer leave the two out of step.
Bug Fixes
- Page selection recovers after a reload: The editor returns to the page you were on instead of losing your selection.
Improvements
- More reliable page publishing: Saving and publishing now keep your page content in sync, including when several updates happen close together.
- Safer page history and scheduling: Restoring or scheduling a saved version now keeps it matched to the correct page.
Bug Fixes
- Clearer custom page name conflicts: If a custom page name is already in use, Weaverse now tells you clearly so you can choose another one.
Improvements
- A clearer path when a preview won’t load: When your storefront preview can’t connect or has nothing to edit yet, the preview screen now points you straight to the fix — open the setup guide, switch to a working preview, or manage your preview URLs — instead of leaving you at a dead end. The preview, setup, and Manage previews screens now share a consistent look and work together smoothly.
Bug Fixes
- Setup guide fits on smaller screens: The “How to set up project” guide no longer runs off the edge of shorter windows — the title and close button stay visible while the steps scroll.
New Features
- Get components with their defaults filled in: When you fetch a single page from the Content API, you can now ask for every component to come back with its default values already included. Add
?includeDefaults=trueto your request and any setting you left untouched arrives with its built-in default — no need to look it up yourself.
New Features
- Write to your content over the API: The Content API can now make changes, not just read. Update your theme settings and project details programmatically, so your own tools and AI assistants can push updates back into Weaverse. See the Content API overview.
New Features
- Keyboard shortcuts guide: A new quick-reference lists every editor keyboard shortcut, so you can move around the editor without reaching for the mouse.
Improvements
- Clearer error when a save fails: If a save doesn’t go through, the editor now tells you the actual reason instead of a generic message, so it’s faster to fix and try again.
Bug Fixes
- Setup guide fits on smaller screens: The “How to set up project” guide no longer runs off the edge of shorter windows, and now links straight to the full guide.
- Tidier blog article details on mobile: The author and date on blog articles now line up correctly on small screens.
New Features
- Connect a local AI coding assistant: You can now link a local AI coding assistant to your project so it can make edits and preview them against your own development server.
- Jump back to setup when a preview won’t load: If your local preview can’t connect, the preview screen now gives you a direct link back into the setup guide to get things running again.
New Features
- Project backups: Save and restore snapshots of your project’s content. Each backup shows you a plain-language summary of what changed, so you can see exactly what a restore would alter before you go ahead.
- New Careers and Partners pages: Added a Careers page and refreshed the Partners page on our website.
Improvements
- Fewer stale resource pickers: Picking a product, collection, or other resource is more reliable, with fewer cases of a picker showing outdated options or losing your selection while editing.
New Features
- Shopify Sidekick can read your Weaverse content: New tools let Shopify Sidekick look up your Weaverse projects, pages, and SEO details directly.
New Features
- Copy and paste styling between elements: Copy the look of one element and paste it onto another, so you can reuse a style across your page without redoing every setting.
Improvements
- Clearer plan options: The “Change Plan” button is now greyed out on plans below your current one, so it’s obvious which plans are upgrades.
Improvements
- Billing now runs through Shopify: Your subscription and usage are now billed directly through Shopify. Your existing plan and usage carry over automatically — there’s nothing you need to do.
New Features
- Search in the URL picker: The URL picker now lets you search across both your Weaverse pages and your Shopify store pages, so you can find and link to a destination without scrolling.
- Set image widths in rich text: Rich-text images now come with handy width presets, and your images stay intact when you pull content through the Content API.
- Hand your setup to an AI assistant: The local setup step now includes a ready-to-copy prompt, so you can hand your project setup to an AI coding assistant in a single paste.
- Confirm before permanent deletes: Actions that can’t be undone now ask you to confirm first, so it’s harder to delete something by accident.
Improvements
- Know why a preview isn’t loading: The editor now tells the difference between a page that simply has no Weaverse content yet and a preview that’s genuinely disconnected, so the message matches what’s actually going on.
- Easier-to-read delete buttons: Buttons for destructive actions now use a bolder red that’s easier to read.
Bug Fixes
- Blog table of contents is back: Longer articles show their table of contents again.
- Pages resolve more reliably: Fixed a handful of cases where the wrong page could show up — publishing now stays on the page you’re viewing, and pages match up to the right content more consistently.
- Correct language in page URLs: The editor and your live storefront now use the right language prefix in page links.
Bug Fixes
- Content API Custom Page Handles: The page detail endpoint now supports custom page handles that contain
/. If List Pages returnstype: "CUSTOM"andhandle: "pages/gift-shop", fetch it withGET /api/v1/content/projects/:projectId/pages/CUSTOM/pages/gift-shop.
Bug Fixes
- Content API OpenAPI Spec: The
/api/v1/content/openapi.jsonendpoint 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-textquery parameter (shipped in 2026.5.4) is now formally documented for both the page and theme-settings endpoints, including the alternativeAccept: application/portable-text+jsonheader and the optional?meta=trueflag.
Improvements
- Security: Patched several upstream dependency vulnerabilities affecting build and runtime libraries.
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.
New Features
- Portable Text Content API: Opt-in
?format=portable-text(andAccept: application/portable-text+json) on the page and theme-settings endpoints- Default
weaverseformat unchanged — zero migration for existing integrations - Rich-text fields convert from HTML strings to structured Portable Text blocks for multi-channel rendering and AI consumption
- Optional
?meta=trueon the page endpoint adds_weaverse: { id, schemaVersion }to each custom block for round-tripping - See Get Page › Portable Text format for the full mapping
- Default
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-busystate, so screen readers announce when an action is in flight.
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 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.
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 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
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.
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
New Features
-
Multi-Store Session Isolation: Agencies can now work with multiple Weaverse storefronts simultaneously in the same browser
- Session cookie stores a
shopsmap 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/:idURLs auto-redirect to the correct store-scoped path
- Session cookie stores a
-
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-idis missing (e.g.{...props}not spread or component returnsnull) - Tooltip explains possible causes and links to documentation
- Detection happens at selection time for better performance — no upfront DOM scanning during outline building
- Muted gray info icon appears on the selected outline item when
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.
New Features
-
Content API: New authenticated REST API for headless content access
GET /api/v1/content/projects— list all projects in your shopGET /api/v1/content/projects/:projectId/pages— list page assignments with type/locale filteringGET /api/v1/content/projects/:projectId/pages/:type/:handle...— get full page content with component itemsGET /api/v1/content/projects/:projectId/theme-settings— get theme design tokensGET /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
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
Weaverse Studio
New Features
-
Shopify Admin API Proxy: Powerful new API integration for advanced Shopify functionality
- New
/api/admin-graphqlendpoint 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
- New
-
Optional Scopes Authorization: Enhanced permission management for Shopify apps
- Visual UI for managing Shopify app permissions with selectable scopes
- Authorization flow via
admin.shopify.comfor 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
- Custom Shopify app runner with tunnel support (
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
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
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
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
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
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
JudgemeReviewsBadgecomponent for better product review display - Improved API data handling with enhanced error management
- Better review data fetching and display consistency across product pages
- New
Improvements
-
Modular Product Page Architecture: Complete refactor of product components for better maintainability
- Refactored Main Product Section into focused, reusable components
- Enhanced
ProductTitle,ProductVendor, andProductPricescomponents 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
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
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
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
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
MAJOR RELEASE: React Router v7 Migration
This major release migrates Weaverse Hydrogen from Remix to React Router v7, aligning with Shopify Hydrogen’s framework migration. See the current Hydrogen updates.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-oxygendependencies with React Router equivalents - BREAKING: Updated component APIs and imports to match React Router v7 conventions
- BREAKING: Changed TypeScript module declarations from
@shopify/remix-oxygentoreact-router - Dependencies Updated:
@shopify/hydrogen: >=2025.5.0react-router: ^7.0.0- Removed
@shopify/remix-oxygendependency
Deprecated
- Remix Integration:
@weaverse/remixpackage 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 to upgrade to v5
- New Projects: Use
npx @weaverse/cli@latest createfor React Router v7 projects - Theme Compatibility: All starter themes updated for React Router v7