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

> ## Agent Instructions
> Weaverse component configuration uses `settings`. `inspector` is deprecated; never generate it.
> Weaverse Hydrogen themes use React Router v7: import from `react-router`, never `react-router-dom` or `@remix-run/*`.
> Before using any code sample, read `@weaverse/hydrogen` in the project's `package.json`: 6.x and 5.x import from different entries and use different type names, so code for one does not build on the other.
> `@weaverse/hydrogen` 6 (Shopify Hydrogen 2026.10 and later, the version these docs show) imports from `@weaverse/hydrogen/react-router` and uses `Weaverse*` types such as `WeaverseComponentProps`, `WeaverseComponentLoaderArgs` and `WeaverseComponentSchema`; the root `@weaverse/hydrogen` entry only exports `createSchema()`, data helpers and types.
> `@weaverse/hydrogen` 5.x (Hydrogen 2026.4 and earlier) imports everything from `@weaverse/hydrogen` and uses `HydrogenComponentProps`, `ComponentLoaderArgs` and `HydrogenComponentSchema`. On a 5.x project, convert samples to these names. Upgrade to 6 only when asked (`npx @weaverse/cli@latest migrate v6`, plus the Hydrogen 2026.10 upgrade). Do not mix major versions.
> Next.js themes use `@weaverse/hydrogen` 6.2.0 or later: import client and shared code from `@weaverse/hydrogen/next` and server-only code from `@weaverse/hydrogen/next/server`. `@weaverse/next` is deprecated; never install or import it.
> For live project data (pages, theme settings, translations), use the Weaverse MCP server: https://weaverse.io/docs/developer-tools/weaverse-mcp

# 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.

**2026.11.28**

November 11, 2026

### Weaverse Studio

#### Fixes

* **Usage breakdown**: Page views recorded shortly after the hour now appear in the breakdown.
* **AI agent code for SDK 6 themes**: Components the AI agent generates now use the imports and types that match your theme's Weaverse SDK version.

**Pilot v2026.11.13**

November 13, 2026

### Weaverse Pilot Theme

#### Improvements

* **Content Security Policy on Hydrogen's helpers**: The report-only policy is built with Hydrogen's `createContentSecurityPolicy` and the Weaverse SDK's Studio sources, so normal visitors get no Weaverse or Shopify wildcards, and pages stay cacheable on Oxygen. Set `PUBLIC_CHECKOUT_DOMAIN` to allow Shopify videos served from your store's own domain.
* **Markets with `defineShopifyI18n`**: Markets are defined with Hydrogen 2026.10.3's locale APIs, and every market keeps its URL.

#### Fixes

* **Sign-out**: Signing out returns shoppers to the home page of the market they were browsing, such as `/de-de`, instead of `/`.
* **Related products**: Opening a related product on a product page no longer logs a duplicate view-transition error, and its image still expands into the next page.
* **Account page**: The account page keeps its spacing on desktop, and "Add an Address" opens the address form.
* **CSP reports**: Upgrading to Weaverse SDK v6.3.1 stops a CSP `unsafe-eval` report on every page.

#### Upgrade

Register `<your-origin>/account/signed-out` as a Logout URI in the Customer Account API settings. Until then, sign-out still works and returns to `/`.

Breaking for themes built on Pilot: forks that import `app/utils/csp.ts`, `useNonce`, `I18nConfig` or `storefront.i18n` need to update. Merchants using Pilot as-is need no changes.

