@shopify/cli-hydrogen 13.0.4 → 13.0.6

package/dist/assets/hydrogen/starter/CHANGELOG.md

@@ -1,5 +1,19 @@
 # skeleton
 
+## 2026.4.8
+
+### Patch Changes
+
+- Updated dependencies [[`27d87085aca32f8b0e8ac0cf9eb4d9e6eb016b99`](https://github.com/Shopify/hydrogen/commit/27d87085aca32f8b0e8ac0cf9eb4d9e6eb016b99)]:
+  - @shopify/hydrogen@2026.4.7
+
+## 2026.4.7
+
+### Patch Changes
+
+- Updated dependencies [[`76cdc6c538dc680a3f1ce96a6d704d463afde0ce`](https://github.com/Shopify/hydrogen/commit/76cdc6c538dc680a3f1ce96a6d704d463afde0ce), [`3ef7ec23096ad29e701073b35a892f0938a0acf4`](https://github.com/Shopify/hydrogen/commit/3ef7ec23096ad29e701073b35a892f0938a0acf4)]:
+  - @shopify/hydrogen@2026.4.6
+
 ## 2026.4.6
 
 ### Patch Changes

package/dist/assets/hydrogen/starter/package.json

@@ -2,7 +2,7 @@
   "name": "skeleton",
   "private": true,
   "sideEffects": false,
-  "version": "2026.4.6",
+  "version": "2026.4.8",
   "type": "module",
   "scripts": {
     "build": "shopify hydrogen build --codegen",
@@ -14,7 +14,7 @@
   },
   "prettier": "@shopify/prettier-config",
   "dependencies": {
-    "@shopify/hydrogen": "2026.4.5",
+    "@shopify/hydrogen": "2026.4.7",
     "graphql": "^16.10.0",
     "graphql-tag": "^2.12.6",
     "isbot": "^5.1.22",
@@ -32,7 +32,7 @@
     "@react-router/fs-routes": "7.16.0",
     "@shopify/cli": "3.93.2",
     "@shopify/hydrogen-codegen": "0.3.3",
-    "@shopify/mini-oxygen": "4.2.2",
+    "@shopify/mini-oxygen": "4.2.3",
     "@shopify/oxygen-workers-types": "^4.1.6",
     "@shopify/prettier-config": "^1.1.2",
     "@total-typescript/ts-reset": "^0.6.1",

package/dist/commands/hydrogen/env/pull.js

@@ -20,8 +20,8 @@ function needsQuoting(value) {
 }
 function quoteEnvValue(value) {
   if (!needsQuoting(value)) return value;
-  const escaped = value.replaceAll("\\", "\\\\").replaceAll('"', '\\"').replaceAll("\n", "\\n").replaceAll("\r", "\\r").replaceAll("	", "\\t");
-  return `"${escaped}"`;
+  if (!/['\r\n]/.test(value)) return `'${value}'`;
+  return `"${value.replaceAll("\r", "\\r").replaceAll("\n", "\\n")}"`;
 }
 class EnvPull extends Command {
   static descriptionWithMarkdown = "Pulls environment variables from the linked Hydrogen storefront and writes them to an `.env` file.";

package/dist/commands/hydrogen/init.js

@@ -25,7 +25,7 @@ class Init extends Command {
       env: "SHOPIFY_HYDROGEN_FLAG_LANGUAGE"
     }),
     template: Flags.string({
-      description: "Scaffolds project based on an existing template or example from the Hydrogen repository.",
+      description: "Scaffolds project based on a template: `skeleton` (the default), `demo-store` or a URL to a git repository.",
       env: "SHOPIFY_HYDROGEN_FLAG_TEMPLATE"
     }),
     ...commonFlags.installDeps,

package/dist/lib/onboarding/index.js

@@ -6,7 +6,7 @@ async function setupTemplate(options) {
   const controller = new AbortController();
   try {
     const template = options.template;
-    return template ? await setupRemoteTemplate({ ...options, template }, controller) : await setupLocalStarterTemplate(options, controller);
+    return template && template !== "skeleton" ? await setupRemoteTemplate({ ...options, template }, controller) : await setupLocalStarterTemplate(options, controller);
   } catch (error) {
     controller.abort();
     throw error;

package/dist/lib/onboarding/remote.js

@@ -1,9 +1,8 @@
-import { readdir } from 'node:fs/promises';
 import { AbortError } from '@shopify/cli-kit/node/error';
 import { copyFile, fileExists } from '@shopify/cli-kit/node/fs';
 import { joinPath } from '@shopify/cli-kit/node/path';
 import { renderTasks, renderInfo } from '@shopify/cli-kit/node/ui';
-import { downloadExternalRepo, downloadMonorepoTemplates } from '../template-downloader.js';
+import { downloadExternalRepo } from '../template-downloader.js';
 import { getCliCommand } from '../shell.js';
 import { handleProjectLocation, createAbortHandler, handleLanguage, createInitialCommit, handleDependencies, commitAll, renderProjectReady } from './common.js';
 
@@ -13,7 +12,7 @@ async function setupRemoteTemplate(options, controller) {
   const project = await handleProjectLocation({ ...options, controller });
   if (!project) return;
   const abort = createAbortHandler(controller, project);
-  const backgroundDownloadPromise = appTemplate.includes("/") ? getExternalTemplate(appTemplate, controller.signal).catch(abort) : getMonorepoTemplate(appTemplate, controller.signal).catch(abort);
+  const backgroundDownloadPromise = appTemplate.includes("/") ? getExternalTemplate(appTemplate, controller.signal).catch(abort) : rejectUnknownTemplate(appTemplate).catch(abort);
   const downloaded = await backgroundDownloadPromise;
   if (controller.signal.aborted) return;
   let backgroundWorkPromise = Promise.resolve().then(async () => {
@@ -86,26 +85,18 @@ async function getExternalTemplate(appTemplate, signal) {
   const { templateDir } = await downloadExternalRepo(appTemplate, signal);
   return { sourcePath: templateDir };
 }
-async function getMonorepoTemplate(appTemplate, signal) {
-  const { templatesDir, examplesDir } = await downloadMonorepoTemplates({
-    signal
-  });
-  const skeletonPath = joinPath(templatesDir, "skeleton");
-  const templatePath = joinPath(templatesDir, appTemplate);
-  const examplePath = joinPath(examplesDir, appTemplate);
-  if (await fileExists(templatePath)) {
-    return { skeletonPath, sourcePath: templatePath };
-  }
-  if (await fileExists(examplePath)) {
-    return { skeletonPath, sourcePath: examplePath };
-  }
-  const availableTemplates = (await Promise.all([readdir(examplesDir), readdir(templatesDir)]).catch(
-    () => []
-  )).flat().filter((name) => name !== "skeleton" && !name.endsWith(".md")).concat("demo-store").sort();
+async function rejectUnknownTemplate(appTemplate) {
   throw new AbortError(
     `Unknown value in \`--template\` flag "${appTemplate}".
-Skip the flag or provide the name of a template or example in the Hydrogen repository or a URL to a git repository.`,
-    availableTemplates.length === 0 ? "" : { list: { title: "Available templates:", items: availableTemplates } }
+Skip the flag or provide the name of a template or a URL to a git repository.`,
+    {
+      list: {
+        title: "Available templates:",
+        // Note: skeleton uses the local starter flow, and demo-store is
+        // handled as an external template
+        items: ["skeleton", "demo-store"]
+      }
+    }
   );
 }
 

package/dist/lib/onboarding/setup-template.mocks.js

@@ -1,19 +1,11 @@
 import { rm, symlink } from 'node:fs/promises';
 import { vi } from 'vitest';
 import { writeFile } from '@shopify/cli-kit/node/fs';
-import { dirname, joinPath } from '@shopify/cli-kit/node/path';
+import { joinPath } from '@shopify/cli-kit/node/path';
 import { getSkeletonSourceDir, getSkeletonNodeModules } from '../build.js';
 
 const { renderTasksHook } = vi.hoisted(() => ({ renderTasksHook: vi.fn() }));
 vi.mock("../template-downloader.js", async () => ({
-  downloadMonorepoTemplates: () => Promise.resolve({
-    version: "",
-    templatesDir: dirname(getSkeletonSourceDir()),
-    examplesDir: dirname(getSkeletonSourceDir()).replace(
-      "templates",
-      "examples"
-    )
-  }),
   downloadExternalRepo: () => Promise.resolve({
     templateDir: getSkeletonSourceDir()
   })

package/dist/lib/template-downloader.js

@@ -1,92 +1,10 @@
-import path from 'node:path';
-import { pipeline } from 'stream/promises';
-import gunzipMaybe from 'gunzip-maybe';
-import { extract } from 'tar-fs';
-import { fetch } from '@shopify/cli-kit/node/http';
 import { parseGitHubRepositoryURL } from '@shopify/cli-kit/node/github';
 import { fileExists, mkdir, rmdir } from '@shopify/cli-kit/node/fs';
 import { AbortError } from '@shopify/cli-kit/node/error';
-import { isHydrogenMonorepo, getSkeletonSourceDir, getAssetsDir } from './build.js';
+import { getAssetsDir } from './build.js';
 import { joinPath } from '@shopify/cli-kit/node/path';
 import { downloadGitRepository } from '@shopify/cli-kit/node/git';
 
-const REPO_RELEASES_URL = `https://api.github.com/repos/shopify/hydrogen/releases/latest`;
-const getTryMessage = (status) => status === 403 ? `If you are using a VPN, WARP, or similar service, consider disabling it momentarily.` : void 0;
-async function getLatestReleaseDownloadUrl(signal) {
-  const response = await fetch(REPO_RELEASES_URL, { signal });
-  if (!response.ok || response.status >= 400) {
-    throw new AbortError(
-      `Failed to fetch the latest release information. Status ${response.status} ${response.statusText.replace(/\.$/, "")}.`,
-      getTryMessage(response.status)
-    );
-  }
-  const release = await response.json();
-  return {
-    // @shopify/package-name@version => package-name@version
-    version: release.name.split("/").pop() ?? release.name,
-    url: release.tarball_url
-  };
-}
-async function downloadMonorepoTarball(url, storageDir, signal) {
-  const response = await fetch(url, { signal });
-  if (!response.ok || response.status >= 400) {
-    throw new AbortError(
-      `Failed to download the latest release files. Status ${response.status} ${response.statusText}}`,
-      getTryMessage(response.status)
-    );
-  }
-  await pipeline(
-    // Download
-    response.body,
-    // Decompress
-    gunzipMaybe(),
-    // Unpack
-    extract(storageDir, {
-      strip: 1,
-      filter: (name) => {
-        name = name.replace(storageDir, "");
-        return !name.startsWith(path.normalize("/templates/")) && !name.startsWith(path.normalize("/examples/"));
-      }
-    })
-  );
-}
-async function downloadMonorepoTemplates({
-  signal
-} = {}) {
-  if (isHydrogenMonorepo && process.env.FORCE_TEMPLATES_SOURCE !== "remote") {
-    const templatesDir = path.dirname(getSkeletonSourceDir());
-    return {
-      version: "local",
-      templatesDir,
-      examplesDir: path.resolve(templatesDir, "..", "examples")
-    };
-  }
-  try {
-    const { version, url } = await getLatestReleaseDownloadUrl(signal);
-    const templateStoragePath = await getAssetsDir("internal-templates");
-    if (!await fileExists(templateStoragePath)) {
-      await mkdir(templateStoragePath);
-    }
-    const templateStorageVersionPath = path.join(templateStoragePath, version);
-    if (!await fileExists(templateStorageVersionPath)) {
-      await downloadMonorepoTarball(url, templateStorageVersionPath, signal);
-    }
-    return {
-      version,
-      templatesDir: path.join(templateStorageVersionPath, "templates"),
-      examplesDir: path.join(templateStorageVersionPath, "examples")
-    };
-  } catch (e) {
-    const error = e;
-    throw new AbortError(
-      `Could not download Hydrogen templates from GitHub.
-Please check your internet connection and the following error:
-
-` + error.message,
-      error.tryMessage
-    );
-  }
-}
 async function downloadExternalRepo(appTemplate, signal) {
   const parsed = parseGitHubRepositoryURL(appTemplate);
   if (parsed.isErr()) {
@@ -113,4 +31,4 @@ async function downloadExternalRepo(appTemplate, signal) {
   return { templateDir };
 }
 
-export { downloadExternalRepo, downloadMonorepoTemplates };
+export { downloadExternalRepo };

package/oclif.manifest.json

@@ -1045,7 +1045,7 @@
           "type": "option"
         },
         "template": {
-          "description": "Scaffolds project based on an existing template or example from the Hydrogen repository.",
+          "description": "Scaffolds project based on a template: `skeleton` (the default), `demo-store` or a URL to a git repository.",
           "env": "SHOPIFY_HYDROGEN_FLAG_TEMPLATE",
           "name": "template",
           "hasDynamicHelp": false,
@@ -1751,5 +1751,5 @@
       ]
     }
   },
-  "version": "13.0.4"
+  "version": "13.0.6"
 }

package/package.json

@@ -4,7 +4,7 @@
     "access": "public",
     "@shopify:registry": "https://registry.npmjs.org"
   },
-  "version": "13.0.4",
+  "version": "13.0.6",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -59,7 +59,7 @@
     "graphql-config": "^5.0.3",
     "vite": "^5.1.0 || ^6.2.0 || ^7.0.0 || ^8.0.0",
     "@shopify/hydrogen-codegen": "0.3.3",
-    "@shopify/mini-oxygen": "4.2.2"
+    "@shopify/mini-oxygen": "4.2.3"
   },
   "peerDependenciesMeta": {
     "@graphql-codegen/cli": {