SkillsAdd

weaverse/shopify-hydrogen-skills

hydrogen-upgrades

Step-by-step guides for upgrading Shopify Hydrogen between versions — breaking changes, code diffs, and migration steps for each release.

First seen Apr 9, 2026

Installation

$ npx skills add weaverse/shopify-hydrogen-skills --skill hydrogen-upgrades
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

frontend-design Same topic
anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existi…

866.4K installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-diagnostics Same topic
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs

Also in this package

Other skills from weaverse/shopify-hydrogen-skills · top by installs.

npx skills add weaverse/shopify-hydrogen-skills
shopify-hydrogen 112 hydrogen-cookbooks 107 weaverse-hydrogen 95 theme-update 91 weaverse-integration 89 cloning-websites-to-weaverse 87 hydrogen-analytics-tracking 86 generating-weaverse-project-json 81 setup-weaverse-project 56 weaverse-content-api 54

Browse all from weaverse/shopify-hydrogen-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 87
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,666 B
  • docs SUMMARY.md 164 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 100 installs

SKILL.md

Hydrogen Upgrades

Version-by-version migration guides for upgrading Shopify Hydrogen. Each guide covers breaking changes, required code updates, and step-by-step diffs.

Live Documentation

For the latest upgrade information from Shopify:

node scripts/search_shopify_docs.mjs "hydrogen upgrade <version>"
node scripts/search_shopify_docs.mjs "hydrogen breaking changes"
node scripts/search_shopify_docs.mjs "hydrogen migration"

The curated guides below cover specific version jumps with detailed diffs and Weaverse-specific considerations.

Available Upgrade Guides

Guide Key Changes
[2024.4.7 → 2024.7.1](./references/upgrade-2024.4.7-to-2024.7.1.md) Optimistic variants, new session commit pattern, Layout component refactor, VariantSelector improvements
[2024.10.1 → 2025.1.0](./references/upgrade-2024.10.1-to-2025.1.0.md) v3_lazyRouteDiscovery flag, stylesheet link tag fixes
[2025.1.0 → 2025.1.1](./references/upgrade-2025.1.0-to-2025.1.1.md) v3_singleFetch flag, nonce support, json/defer deprecation, B2B stabilization
[2025.1.2 → 2025.1.3](./references/upgrade-2025.1.2-to-2025.1.3.md) v3_routeConfig flag, Layout export moved to separate file, routes.ts config
[2025.1.3 → 2025.1.4](./references/upgrade-2025.1.3-to-2025.1.4.md) Session logout fix, VariantSelector deprecation, product query updates, ProductForm refactor
[2025.5.0 → 2025.7.0](./references/upgrade-2025.5.0-to-2025.7.0.md) Major — React Router 7.9.x migration, context creation, entry point updates
[2025.7.0 → 2026.1.0](./references/upgrade-2025.7.0-to-2026.1.0.md) Major — @react-router 7.12, @shopify/hydrogen 2026.1.0, Storefront API 2026-01, new cart mutations

Upgrade Process

1. Use the official upgrade tool first

npx @shopify/upgrade

This CLI diffs your project against the latest Hydrogen skeleton and applies changes interactively.

2. Find the right guide above

Match your current version to the appropriate guide. For multi-version jumps, apply each guide in order.

3. Regenerate types after upgrading

npm run codegen

Never edit .d.ts generated files directly — always regenerate them.

4. Resources