[GitHub release](https://github.com/Weaverse/pilot/releases/tag/v2026.11.13)

**Forward v2026.11.13**

November 13, 2026

### Weaverse Forward Theme

#### New Features

* **Date-based versions**: Forward now uses date-based versions (`YYYY.M.D`) like Pilot, and ships a `CHANGELOG.md`. This release follows `1.0.0`.
* **Opt-in Content Security Policy**: Set `CSP_MODE` to `report-only` (the default), `enforce` or `off`. Weaverse Studio's sources are added in design mode, and `PUBLIC_CHECKOUT_DOMAIN` allows Shopify videos served from your store's own domain.

#### Improvements

* **Weaverse SDK v6**: Forward imports Weaverse from `@weaverse/hydrogen/next` (v6.3.1), defines markets with `defineShopifyI18n`, resolves theme copy with `createTranslate` and maps page SEO with `getWeaverseNextSeoMetadata`.
* **Hydrogen 2026.10.3**: Forward runs on `@shopify/hydrogen` 2026.10.3 and Next 16.4.6.

#### Fixes

* **Sign-out**: Signing out returns shoppers to the home page of the market they were browsing, instead of `/`.
* **Cart market**: The cart stays in the market of the current page, and switching market reloads its totals in the new currency.
* **Sitemap and robots.txt**: Both advertise your site's origin (`PUBLIC_SITE_URL`, or the Vercel production domain) instead of a placeholder.

#### Upgrade

Register `https://<your-domain>/account/signed-out` as a Logout URI in the Customer Account API settings. Until then, sign-out still works and returns to `/`.

Breaking for themes built on Forward: forks that import from `@weaverse/next` can run the codemod below. Lint, format and tests now run on Vite+ (`vp`) instead of Biome and `bun test`. Merchants using Forward as-is need no changes.

```bash theme={null}
npx @weaverse/cli@latest migrate v6
```

[GitHub release](https://github.com/Weaverse/forward/releases/tag/v2026.11.13)

**SDK v6.3.1**

November 12, 2026

### Weaverse SDKs

#### Fixes

* **No more `unsafe-eval` CSP reports**: storefronts with a Content Security Policy no longer log an `'unsafe-eval'` violation on every page load. The schema validator used by the SDK probed whether it could compile code at runtime; it now skips that probe. Nothing else changes, and you don't need to add `'unsafe-eval'` to your policy. This release ships with `@weaverse/schema` 0.20.1.

#### Upgrade

```bash theme={null}
npm install @weaverse/hydrogen@^6.3.1
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v6.3.1)

**@weaverse/schema 0.20.1**

November 12, 2026

### Weaverse SDKs

#### Fixes

* **No runtime code compilation**: the package now turns off Zod's JIT mode, so Zod never probes `new Function()` and storefronts with a Content Security Policy without `'unsafe-eval'` no longer log a violation. It requires Zod 4.4 or later. JIT mode is a global Zod setting, so other code sharing the same Zod instance also runs without it.

#### Upgrade

```bash theme={null}
npm install @weaverse/schema@0.20.1
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/schema%400.20.1)

**2026.11.27**

November 11, 2026

### Weaverse Studio

#### Improvements

* **One year of usage history, a rolling free allowance.** Usage history is kept for one year and older usage data is automatically removed. Free evaluation includes 10,000 view credits in any 30-day period. Billing records, charges and invoices are unchanged.

**SDK v6.3.0**

November 12, 2026

### Weaverse SDKs

#### New Features

* **Content Security Policy for Weaverse Studio**: `getWeaverseStudioCspDirectives(request)` returns the CSP sources Weaverse Studio needs for the current request, ready to pass to Hydrogen's `createContentSecurityPolicy`. Normal visitors get no extra sources, and only trusted Weaverse Studio origins are allowed to embed and edit the page. Import it from `@weaverse/hydrogen/react-router` or `@weaverse/hydrogen/next/server`.

#### Improvements

* **Hydrogen 2026.10.3 locale APIs**: the SDK now reads the storefront's `locale` instead of the deprecated `i18n`, so storefronts using `defineShopifyI18n` get no deprecation warnings from Weaverse.

#### Upgrade

This release requires `@shopify/hydrogen` 2026.10.3 or later:

```bash theme={null}
npm install @weaverse/hydrogen@^6.3.0 @shopify/hydrogen@^2026.10.3
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v6.3.0)

**2026.11.25**

November 11, 2026

### Weaverse Studio

#### New Features

* **Understand your page views.** See which storefronts and pages drive your usage, with a daily trend and Content API requests listed separately. Page views include content loads by crawlers and bots, not just visitors.

**SDK v6.2.0**

November 11, 2026

### Weaverse SDKs

#### Improvements

* **One package for Next.js**: the Next.js adapter now ships inside `@weaverse/hydrogen` (`@weaverse/hydrogen/next` and `@weaverse/hydrogen/next/server`), so Next.js storefronts install one Weaverse package and no longer get a second copy of the React bindings.
* **Translation and SEO helpers for Next.js**: `createTranslate`, `interpolate` and `getNestedKey`, and the SEO helpers `getWeaverseNextSeoMetadata` and `formatWeaverseNextSeoMetadata`, are now exported from `@weaverse/hydrogen/next` (the SEO helpers from `/next/server` too), so themes can use them instead of their own copies.

#### Upgrade

`@weaverse/next` is deprecated. Remove it from your dependencies, upgrade `@weaverse/hydrogen`, and let the codemod rewrite the imports:

```bash theme={null}
npm uninstall @weaverse/next
npm install @weaverse/hydrogen@^6.2.0
npx @weaverse/cli@latest migrate v6
```

Already-published `@weaverse/next` versions keep installing.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v6.2.0)

**2026.11.22**

November 10, 2026

### Weaverse Studio

#### New Features

* **Partner themes**: The [Themes](https://weaverse.io/themes) gallery now includes themes from Weaverse partners, each with its own detail page, preview and price.
* **Buy themes**: Buy a paid partner theme with a one-time Shopify charge, then create a project from it in the Create project dialog. Purchased and free themes give you a `npx @weaverse/cli@latest create` command that downloads the theme source into your new project.
* **Theme settings from the Page Outline**: In themes that support it, open the settings for the header, footer and other theme areas from the Page Outline or by clicking them in the preview.

#### Improvements

* **Restore published page drafts**: Restore an eligible published page draft as a new draft, with its translations, without changing live content.
* **Clearer preview status**: When the preview is not ready or cannot connect, Studio shows setup or recovery steps instead of a generic connection error.

#### Fixes

* **Publishing after deleting a global section**: Publishing a page no longer fails after a global section was deleted.
* **Browser translation**: The editor no longer crashes when the browser's page translation is turned on.
* **Projects created from a theme preset**: The home page keeps its content when a store uses market-based locales.

**SDK v6.1.3**

November 11, 2026

### Weaverse SDKs

#### Improvements

* **Studio selection on the Next.js entry**: `useStudioSelection()` is now available from `@weaverse/hydrogen/next` too, so Next.js themes can read what is selected in Weaverse Studio without importing `@weaverse/next`. The entry still works in Server Components.

#### Upgrade

```bash theme={null}
npm install @weaverse/hydrogen@^6.1.3
```

Released with `@weaverse/next` 1.1.4, which pins the same `@weaverse/react`.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v6.1.3)

**SDK v6.1.2**

November 11, 2026

### Weaverse SDKs

#### Fixes

* **Next.js entry in Server Components**: `@weaverse/hydrogen/next` no longer crashes `next build` with `createContext is not a function` when a Server Component imports it, such as a root layout or a section schema. Next.js storefronts can import from `@weaverse/hydrogen/next` instead of `@weaverse/next`.

#### New Features

* **Studio selection store**: `useStudioSelection()` from `@weaverse/hydrogen/react-router` reads what is selected in Weaverse Studio from anywhere under the root layout, including UI rendered outside the page, such as popups. It returns empty values until Studio starts sending selections.

#### Upgrade

```bash theme={null}
npm install @weaverse/hydrogen@^6.1.2
```

Released with `@weaverse/next` 1.1.3.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v6.1.2)

**@weaverse/next 1.1.3**

November 11, 2026

### Weaverse SDK for Next.js

#### New Features

* **Studio selection store**: `useStudioSelection()` reads what is selected in Weaverse Studio under `WeaverseNextRootProvider` or `WeaverseNextProvider`. It returns empty values until Studio starts sending selections.

Pins `@weaverse/react` 6.1.2, the version `@weaverse/hydrogen` 6.1.2 uses.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse%2Fnext%401.1.3)

**2026.11.19**

November 9, 2026

### Weaverse Studio

#### Improvements

* **Agent index**: [weaverse.io/llms.txt](https://weaverse.io/llms.txt) now covers SDK v6, Next.js and the Forward theme, and agents that request Markdown from the homepage now receive the full index.

**Pilot v2026.11.10**

November 10, 2026

### Weaverse Pilot Theme

#### Improvements

* **Collection filters on Hydrogen's collection store**: Collection and all-products filters and sort run on Hydrogen 2026.10's collection store, so checked filters update instantly and follow back and forward navigation. URLs use Liquid-compatible params (`filter.p.*`, `filter.v.*`, `sort_by`), and older filter links redirect to them.
* **Prices in each market's format**: Prices, including compare-at prices, follow each market's locale, such as `1.234,50 €` in Germany. English-language markets abroad, such as `/en-de`, format prices like their country, and the collection price filter shows the market's currency.
* **Market translations**: Markets whose Shopify language differs from their public locale, such as Traditional Chinese in Hong Kong, get their Weaverse translations.

#### Fixes

* **Search**: Pressing Enter in the header search opens the results page without a full reload, and the search page has a submit button.
* **Account icon**: The header account icon no longer flickers or shifts the header while the page loads.

#### Upgrade

Breaking for themes built on Pilot: forks that build collection filter URLs or parse rendered price strings should check them. Merchants using Pilot as-is need no changes.

[GitHub release](https://github.com/Weaverse/pilot/releases/tag/v2026.11.10)

**SDK v6.1.1**

November 10, 2026

### Weaverse SDKs

#### Fixes

* **`fetchWithCache` with form bodies**: Requests whose body is `FormData`, a `Blob` or another non-string body are no longer cached under one shared entry, so two such requests with different bodies each get their own response. These requests now skip the cache; string, `URLSearchParams` and body-less requests are cached as before.

#### Upgrade

```bash theme={null}
npm install @weaverse/hydrogen@^6.1.1
```

Released with `@weaverse/next` 1.1.2, which pins the same `@weaverse/react`.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v6.1.1)

**2026.11.9**

November 3, 2026

### Weaverse Studio

#### Fixes

* **Development and client-transfer stores**: Shopify development and client-transfer stores can keep using Studio and the dashboard without being redirected to plan selection, even after passing the free view allowance. Once a store moves to a paid Shopify plan, the usual plan requirement applies.

**SDK v6.1.0**

November 9, 2026

### Weaverse SDKs

#### New Features

* **Market locale for Weaverse**: `WeaverseClient` takes an optional `locale`, the market as Weaverse identifies it. It selects the Translation Manager overrides, the locale sent with page requests and the locale Studio reads, including `pathPrefix`, while the Storefront API keeps its own `i18n`. Use it when a market's Shopify `LanguageCode` differs from its public language, such as `ZH_TW` for a Traditional Chinese Hong Kong market, whose translations otherwise fall back to theme defaults. Without `locale`, nothing changes.

```ts theme={null}
new WeaverseClient({
  storefront,
  locale: { language: 'ZH', country: 'HK', pathPrefix: '/zh-hk' },
  // ...env, cache, waitUntil, request, components, themeSchema
})
```

#### Upgrade

```bash theme={null}
npm install @weaverse/hydrogen@^6.1.0
```

Released with `@weaverse/next` 1.1.1, which pins the same `@weaverse/react`.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v6.1.0)

**Pilot v2026.11.7**

November 7, 2026

### Weaverse Pilot Theme

#### New Features

* **Hydrogen 2026.10 and Weaverse SDK 6**: Pilot now runs on Hydrogen 2026.10 and `@weaverse/hydrogen` 6.0. Every route, SEO output, analytics event and commerce feature keeps working: `server.ts` owns the request lifecycle, the cart and product form use Hydrogen's stores, customer accounts use Hydrogen's OAuth handlers, and `ShopifyScripts` replaces `Analytics.Provider`.
* **Image focal points**: Images keep the focal point set in Weaverse Studio visible when their frame crops them.

#### Improvements

* **Content Security Policy**: Pilot builds the CSP header and nonce itself, so the Studio bridge, YouTube and Google Tag Manager are covered by `script-src`.
* **Weaverse load failures**: A page whose Weaverse content fails to load answers a retryable 503 with a reload link instead of a broken page.
* **Unsupported markets**: URLs with a market prefix the store doesn't support answer 404.

#### Fixes

* **Product quantity**: A quantity chosen on one product no longer carries over to the next product you open.
* **Product card transitions**: Fixed a duplicate `view-transition-name` when opening a product from a product card.

#### Upgrade

Breaking for themes built on Pilot. Run `npx @weaverse/cli migrate v6` to rewrite the Weaverse imports, then follow Shopify's Hydrogen 2026.10 upgrade guide and Pilot's cut-over spec (`.weaverse/specs/2026-10-29-hydrogen-2026-10-cut-over.md`). Merchants using Pilot as-is need no changes.

[GitHub release](https://github.com/Weaverse/pilot/releases/tag/v2026.11.7)

**CLI v5.9.0**

November 7, 2026

### Weaverse CLI

#### New Features

* **`weaverse migrate v6` codemod**: rewrites a theme for `@weaverse/hydrogen` 6. It moves `@weaverse/hydrogen` imports to `@weaverse/hydrogen/react-router`, and `@weaverse/next` and `@weaverse/next/server` imports to `@weaverse/hydrogen/next` and `@weaverse/hydrogen/next/server`. It also applies the 6.0 type renames. Only files that import Weaverse are changed. Use `--dry-run` to list the files it would change and `--dir` to point it at another project folder.

#### Upgrade

```bash theme={null}
npx @weaverse/cli@latest migrate v6 --dry-run
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/cli%405.9.0)

**@weaverse/next 1.1.0**

November 7, 2026

### Weaverse SDK for Next.js

#### Improvements

* **Ships with Weaverse SDK v6.0.0**: `@weaverse/next` now depends on `@weaverse/react` 6.0.0, the same version as `@weaverse/hydrogen` 6.0.0. Next.js themes can also import it as `@weaverse/hydrogen/next` and `@weaverse/hydrogen/next/server`.
* **Optional `next` peer**: `next` is now an optional peer dependency, so React Router themes that install `@weaverse/hydrogen` 6 don't pull in Next.js.

#### Upgrade

```bash theme={null}
npm install @weaverse/next@1.1.0
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/next%401.1.0)

**SDK v6.0.0**

November 7, 2026

### Weaverse SDKs

#### New Features

* **Hydrogen 2026.10 support**: `@weaverse/hydrogen` 6 runs on `@shopify/hydrogen` 2026.10 and later, which is now a peer dependency. Themes on Hydrogen 2026.4 or earlier stay on `@weaverse/hydrogen` 5.x.
* **One entry point per framework**:
  * `@weaverse/hydrogen/react-router` for Hydrogen and React Router themes;
  * `@weaverse/hydrogen/next` and `@weaverse/hydrogen/next/server` for Next.js themes;
  * `@weaverse/hydrogen/react` for framework-free React hooks;
  * the root `@weaverse/hydrogen` entry for schemas, data helpers and types, without loading React or a router.
* **`WeaverseClient` on the 2026.10 Storefront client**: the client takes the request's Storefront API client plus `env`, `cache` and `waitUntil`. Section loaders query Shopify with `weaverse.storefront.graphql()`.

#### Improvements

* **Caching on Hydrogen 2026.10**: Weaverse content keeps the same freshness: 60 seconds fresh, then up to a day stale while it revalidates or when the API fails. A failing cache read now loads from the API instead of failing the page.

#### Upgrade

This is a major release. Move your theme to Hydrogen 2026.10 first, then:

1. Install the new version:
   ```bash theme={null}
   npm install @weaverse/hydrogen@6
   ```
2. Preview the import and type changes, then apply them:
   ```bash theme={null}
   npx @weaverse/cli@latest migrate v6 --dry-run
   npx @weaverse/cli@latest migrate v6
   ```
3. Review the diff. The codemod renames types by name across each file that imports Weaverse, so a local type that shares a renamed name, such as `ThemeSettingsResponse`, is renamed too.

Renamed types include `HydrogenComponentProps` → `WeaverseComponentProps`, `HydrogenComponentSchema` → `WeaverseComponentSchema`, `HydrogenThemeSettings` → `WeaverseThemeSettings`, `ComponentLoaderArgs` → `WeaverseComponentLoaderArgs` and `ThemeSettingsResponse` → `WeaverseThemeSettingsResponse`.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v6.0.0)

**SDK v5.25.0**

November 6, 2026

### Weaverse SDKs

#### New Features

* **Studio selection hook**: `useStudioSelection()` in `@weaverse/react` returns `{ selectedItemId, selectedThemeGroup }`, the page item or theme settings group the merchant has selected in Weaverse Studio. Both values are `null` on the storefront and during server rendering. Hydrogen and Next.js start providing the selection in upcoming releases; until then the hook returns `null` for both.

#### Upgrade

Update `@weaverse/core`, `@weaverse/react` and `@weaverse/hydrogen` to 5.25.0.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v5.25.0)

**2026.11.8**

November 3, 2026

### Weaverse Studio

#### Fixes

* **Connecting AI assistants**: Fixed the redirect back to AI assistants after approving a Weaverse connection.

**2026.11.5**

November 2, 2026

### Weaverse Studio

#### Fixes

* **Connecting AI assistants**: Fixed an authorization error when connecting AI assistants to Weaverse.

**2026.10.51**

October 31, 2026

### Weaverse Studio

#### Improvements

* **Sandbox previews after idle**: A Sandbox preview left idle is now kept paused instead of shut down, so opening it again usually resumes it rather than restarting it.

**2026.10.48**

October 29, 2026

### Weaverse Studio

#### Fixes

* **Page selector without a running preview**: Home page, All products and Collections list now show their names, and page lists show "Preview not connected" instead of loading forever when the preview can't connect.

**@weaverse/next 1.0.2**

October 29, 2026

### Weaverse SDK for Next.js

#### New Features

* **Typed theme outline**: `WeaverseNextThemeSchema` now accepts an `outline` field, typed as `ThemeOutline` from `@weaverse/schema` 0.20.0, to list theme settings groups in the Page Outline.

#### Upgrade

```bash theme={null}
npm install @weaverse/next@1.0.2
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/next%401.0.2)

**SDK v5.24.1**

October 29, 2026

### Weaverse SDKs

#### New Features

* **Typed theme outline**: `HydrogenThemeSchema` now accepts an `outline` field, typed as `ThemeOutline` from `@weaverse/schema` 0.20.0, to list theme settings groups in the Page Outline.

#### Upgrade

Update `@weaverse/core`, `@weaverse/react` and `@weaverse/hydrogen` to 5.24.1.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v5.24.1)

**@weaverse/schema 0.20.0**

October 29, 2026

### Weaverse SDKs

#### New Features

* **Theme outline types**: a new `ThemeOutline` type describes which theme settings groups a theme lists in the Page Outline, grouped into areas such as `header`, `aside` and `footer`.
* **Theme element markers**: `getThemeElementProps(groupName)` marks the storefront element a theme settings group styles with a `data-wv-theme-id` attribute, so Studio can highlight it. It is server-safe and works in React Server Components. `getThemeElementId` and `THEME_ELEMENT_ATTRIBUTE` are exported too.

#### Upgrade

```bash theme={null}
npm install @weaverse/schema@0.20.0
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/schema%400.20.0)

**2026.10.45**

October 27, 2026

### Weaverse Studio

#### Improvements

* **Custom pages from theme starters**: A new project created from a theme now includes the starter's custom pages, alongside its default page templates.

**CLI v5.7.1**

October 29, 2026

### Weaverse CLI

#### Fixes

* **`--version` shows the CLI version**: `weaverse --version` printed `unknown`; it now prints the installed version.
* **Clear error in read-only folders**: `weaverse create` now stops before any prompts when you can't write to the current folder, and tells you to run it from a folder you own, such as your home directory.
* **Correct example command**: when required options are missing, the suggested command now uses the template you chose (for example `--template=forward`) instead of always Pilot.
* **Bun install on npm 11**: when the CLI installs Bun for you, it now approves Bun's install script, so the install completes on npm 11.

#### Upgrade

```bash theme={null}
npx @weaverse/cli@latest --version
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/cli%405.7.1)

**SDK v5.24.0**

October 28, 2026

### Weaverse SDKs

#### Improvements

* **Clearer loading errors:** Storefront developers can opt in to distinguish Weaverse loading failures from missing pages and offer shoppers a reload action.
* **Invalid responses are identified:** Page and theme loading now detects invalid responses so storefronts can avoid treating them as saved content.

#### Upgrade

Update `@weaverse/core`, `@weaverse/react` and `@weaverse/hydrogen` to 5.24.0. Enable `throwPageLoadFailures` to use the new `WeaverseLoadError` handling.

This release requires `@shopify/hydrogen >=2025.5 <2026.10.0`. Shopify Hydrogen 2026.10 is not yet supported.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v5.24.0)

**2026.10.44**

October 26, 2026

### Weaverse Studio

#### Improvements

* **Next.js setup for Forward projects**: A project created from Forward now shows the Next.js setup steps: the Weaverse CLI command, the Shopify keys to add, `bun run dev`, and Vercel as the deploy target. Its default preview URL is `http://localhost:3333`, where Forward's dev server runs.

**2026.10.43**

October 26, 2026

### Weaverse Studio

#### Improvements

* **New homepage hero**: The homepage introduces Weaverse as a headless CMS for Shopify Hydrogen and shows the command to create a project with the Pilot (React Router) or Forward (Next.js) starter.
* **Interactive feature demos**: The homepage features list shows each feature in action: no-code editing, global sections, scheduled publishing, localization, SEO management, instant setup and the Content API.
* **Next.js on the website**: The FAQ, the integration section and the integrations page now cover Next.js and link to the Next.js quickstart.
* **Product screenshots on the Hydrogen CMS page**: Its capabilities are shown as a grid of product screenshots, and the SEO management page shows the SEO manager.

**2026.10.41**

October 25, 2026

### Weaverse Studio

#### Improvements

* **Choose your preview destination**: When a connected hosted preview redirects to another hostname, Studio lets you use the destination URL or keep the current URL. Switching reuses an existing saved destination when available and preserves your original URL and default preview.

**2026.10.40**

October 25, 2026

### Weaverse Studio

#### Improvements

* **Experimental WebMCP** is available to all authenticated shops in supported browsers. Every proposed edit requires confirmation and remains unsaved draft work.

**2026.10.39**

October 21, 2026

### Weaverse Studio

#### Improvements

* **Redesigned Hydrogen CMS and feature pages**: The Hydrogen CMS page and the visual builder, custom components, scheduled publishing, localization and SEO pages now share the website's design, with real Studio screenshots and recordings.
* **Refreshed showcases**: The homepage and the showcases page feature 18 live Hydrogen storefronts built with Weaverse, with new screenshots and an industry filter.
* **Every feature page in the menu**: The Product menu and the footer now link to each feature page.
* **Updated Trust & Security page**: Each service provider is listed with its logo, followed by a security contact section.

**2026.10.38**

October 21, 2026

### Weaverse Studio

#### Improvements

* **Improved the “Reduce your bill” reminder** so a confirmed recommendation can remain available when switching stores.
* **Improved rich-text video-link handling** when saving editor content.

**2026.10.37**

October 20, 2026

### Weaverse Studio

#### Fixes

* **Localized page recreation**: Fixed an issue that could prevent recreating a localized page after resetting or deleting it.

**2026.10.36**

October 20, 2026

### Weaverse Studio

#### Improvements

* **Complete Content API reference**: The Content API's OpenAPI description now documents every endpoint, with descriptions, request and response examples, and the error codes each one returns. It is valid OpenAPI 3.1, so you can load it into API clients and code generators from `https://studio.weaverse.io/api/v1/content/openapi.json`.

#### Fixes

* **Clearer Content API refusals**: Requests the API refuses now return `404` or `409` with an error code instead of a generic `500`. This covers cancelling or publishing a version that is not scheduled, scheduling a draft that is out of date, assignment handles already in use, invalid project hierarchy changes and duplicate preview URLs.
* **Publish now reports what happened**: `POST /versions/{versionId}/publish-now` returns `409` when nothing was published, instead of `200`.
* **Retired page versions honor `limit`**: `GET /projects/{projectId}/versions?kind=retired-pages` now returns at most `limit` rows, like the other version lists.

**2026.10.35**

October 20, 2026

### Weaverse Studio

#### Improvements

* **Version history labels** changes made by integrations and scheduled publishing when that information is available.
* **The “Reduce your bill” prompt** appears once per store instead of repeating.
* **Draft loading is bounded** so a slow read no longer blocks editing.
* **The dashboard lists 20 projects per page.**
* **The website includes new contact next steps, team facts, and integration data-flow notes.**

**2026.10.33**

October 19, 2026

### Weaverse Studio

#### New Features

* **Forward in the theme gallery**: Forward, the Next.js starter theme built on `@weaverse/next`, now appears in the theme gallery with its own theme page and live demo link.
* **Try Forward in the demo editor**: Open Forward in the public demo editor to explore its sections and pages before you create a project.
* **Create a project from Forward**: Forward is now one of the themes in **Create new project**, and the new project starts from Forward's starter pages and theme settings.

**2026.10.32**

October 19, 2026

### Weaverse Studio

#### Improvements

* **New projects start from each theme's starter content**: Creating a project from Pilot, Naturelle, Aspen, Maison or Forward now seeds that theme's latest starter pages and theme settings, with placeholder content ready to replace.

**2026.10.29**

October 16, 2026

### Weaverse Studio

#### Fixes

* **More reliable article previews**: Studio now opens an available article assigned to your template instead of an unrelated default article. If no assigned article is available, Studio keeps your current page open and shows an error.

**2026.10.28**

October 14, 2026

### Weaverse Studio

#### Fixes

* **AI assistant approval requests reach the right region**: Approving an AI assistant's access request, or confirming an AI agent's sign-in code, now passes along the routing information Weaverse needs to send the request to its primary region. Before, these requests could stop on a plain "Fly Replay" message.
* **Styled authorization screens**: The AI assistant approval and agent sign-in confirmation screens now load Studio's normal styling.

**Forward v1.0.0**

October 15, 2026

### Forward

#### New Features

* **Forward 1.0.0, the Next.js starter theme**: the first versioned release of Weaverse's open-source storefront theme for the Next.js App Router, built on `@weaverse/next`. Home, product, collection, all products, collection list, blog, article, page and custom pages are composed in Weaverse Studio, with live theme settings, markets and translations.
* **Ready to scaffold**: Forward now ships an MIT license and agent guidance for your own project, and installs with `npx @weaverse/cli@latest create --template forward`.

[GitHub release](https://github.com/Weaverse/forward/releases/tag/v1.0.0)

**CLI v5.7.0**

October 15, 2026

### Weaverse CLI

#### New Features

* **Create a Next.js storefront**: `weaverse create --template forward` scaffolds Forward, the Next.js starter theme. It installs dependencies with Bun, offering to install Bun first when it is missing, and prints Next.js next steps: your Shopify Storefront API keys, `bun run dev`, and connecting Weaverse Studio.

#### Upgrade

```bash theme={null}
npx @weaverse/cli@latest create --template forward
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/cli%405.7.0)

**@weaverse/next 1.0.1**

October 15, 2026

### Weaverse SDK for Next.js

#### Fixes

* **Import `@weaverse/next` from Server Components**: Rendering `WeaverseNextRootProvider` or `WeaverseNextStudioConnect` in a Server Component such as `app/layout.tsx`, or calling `createSchema` and other helpers in server code, no longer fails the build with `createContext is not a function`. Components, hooks and providers now ship as Client Components, so you no longer need your own `'use client'` wrapper around them.
* **Server-safe helpers**: `createTranslate`, `getNestedKey` and `interpolate` work in server code, and `isBrowser` and `isIframe` are `false` on the server.

#### Upgrade

```bash theme={null}
npm install @weaverse/next@1.0.1
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/next%401.0.1)

**2026.10.27**

October 13, 2026

### Weaverse Studio

#### Fixes

* **Discarding a section draft recovers after a dropped connection**: If a discard went through but its response never arrived, the next Discard now reloads the section's current state instead of failing again.
* **Hidden elements open in the settings panel**: With the settings panel on the left, choosing Edit on a hidden outline row now shows that element's hidden state instead of an empty panel.
* **Clearer help when a local-network preview times out**: When an `http://` preview on a local network address (such as `192.168.x.x`) times out, Studio now explains that it can be blocked inside Studio and suggests switching to `http://localhost` or an `https://` preview URL.

#### Improvements

* **More of the dashboard in your language**: The account-type prompt and the Instagram and third-party integration settings are now translated into all supported languages.
* **Simplified Chinese terminology**: Sections are now called 分区 throughout the Simplified Chinese interface.

**2026.10.26**

October 13, 2026

### Weaverse Studio

#### New Features

* **Image focal points**: Choose the part of an image to keep in view when a section crops it. Open an image setting, click **Change → Set focal point**, and pick the spot; the saved point shows under the image. Each image setting keeps its own point, even when sections share the same file. Works with themes that support it, including Pilot. See [Focal point](https://weaverse.io/docs/development-guide/input-settings.md#focal-point).

**2026.10.25**

October 12, 2026

### Weaverse Studio

#### Fixes

* **Article pages open even when your first blog is empty**: The page selector now finds a default article from any blog. Before, it showed "Not found" when the store's first blog had no articles, which is common because Shopify creates an empty "News" blog on every store.

**SDK v5.23.0**

October 12, 2026

### Weaverse SDKs

#### New Features

* **Image focal points**: Image inputs can carry an optional focal point (`focalPoint: { x, y }`, normalized coordinates), so the same image can be framed differently in different sections. Focal points in an image input's `defaultValue` are validated. Themes apply the focal point themselves to reposition images. Released with `@weaverse/schema` 0.19.0.

#### Improvements

* **Typed theme routes**: `HydrogenThemeSchema` now accepts a typed `routes` map, so unknown page types are rejected at type-check time. Types only, no runtime change.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v5.23.0)

**@weaverse/schema 0.19.0**

October 12, 2026

### Weaverse SDKs

#### New Features

* **Image focal points in the schema contract**: Image inputs can carry an optional focal point (`focalPoint: { x, y }`, normalized coordinates), and focal points in an image input's `defaultValue` are validated. Released together with SDK v5.23.0.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/schema%400.19.0)

**2026.10.23**

October 11, 2026

### Weaverse Studio

#### Fixes

* **More reliable Claude connections:** Claude and Claude Code can reach the Weaverse sign-in screen for stores where a regional connection issue previously blocked it. Store access still requires merchant approval.

**2026.10.22**

October 10, 2026

### Weaverse Studio

#### Improvements

* **Links that follow your theme's routes:** The URL picker now builds page, product, and article links from your theme's route patterns when available, with Shopify-style paths as the fallback.

**@weaverse/next 1.0.0**

October 9, 2026

### Weaverse SDK

#### New

* **Weaverse for Next.js is stable:** `@weaverse/next` 1.0.0 is the first stable release of the Next.js App Router integration. It renders Weaverse pages, runs section loaders on the server, connects to Weaverse Studio with per-item revalidation, and supports markets, translations, and theme routes.
* **Forward starter theme:** [Forward](https://weaverse.io/docs/hydrogen-themes/forward.md) is a production Next.js storefront built on `@weaverse/next`.

Get started with the [Next.js overview](https://weaverse.io/docs/nextjs/overview.md).

**2026.10.21**

October 8, 2026

### Content API

#### Improvements

* **More ways to work with store content:** save page and global-section drafts, manage versions, and work with translations through the Content API.
* **Permissions tailored to each task:** new API keys can grant publishing, deletion, and project management separately from ordinary content edits.

**@weaverse/schema 0.18.0**

October 7, 2026

### Weaverse SDKs

#### New Features

* **Theme route patterns**: New `ThemeRoutes` and `ThemeRoutePageType` types let a theme map page types to its own URL patterns (for example `COLLECTION: '/shop/:handle'`) where they differ from the Shopify convention, so Studio can navigate to its pages. Patterns use static segments and whole `:param` segments: `:handle` is the page's own handle, `:blog` an article's blog.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/schema%400.18.0)

**2026.10.20**

October 6, 2026

### Weaverse Studio

#### Improvements

* **Clearer Studio outlines:** supported storefront integrations can show custom labels for individual elements.
* **More reliable restores:** restored pages and theme settings no longer appear to fail after they have been saved.
* **Smoother preview startup:** improved handling while the preview connection initializes.

**SDK v5.22.1**

October 6, 2026

### Weaverse SDKs

#### Fixes

* **Theme settings no longer wait on stalled translations**: Merchant translation overrides now wait at most the client fetch timeout (`fetchTimeoutMs`, default 10 s). If the request stalls, theme settings load with the theme's default translations. A timed-out response is never cached, so the next request tries again.

#### Upgrade

Existing storefronts get this fix only after they upgrade `@weaverse/hydrogen` to 5.22.1.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v5.22.1)

**CLI v5.6.5**

October 4, 2026

### Weaverse CLI

#### Fixes

* **Cleaner new projects**: `weaverse create` now removes the template's `.github` folder along with `.weaverse`, so new projects no longer inherit workflows that fail without Weaverse's own secrets.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/cli%405.6.5)

**Pilot v2026.10.4**

October 4, 2026

### Weaverse Pilot Theme

#### New Features

* **Element labels in the Studio outline**: Heading, Subheading, Column, Testimonial item, and Product highlight item show their content in the outline as `Title – content`.

#### Improvements

* **Latest Weaverse SDK**: Upgraded `@weaverse/hydrogen` to 5.22.0.
* **Hydrogen 2026.4.7**: Consent and analytics now use the Customer Privacy API; no code changes needed. Also upgrades Shopify CLI to 4.8.4 and mini-oxygen to 4.2.3.

[GitHub release](https://github.com/Weaverse/pilot/releases/tag/v2026.10.4)

**SDK v5.22.0**

September 30, 2026

### Weaverse SDKs

#### New Features

* **Element label callbacks**: Component schemas can define an optional `label` callback that names each element from its own data, available through `createSchema`. Schemas without a label are unchanged. Released with `@weaverse/schema` 0.17.0.

```ts theme={null}
createSchema({
  type: 'heading',
  title: 'Heading',
  label: (data: HeadingProps) => data.content,
})
```

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/v5.22.0)

**@weaverse/schema 0.17.0**

September 30, 2026

### Weaverse SDKs

#### New Features

* **Element label callbacks in the schema contract**: Component schemas can define an optional `label` callback, for example `label: (data: HeadingProps) => data.content`. Callbacks are kept without being evaluated during schema validation, and schemas without a label are unchanged. Released together with SDK v5.22.0.

[GitHub release](https://github.com/Weaverse/weaverse/releases/tag/%40weaverse/schema%400.17.0)

**2026.10.16**

September 30, 2026

### 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.

**2026.10.15**

September 29, 2026

### 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.

**2026.10.14**

September 28, 2026

### 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](https://weaverse.io/docs/features/global-sections.md).

**2026.10.13**

September 24, 2026

### 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.

**2026.10.12**

September 23, 2026

### 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.

**2026.10.8**

September 20, 2026

### 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/hydrogen` 5.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.

**2026.10.6**

September 18, 2026

### 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/hydrogen` v5.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/hydrogen` v5.21.2.

**2026.9.25**

September 7, 2026

### 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](https://weaverse.io/docs/content-api/overview.md).

### 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.

**2026.9.1**

September 1, 2026

### 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.

**2026.8.11**

August 11, 2026

### 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.

**2026.7.18**

July 7, 2026

### 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.

**2026.7.17**

July 7, 2026

### 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=true` to your request and any setting you left untouched arrives with its built-in default — no need to look it up yourself.

**2026.7.16**

July 3, 2026

### 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](https://weaverse.io/docs/content-api/overview.md).

**2026.7.11**

July 1, 2026

### 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.

**2026.7.8**

June 30, 2026

### 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.

**2026.7.2**

June 24, 2026

### 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.

**2026.6.29**

June 23, 2026

### 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.

**2026.6.27**

June 21, 2026

### New Features

* **Shopify Sidekick can read your Weaverse content**: New tools let Shopify Sidekick look up your Weaverse projects, pages, and SEO details directly.

**2026.6.19**

June 19, 2026

### 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.

**2026.6.18**

June 18, 2026

### 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.

**2026.6.15**

June 15, 2026

### 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.

**Maison v2026.6.12**

June 12, 2026

### Maison Theme

#### Improvements

* **2026 Hydrogen foundation**: Upgraded Hydrogen, React Router, and Shopify runtime packages, plus the Weaverse SDKs and supporting tooling.
* **Customer accounts and B2B**: Improved Customer Account API and B2B location handling.
* **Page SEO**: Custom pages use Weaverse SDK page SEO.
* **Product and cart**: Manual quantity input, quantity controls in the variant list, "From" prices, more product media previews, and cart badge and bundle badge refinements.
* **Search and collections**: Mobile sort label, smoother filter drawer, predictive search tabs, and cleaner sale labels.
* **UI polish**: Refinements across the footer, buttons, accordions, testimonials, filters, 404 page, quick view, and account and B2B flows.

#### Fixes

* **Pilot fixes**: Bug fixes from Pilot v2026.5.18 are ported to Maison.

[GitHub release](https://github.com/Weaverse/maison/releases/tag/v2026.6.12)

**Aspen v2026.6.12**

June 12, 2026

### Aspen Theme

#### New Features

* **Combined listings**: Support across product queries, product cards, redirects, featured products, and product pages.
* **Bundled products**: Bundle badges, cart line updates, and theme settings for bundles.
* **Subscriptions**: Subscription support with updated mobile and tablet layouts.
* **Newsletter popup**: Configurable newsletter popup.

#### Improvements

* **Shopping experience**: Quick shop, product media zoom, product badges, updated variant selectors, and better product card interactions.
* **Cart**: Notes, discount codes, gift cards, and an animated cart drawer.
* **Navigation and search**: Smoother mobile menu, predictive search, and filters drawer.
* **Section settings**: More options for video, countdown, promotion, map, testimonials, product media, and collection and product items.

[GitHub release](https://github.com/Weaverse/aspen/releases/tag/v2026.6.12)

**2026.6.11**

June 11, 2026

### Bug Fixes

* **Content API Custom Page Handles**: The page detail endpoint now supports custom page handles that contain `/`. If [List Pages](https://weaverse.io/docs/content-api/list-pages.md) returns `type: "CUSTOM"` and `handle: "pages/gift-shop"`, fetch it with `GET /api/v1/content/projects/:projectId/pages/CUSTOM/pages/gift-shop`.

**2026.5.6**

May 6, 2026

### 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.

**2026.5.5**

May 4, 2026

### 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.

**2026.5.4**

May 2, 2026

### 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](https://weaverse.io/docs/content-api/portable-text.md) 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.

**2026.4.22**

April 22, 2026

### 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.

**2026.4.21**

April 21, 2026

### 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.

**2026.4.10**

April 10, 2026

### 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](https://weaverse.io/docs/features/translation-feature-guide.md) 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

**2026.4.8**

April 8, 2026

### 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.

**2026.4.3**

April 3, 2026

### 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

**2026.4.1**

April 1, 2026

### 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.

**2026.3.26**

March 26, 2026

### 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](https://weaverse.io/docs/content-api/overview.md) for full details and code examples.

**Maison v1.0.0**

February 7, 2026

### Maison Theme

#### New Features

* **Independent release**: Maison is now a standalone Hydrogen theme with full Weaverse visual building, built on React Router 7, Tailwind CSS v4, and TypeScript.
* **Shopify features**: Customer Account API, optimized Storefront API queries, and combined listings.
* **Performance**: Parallel data loading in route loaders and native view transitions.

#### Improvements

* **Better search**: Faceted filtering and sorting.
* **Lighter carousels**: Native CSS scrolling replaces third-party carousel libraries where possible.
* **Simpler components**: Components take `ref` as a prop instead of using `forwardRef`.

[GitHub release](https://github.com/Weaverse/maison/releases/tag/v1.0.0)

**2026.2.5**

February 5, 2026

### 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

**Naturelle v3.0.0**

January 17, 2026

### Naturelle Theme

#### New Features

* **Modern Hydrogen stack**: Upgraded to the latest Hydrogen, migrated from Remix to React Router 7, and moved to React 19 and Tailwind CSS v4, aligned with the Pilot architecture.
* **Single product section**: A new single product section, plus an updated product page and product media.

#### Improvements

* **Variant swatches**: Updated variant swatches.
* **Store UI**: Updated cart, menu, footer, buttons, and product cards.

#### Fixes

* **Layout and minor fixes**: Fixed an overlapping HTML class and other minor bugs.

[GitHub release](https://github.com/Weaverse/naturelle/releases/tag/v3.0.0)

**2026.1.10**

January 10, 2026

### 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

**2025.11.30**

November 30, 2025

### 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

**2025.10.31**

October 31, 2025

### 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

**2025.10.01**

October 1, 2025

### 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

**2025.09.25**

September 25, 2025

### 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

**2025.09.08**

September 8, 2025

### 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

**2025.09.04**

September 4, 2025

### 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

**2025.08.22**

August 22, 2025

### 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

**Aspen v1.0.0**

August 15, 2025

### Aspen Theme

#### New Features

* **First release**: Aspen is a Shopify Hydrogen theme for home furniture and interior design stores, built with React Router and Weaverse.

[GitHub release](https://github.com/Weaverse/aspen/releases/tag/v1.0.0)

**2025.08.12**

August 12, 2025

### 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

**2025.07.22**

July 22, 2025

### 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

**5.0.0**

May 27, 2025

### 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](https://hydrogen.shopify.dev/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-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](https://weaverse.io/docs/migration-advanced/v5-migration.md) 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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.