@shopify/cli-hydrogen 7.1.2 → 8.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) hide show
  1. package/dist/commands/hydrogen/build-vite.js +19 -10
  2. package/dist/commands/hydrogen/build.js +10 -2
  3. package/dist/commands/hydrogen/check.js +1 -0
  4. package/dist/commands/hydrogen/codegen.js +1 -0
  5. package/dist/commands/hydrogen/customer-account/push.js +170 -0
  6. package/dist/commands/hydrogen/debug/cpu.js +10 -1
  7. package/dist/commands/hydrogen/deploy.js +110 -36
  8. package/dist/commands/hydrogen/dev-vite.js +128 -59
  9. package/dist/commands/hydrogen/dev.js +108 -51
  10. package/dist/commands/hydrogen/env/list.js +20 -28
  11. package/dist/commands/hydrogen/env/pull.js +29 -19
  12. package/dist/commands/hydrogen/env/{push__unstable.js → push.js} +34 -68
  13. package/dist/commands/hydrogen/generate/route.js +1 -0
  14. package/dist/commands/hydrogen/init.js +39 -21
  15. package/dist/commands/hydrogen/link.js +25 -6
  16. package/dist/commands/hydrogen/list.js +1 -0
  17. package/dist/commands/hydrogen/login.js +1 -0
  18. package/dist/commands/hydrogen/logout.js +1 -0
  19. package/dist/commands/hydrogen/preview.js +31 -16
  20. package/dist/commands/hydrogen/setup/css.js +8 -1
  21. package/dist/commands/hydrogen/setup/markets.js +1 -0
  22. package/dist/commands/hydrogen/setup/vite.js +244 -138
  23. package/dist/commands/hydrogen/setup.js +21 -23
  24. package/dist/commands/hydrogen/shortcut.js +10 -0
  25. package/dist/commands/hydrogen/unlink.js +1 -0
  26. package/dist/commands/hydrogen/upgrade.js +2 -1
  27. package/dist/generator-templates/assets/vite/package.json +3 -4
  28. package/dist/generator-templates/assets/vite/vite.config.js +15 -2
  29. package/dist/generator-templates/starter/CHANGELOG.md +129 -0
  30. package/dist/generator-templates/starter/README.md +3 -44
  31. package/dist/generator-templates/starter/app/components/Footer.tsx +1 -1
  32. package/dist/generator-templates/starter/app/components/Header.tsx +1 -1
  33. package/dist/generator-templates/starter/app/graphql/customer-account/CustomerDetailsQuery.ts +1 -0
  34. package/dist/generator-templates/starter/app/lib/fragments.ts +2 -0
  35. package/dist/generator-templates/starter/app/lib/root-data.ts +11 -0
  36. package/dist/generator-templates/starter/app/root.tsx +4 -20
  37. package/dist/generator-templates/starter/app/routes/account.orders._index.tsx +1 -1
  38. package/dist/generator-templates/starter/app/routes/account.tsx +1 -1
  39. package/dist/generator-templates/starter/app/routes/blogs.$blogHandle._index.tsx +3 -3
  40. package/dist/generator-templates/starter/app/routes/cart.tsx +1 -1
  41. package/dist/generator-templates/starter/app/routes/collections.all.tsx +160 -0
  42. package/dist/generator-templates/starter/app/routes/products.$handle.tsx +1 -2
  43. package/dist/generator-templates/starter/customer-accountapi.generated.d.ts +6 -3
  44. package/dist/generator-templates/starter/{remix.env.d.ts → env.d.ts} +8 -2
  45. package/dist/generator-templates/starter/package.json +14 -9
  46. package/dist/generator-templates/starter/server.ts +2 -1
  47. package/dist/generator-templates/starter/storefrontapi.generated.d.ts +59 -3
  48. package/dist/generator-templates/starter/vite.config.ts +26 -0
  49. package/dist/{commands/hydrogen/init.d.ts → init.d.ts} +11 -4
  50. package/dist/lib/check-lockfile.js +12 -18
  51. package/dist/lib/codegen.js +37 -13
  52. package/dist/lib/common.js +50 -0
  53. package/dist/lib/cpu-profiler.js +4 -1
  54. package/dist/lib/dev-shared.js +99 -0
  55. package/dist/lib/environment-variables.js +51 -30
  56. package/dist/lib/file.js +8 -1
  57. package/dist/lib/flags.js +37 -26
  58. package/dist/lib/get-oxygen-deployment-data.js +10 -17
  59. package/dist/lib/graphql/admin/customer-application-update.js +29 -0
  60. package/dist/lib/graphql/admin/get-oxygen-data.js +1 -0
  61. package/dist/lib/graphql/admin/list-environments.js +1 -0
  62. package/dist/lib/graphql/admin/pull-variables.js +4 -4
  63. package/dist/lib/graphql/admin/test-helper.js +37 -0
  64. package/dist/lib/log.js +86 -13
  65. package/dist/lib/mini-oxygen/common.js +19 -33
  66. package/dist/lib/mini-oxygen/index.js +6 -2
  67. package/dist/lib/mini-oxygen/node.js +43 -31
  68. package/dist/lib/mini-oxygen/workerd.js +72 -165
  69. package/dist/lib/missing-routes.js +1 -1
  70. package/dist/lib/onboarding/common.js +85 -70
  71. package/dist/lib/onboarding/local.js +19 -9
  72. package/dist/lib/onboarding/remote.js +35 -30
  73. package/dist/lib/package-managers.js +24 -0
  74. package/dist/lib/remix-config.js +17 -1
  75. package/dist/lib/render-errors.js +17 -10
  76. package/dist/lib/request-events.js +6 -1
  77. package/dist/lib/setups/i18n/replacers.js +9 -6
  78. package/dist/lib/setups/routes/generate.js +1 -0
  79. package/dist/lib/shell.js +2 -1
  80. package/dist/lib/shopify-config.js +19 -1
  81. package/dist/lib/template-diff.js +36 -15
  82. package/dist/lib/template-downloader.js +35 -5
  83. package/dist/lib/transpile/morph/functions.js +26 -8
  84. package/dist/lib/transpile/morph/typedefs.js +6 -4
  85. package/dist/lib/transpile/project.js +8 -4
  86. package/dist/lib/tunneling.js +44 -0
  87. package/dist/lib/verify-linked-storefront.js +24 -0
  88. package/dist/lib/virtual-routes.js +1 -1
  89. package/dist/lib/vite-config.js +39 -9
  90. package/oclif.manifest.json +704 -508
  91. package/package.json +32 -24
  92. package/dist/commands/hydrogen/deploy.test.js +0 -553
  93. package/dist/commands/hydrogen/env/list.test.js +0 -148
  94. package/dist/commands/hydrogen/env/pull.test.js +0 -207
  95. package/dist/commands/hydrogen/env/push__unstable.test.js +0 -383
  96. package/dist/commands/hydrogen/generate/route.test.js +0 -43
  97. package/dist/commands/hydrogen/init.test.js +0 -641
  98. package/dist/commands/hydrogen/link.test.js +0 -187
  99. package/dist/commands/hydrogen/list.test.js +0 -111
  100. package/dist/commands/hydrogen/setup.test.js +0 -61
  101. package/dist/commands/hydrogen/shortcut.test.js +0 -30
  102. package/dist/commands/hydrogen/unlink.test.js +0 -36
  103. package/dist/commands/hydrogen/upgrade.test.js +0 -786
  104. package/dist/generator-templates/starter/remix.config.js +0 -24
  105. package/dist/lib/auth.test.js +0 -157
  106. package/dist/lib/check-lockfile.test.js +0 -81
  107. package/dist/lib/check-version.test.js +0 -86
  108. package/dist/lib/environment-variables.test.js +0 -149
  109. package/dist/lib/file.test.js +0 -68
  110. package/dist/lib/flags.test.js +0 -43
  111. package/dist/lib/get-oxygen-deployment-data.test.js +0 -120
  112. package/dist/lib/gid.test.js +0 -15
  113. package/dist/lib/graphql/admin/client.test.js +0 -76
  114. package/dist/lib/graphql/admin/create-storefront.test.js +0 -64
  115. package/dist/lib/graphql/admin/link-storefront.test.js +0 -38
  116. package/dist/lib/graphql/admin/list-environments.test.js +0 -44
  117. package/dist/lib/graphql/admin/list-storefronts.test.js +0 -44
  118. package/dist/lib/graphql/admin/pull-variables.test.js +0 -43
  119. package/dist/lib/graphql/business-platform/user-account.test.js +0 -80
  120. package/dist/lib/log.test.js +0 -92
  121. package/dist/lib/mini-oxygen/assets.js +0 -134
  122. package/dist/lib/mini-oxygen/mini-oxygen.test.js +0 -214
  123. package/dist/lib/mini-oxygen/workerd-inspector-logs.js +0 -227
  124. package/dist/lib/mini-oxygen/workerd-inspector-proxy.js +0 -200
  125. package/dist/lib/mini-oxygen/workerd-inspector.js +0 -219
  126. package/dist/lib/missing-routes.test.js +0 -45
  127. package/dist/lib/remix-version-check.test.js +0 -39
  128. package/dist/lib/remix-version-interop.test.js +0 -13
  129. package/dist/lib/setups/i18n/domains.test.js +0 -39
  130. package/dist/lib/setups/i18n/replacers.test.js +0 -261
  131. package/dist/lib/setups/i18n/subdomains.test.js +0 -39
  132. package/dist/lib/setups/i18n/subfolders.test.js +0 -39
  133. package/dist/lib/setups/routes/generate.test.js +0 -296
  134. package/dist/lib/shell.test.js +0 -111
  135. package/dist/lib/shopify-config.test.js +0 -199
  136. package/dist/lib/string.test.js +0 -16
  137. package/dist/lib/virtual-routes.test.js +0 -49
  138. package/dist/lib/vite/hydrogen-middleware.js +0 -82
  139. package/dist/lib/vite/mini-oxygen.js +0 -152
  140. package/dist/lib/vite/plugins.d.ts +0 -27
  141. package/dist/lib/vite/plugins.js +0 -139
  142. package/dist/lib/vite/shared.js +0 -10
  143. package/dist/lib/vite/utils.js +0 -55
  144. package/dist/lib/vite/worker-entry.js +0 -1518
  145. /package/dist/generator-templates/starter/{.eslintrc.js → .eslintrc.cjs} +0 -0
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "commands": {
3
- "hydrogen:build-vite": {
3
+ "hydrogen:build": {
4
4
  "aliases": [],
5
5
  "args": {},
6
6
  "description": "Builds a Hydrogen storefront for production.",
@@ -13,14 +13,6 @@
13
13
  "multiple": false,
14
14
  "type": "option"
15
15
  },
16
- "entry": {
17
- "description": "Entry file for the worker. Defaults to `./server`.",
18
- "env": "SHOPIFY_HYDROGEN_FLAG_ENTRY",
19
- "name": "entry",
20
- "hasDynamicHelp": false,
21
- "multiple": false,
22
- "type": "option"
23
- },
24
16
  "sourcemap": {
25
17
  "description": "Controls whether sourcemaps are generated. Default to `true`. Deactivate `--no-sourcemaps`.",
26
18
  "env": "SHOPIFY_HYDROGEN_FLAG_SOURCEMAP",
@@ -28,6 +20,12 @@
28
20
  "allowNo": true,
29
21
  "type": "boolean"
30
22
  },
23
+ "bundle-stats": {
24
+ "description": "Show a bundle size summary after building. Defaults to true, use `--no-bundle-stats` to disable.",
25
+ "name": "bundle-stats",
26
+ "allowNo": true,
27
+ "type": "boolean"
28
+ },
31
29
  "lockfile-check": {
32
30
  "description": "Checks that there is exactly one valid lockfile in the project. Defaults to `true`. Deactivate with `--no-lockfile-check`.",
33
31
  "env": "SHOPIFY_HYDROGEN_FLAG_LOCKFILE_CHECK",
@@ -71,20 +69,21 @@
71
69
  },
72
70
  "hasDynamicHelp": false,
73
71
  "hiddenAliases": [],
74
- "id": "hydrogen:build-vite",
72
+ "id": "hydrogen:build",
75
73
  "pluginAlias": "@shopify/cli-hydrogen",
76
74
  "pluginName": "@shopify/cli-hydrogen",
77
75
  "pluginType": "core",
78
76
  "strict": true,
77
+ "descriptionWithMarkdown": "Builds a Hydrogen storefront for production. The client and app worker files are compiled to a `/dist` folder in your Hydrogen project directory.",
79
78
  "isESM": true,
80
79
  "relativePath": [
81
80
  "dist",
82
81
  "commands",
83
82
  "hydrogen",
84
- "build-vite.js"
83
+ "build.js"
85
84
  ]
86
85
  },
87
- "hydrogen:build": {
86
+ "hydrogen:build-vite": {
88
87
  "aliases": [],
89
88
  "args": {},
90
89
  "description": "Builds a Hydrogen storefront for production.",
@@ -97,6 +96,14 @@
97
96
  "multiple": false,
98
97
  "type": "option"
99
98
  },
99
+ "entry": {
100
+ "description": "Entry file for the worker. Defaults to `./server`.",
101
+ "env": "SHOPIFY_HYDROGEN_FLAG_ENTRY",
102
+ "name": "entry",
103
+ "hasDynamicHelp": false,
104
+ "multiple": false,
105
+ "type": "option"
106
+ },
100
107
  "sourcemap": {
101
108
  "description": "Controls whether sourcemaps are generated. Default to `true`. Deactivate `--no-sourcemaps`.",
102
109
  "env": "SHOPIFY_HYDROGEN_FLAG_SOURCEMAP",
@@ -104,12 +111,6 @@
104
111
  "allowNo": true,
105
112
  "type": "boolean"
106
113
  },
107
- "bundle-stats": {
108
- "description": "Show a bundle size summary after building. Defaults to true, use `--no-bundle-stats` to disable.",
109
- "name": "bundle-stats",
110
- "allowNo": true,
111
- "type": "boolean"
112
- },
113
114
  "lockfile-check": {
114
115
  "description": "Checks that there is exactly one valid lockfile in the project. Defaults to `true`. Deactivate with `--no-lockfile-check`.",
115
116
  "env": "SHOPIFY_HYDROGEN_FLAG_LOCKFILE_CHECK",
@@ -152,8 +153,9 @@
152
153
  }
153
154
  },
154
155
  "hasDynamicHelp": false,
156
+ "hidden": true,
155
157
  "hiddenAliases": [],
156
- "id": "hydrogen:build",
158
+ "id": "hydrogen:build-vite",
157
159
  "pluginAlias": "@shopify/cli-hydrogen",
158
160
  "pluginName": "@shopify/cli-hydrogen",
159
161
  "pluginType": "core",
@@ -163,7 +165,7 @@
163
165
  "dist",
164
166
  "commands",
165
167
  "hydrogen",
166
- "build.js"
168
+ "build-vite.js"
167
169
  ]
168
170
  },
169
171
  "hydrogen:check": {
@@ -196,6 +198,7 @@
196
198
  "pluginName": "@shopify/cli-hydrogen",
197
199
  "pluginType": "core",
198
200
  "strict": true,
201
+ "descriptionWithMarkdown": "Checks whether your Hydrogen app includes a set of standard Shopify routes.",
199
202
  "isESM": true,
200
203
  "relativePath": [
201
204
  "dist",
@@ -248,6 +251,7 @@
248
251
  "pluginName": "@shopify/cli-hydrogen",
249
252
  "pluginType": "core",
250
253
  "strict": true,
254
+ "descriptionWithMarkdown": "Automatically generates GraphQL types for your project’s Storefront API queries.",
251
255
  "isESM": true,
252
256
  "relativePath": [
253
257
  "dist",
@@ -256,15 +260,136 @@
256
260
  "codegen.js"
257
261
  ]
258
262
  },
263
+ "hydrogen:customer-account:push": {
264
+ "aliases": [],
265
+ "args": {},
266
+ "description": "Push project configuration to admin",
267
+ "flags": {
268
+ "path": {
269
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
270
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
271
+ "name": "path",
272
+ "hasDynamicHelp": false,
273
+ "multiple": false,
274
+ "type": "option"
275
+ },
276
+ "storefront-id": {
277
+ "description": "The id of the storefront the configuration should be pushed to. Must start with 'gid://shopify/HydrogenStorefront/'",
278
+ "name": "storefront-id",
279
+ "hasDynamicHelp": false,
280
+ "multiple": false,
281
+ "type": "option"
282
+ },
283
+ "dev-origin": {
284
+ "description": "The development domain of your application.",
285
+ "name": "dev-origin",
286
+ "required": true,
287
+ "hasDynamicHelp": false,
288
+ "multiple": false,
289
+ "type": "option"
290
+ },
291
+ "relative-redirect-uri": {
292
+ "description": "The relative url of allowed callback url for Customer Account API OAuth flow. Default is '/account/authorize'",
293
+ "name": "relative-redirect-uri",
294
+ "hasDynamicHelp": false,
295
+ "multiple": false,
296
+ "type": "option"
297
+ },
298
+ "relative-logout-uri": {
299
+ "description": "The relative url of allowed url that will be redirected to post-logout for Customer Account API OAuth flow. Default to nothing.",
300
+ "name": "relative-logout-uri",
301
+ "hasDynamicHelp": false,
302
+ "multiple": false,
303
+ "type": "option"
304
+ }
305
+ },
306
+ "hasDynamicHelp": false,
307
+ "hiddenAliases": [],
308
+ "id": "hydrogen:customer-account:push",
309
+ "pluginAlias": "@shopify/cli-hydrogen",
310
+ "pluginName": "@shopify/cli-hydrogen",
311
+ "pluginType": "core",
312
+ "strict": true,
313
+ "isESM": true,
314
+ "relativePath": [
315
+ "dist",
316
+ "commands",
317
+ "hydrogen",
318
+ "customer-account",
319
+ "push.js"
320
+ ]
321
+ },
322
+ "hydrogen:debug:cpu": {
323
+ "aliases": [],
324
+ "args": {},
325
+ "description": "Builds and profiles the server startup time the app.",
326
+ "flags": {
327
+ "path": {
328
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
329
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
330
+ "name": "path",
331
+ "hasDynamicHelp": false,
332
+ "multiple": false,
333
+ "type": "option"
334
+ },
335
+ "output": {
336
+ "description": "Specify a path to generate the profile file. Defaults to \"startup.cpuprofile\".",
337
+ "name": "output",
338
+ "required": false,
339
+ "default": "startup.cpuprofile",
340
+ "hasDynamicHelp": false,
341
+ "multiple": false,
342
+ "type": "option"
343
+ }
344
+ },
345
+ "hasDynamicHelp": false,
346
+ "hiddenAliases": [],
347
+ "id": "hydrogen:debug:cpu",
348
+ "pluginAlias": "@shopify/cli-hydrogen",
349
+ "pluginName": "@shopify/cli-hydrogen",
350
+ "pluginType": "core",
351
+ "strict": true,
352
+ "descriptionWithMarkdown": "Builds the app and runs the resulting code to profile the server startup time, watching for changes. This command can be used to [debug slow app startup times](https://shopify.dev/docs/custom-storefronts/hydrogen/debugging/cpu-startup) that cause failed deployments in Oxygen.\n\n The profiling results are written to a `.cpuprofile` file that can be viewed with certain tools such as [Flame Chart Visualizer for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-js-profile-flame).",
353
+ "isESM": true,
354
+ "relativePath": [
355
+ "dist",
356
+ "commands",
357
+ "hydrogen",
358
+ "debug",
359
+ "cpu.js"
360
+ ]
361
+ },
259
362
  "hydrogen:deploy": {
260
363
  "aliases": [],
261
364
  "args": {},
262
365
  "description": "Builds and deploys a Hydrogen storefront to Oxygen.",
263
366
  "flags": {
367
+ "entry": {
368
+ "description": "Entry file for the worker. Defaults to `./server`.",
369
+ "env": "SHOPIFY_HYDROGEN_FLAG_ENTRY",
370
+ "name": "entry",
371
+ "hasDynamicHelp": false,
372
+ "multiple": false,
373
+ "type": "option"
374
+ },
375
+ "env": {
376
+ "description": "Specifies the environment to perform the operation using its handle. Fetch the handle using the `env list` command.",
377
+ "exclusive": [
378
+ "env-branch"
379
+ ],
380
+ "name": "env",
381
+ "hasDynamicHelp": false,
382
+ "multiple": false,
383
+ "type": "option"
384
+ },
264
385
  "env-branch": {
265
- "description": "Environment branch (tag) for environment to deploy to.",
386
+ "deprecated": {
387
+ "to": "env",
388
+ "message": "--env-branch is deprecated. Use --env instead."
389
+ },
390
+ "description": "Specifies the environment to perform the operation using its Git branch name.",
391
+ "env": "SHOPIFY_HYDROGEN_ENVIRONMENT_BRANCH",
266
392
  "name": "env-branch",
267
- "required": false,
268
393
  "hasDynamicHelp": false,
269
394
  "multiple": false,
270
395
  "type": "option"
@@ -408,6 +533,7 @@
408
533
  "pluginName": "@shopify/cli-hydrogen",
409
534
  "pluginType": "core",
410
535
  "strict": true,
536
+ "descriptionWithMarkdown": "Builds and deploys your Hydrogen storefront to Oxygen. Requires an Oxygen deployment token to be set with the `--token` flag or an environment variable (`SHOPIFY_HYDROGEN_DEPLOYMENT_TOKEN`). If the storefront is [linked](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-link) then the Oxygen deployment token for the linked storefront will be used automatically.",
411
537
  "isESM": true,
412
538
  "relativePath": [
413
539
  "dist",
@@ -416,7 +542,7 @@
416
542
  "deploy.js"
417
543
  ]
418
544
  },
419
- "hydrogen:dev-vite": {
545
+ "hydrogen:dev": {
420
546
  "aliases": [],
421
547
  "args": {},
422
548
  "description": "Runs Hydrogen storefront in an Oxygen worker for development.",
@@ -429,23 +555,26 @@
429
555
  "multiple": false,
430
556
  "type": "option"
431
557
  },
432
- "entry": {
433
- "description": "Entry file for the worker. Defaults to `./server`.",
434
- "env": "SHOPIFY_HYDROGEN_FLAG_ENTRY",
435
- "name": "entry",
436
- "hasDynamicHelp": false,
437
- "multiple": false,
438
- "type": "option"
439
- },
440
558
  "port": {
441
559
  "description": "The port to run the server on. Defaults to 3000.",
442
560
  "env": "SHOPIFY_HYDROGEN_FLAG_PORT",
443
561
  "name": "port",
444
- "required": false,
445
562
  "hasDynamicHelp": false,
446
563
  "multiple": false,
447
564
  "type": "option"
448
565
  },
566
+ "worker": {
567
+ "hidden": true,
568
+ "name": "worker",
569
+ "type": "boolean"
570
+ },
571
+ "legacy-runtime": {
572
+ "description": "Runs the app in a Node.js sandbox instead of an Oxygen worker.",
573
+ "env": "SHOPIFY_HYDROGEN_FLAG_WORKER",
574
+ "name": "legacy-runtime",
575
+ "allowNo": false,
576
+ "type": "boolean"
577
+ },
449
578
  "codegen": {
450
579
  "description": "Automatically generates GraphQL types for your project’s Storefront API queries.",
451
580
  "name": "codegen",
@@ -464,6 +593,13 @@
464
593
  "multiple": false,
465
594
  "type": "option"
466
595
  },
596
+ "sourcemap": {
597
+ "description": "Controls whether sourcemaps are generated. Default to `true`. Deactivate `--no-sourcemaps`.",
598
+ "env": "SHOPIFY_HYDROGEN_FLAG_SOURCEMAP",
599
+ "name": "sourcemap",
600
+ "allowNo": true,
601
+ "type": "boolean"
602
+ },
467
603
  "disable-virtual-routes": {
468
604
  "description": "Disable rendering fallback routes when a route file doesn't exist.",
469
605
  "env": "SHOPIFY_HYDROGEN_FLAG_DISABLE_VIRTUAL_ROUTES",
@@ -482,21 +618,26 @@
482
618
  "description": "The port where the inspector is available. Defaults to 9229.",
483
619
  "env": "SHOPIFY_HYDROGEN_FLAG_INSPECTOR_PORT",
484
620
  "name": "inspector-port",
485
- "default": 9229,
486
621
  "hasDynamicHelp": false,
487
622
  "multiple": false,
488
623
  "type": "option"
489
624
  },
490
- "host": {
491
- "description": "Expose the server to the network",
492
- "name": "host",
493
- "required": false,
494
- "allowNo": false,
495
- "type": "boolean"
625
+ "env": {
626
+ "description": "Specifies the environment to perform the operation using its handle. Fetch the handle using the `env list` command.",
627
+ "exclusive": [
628
+ "env-branch"
629
+ ],
630
+ "name": "env",
631
+ "hasDynamicHelp": false,
632
+ "multiple": false,
633
+ "type": "option"
496
634
  },
497
635
  "env-branch": {
498
- "char": "e",
499
- "description": "Specifies the environment to pull variables from using its Git branch name.",
636
+ "deprecated": {
637
+ "to": "env",
638
+ "message": "--env-branch is deprecated. Use --env instead."
639
+ },
640
+ "description": "Specifies the environment to perform the operation using its Git branch name.",
500
641
  "env": "SHOPIFY_HYDROGEN_ENVIRONMENT_BRANCH",
501
642
  "name": "env-branch",
502
643
  "hasDynamicHelp": false,
@@ -517,24 +658,42 @@
517
658
  "required": false,
518
659
  "allowNo": false,
519
660
  "type": "boolean"
661
+ },
662
+ "customer-account-push__unstable": {
663
+ "description": "Use tunneling for local development and push the tunneling domain to admin. Required to use Customer Account API's Oauth flow",
664
+ "env": "SHOPIFY_HYDROGEN_FLAG_CUSTOMER_ACCOUNT_PUSH",
665
+ "hidden": true,
666
+ "name": "customer-account-push__unstable",
667
+ "required": false,
668
+ "allowNo": false,
669
+ "type": "boolean"
670
+ },
671
+ "verbose": {
672
+ "description": "Outputs more information about the command's execution.",
673
+ "env": "SHOPIFY_HYDROGEN_FLAG_VERBOSE",
674
+ "name": "verbose",
675
+ "required": false,
676
+ "allowNo": false,
677
+ "type": "boolean"
520
678
  }
521
679
  },
522
680
  "hasDynamicHelp": false,
523
681
  "hiddenAliases": [],
524
- "id": "hydrogen:dev-vite",
682
+ "id": "hydrogen:dev",
525
683
  "pluginAlias": "@shopify/cli-hydrogen",
526
684
  "pluginName": "@shopify/cli-hydrogen",
527
685
  "pluginType": "core",
528
686
  "strict": true,
687
+ "descriptionWithMarkdown": "Runs a Hydrogen storefront in a local runtime that emulates an Oxygen worker for development.\n\n If your project is [linked](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-link) to a Hydrogen storefront, then its environment variables will be loaded with the runtime.",
529
688
  "isESM": true,
530
689
  "relativePath": [
531
690
  "dist",
532
691
  "commands",
533
692
  "hydrogen",
534
- "dev-vite.js"
693
+ "dev.js"
535
694
  ]
536
695
  },
537
- "hydrogen:dev": {
696
+ "hydrogen:dev-vite": {
538
697
  "aliases": [],
539
698
  "args": {},
540
699
  "description": "Runs Hydrogen storefront in an Oxygen worker for development.",
@@ -547,27 +706,23 @@
547
706
  "multiple": false,
548
707
  "type": "option"
549
708
  },
709
+ "entry": {
710
+ "description": "Entry file for the worker. Defaults to `./server`.",
711
+ "env": "SHOPIFY_HYDROGEN_FLAG_ENTRY",
712
+ "name": "entry",
713
+ "hasDynamicHelp": false,
714
+ "multiple": false,
715
+ "type": "option"
716
+ },
550
717
  "port": {
551
718
  "description": "The port to run the server on. Defaults to 3000.",
552
719
  "env": "SHOPIFY_HYDROGEN_FLAG_PORT",
553
720
  "name": "port",
554
- "default": 3000,
721
+ "required": false,
555
722
  "hasDynamicHelp": false,
556
723
  "multiple": false,
557
724
  "type": "option"
558
725
  },
559
- "worker": {
560
- "hidden": true,
561
- "name": "worker",
562
- "type": "boolean"
563
- },
564
- "legacy-runtime": {
565
- "description": "Runs the app in a Node.js sandbox instead of an Oxygen worker.",
566
- "env": "SHOPIFY_HYDROGEN_FLAG_WORKER",
567
- "name": "legacy-runtime",
568
- "allowNo": false,
569
- "type": "boolean"
570
- },
571
726
  "codegen": {
572
727
  "description": "Automatically generates GraphQL types for your project’s Storefront API queries.",
573
728
  "name": "codegen",
@@ -586,13 +741,6 @@
586
741
  "multiple": false,
587
742
  "type": "option"
588
743
  },
589
- "sourcemap": {
590
- "description": "Controls whether sourcemaps are generated. Default to `true`. Deactivate `--no-sourcemaps`.",
591
- "env": "SHOPIFY_HYDROGEN_FLAG_SOURCEMAP",
592
- "name": "sourcemap",
593
- "allowNo": true,
594
- "type": "boolean"
595
- },
596
744
  "disable-virtual-routes": {
597
745
  "description": "Disable rendering fallback routes when a route file doesn't exist.",
598
746
  "env": "SHOPIFY_HYDROGEN_FLAG_DISABLE_VIRTUAL_ROUTES",
@@ -611,14 +759,33 @@
611
759
  "description": "The port where the inspector is available. Defaults to 9229.",
612
760
  "env": "SHOPIFY_HYDROGEN_FLAG_INSPECTOR_PORT",
613
761
  "name": "inspector-port",
614
- "default": 9229,
762
+ "hasDynamicHelp": false,
763
+ "multiple": false,
764
+ "type": "option"
765
+ },
766
+ "host": {
767
+ "description": "Expose the server to the network",
768
+ "name": "host",
769
+ "required": false,
770
+ "allowNo": false,
771
+ "type": "boolean"
772
+ },
773
+ "env": {
774
+ "description": "Specifies the environment to perform the operation using its handle. Fetch the handle using the `env list` command.",
775
+ "exclusive": [
776
+ "env-branch"
777
+ ],
778
+ "name": "env",
615
779
  "hasDynamicHelp": false,
616
780
  "multiple": false,
617
781
  "type": "option"
618
782
  },
619
783
  "env-branch": {
620
- "char": "e",
621
- "description": "Specifies the environment to pull variables from using its Git branch name.",
784
+ "deprecated": {
785
+ "to": "env",
786
+ "message": "--env-branch is deprecated. Use --env instead."
787
+ },
788
+ "description": "Specifies the environment to perform the operation using its Git branch name.",
622
789
  "env": "SHOPIFY_HYDROGEN_ENVIRONMENT_BRANCH",
623
790
  "name": "env-branch",
624
791
  "hasDynamicHelp": false,
@@ -639,11 +806,29 @@
639
806
  "required": false,
640
807
  "allowNo": false,
641
808
  "type": "boolean"
809
+ },
810
+ "customer-account-push__unstable": {
811
+ "description": "Use tunneling for local development and push the tunneling domain to admin. Required to use Customer Account API's Oauth flow",
812
+ "env": "SHOPIFY_HYDROGEN_FLAG_CUSTOMER_ACCOUNT_PUSH",
813
+ "hidden": true,
814
+ "name": "customer-account-push__unstable",
815
+ "required": false,
816
+ "allowNo": false,
817
+ "type": "boolean"
818
+ },
819
+ "verbose": {
820
+ "description": "Outputs more information about the command's execution.",
821
+ "env": "SHOPIFY_HYDROGEN_FLAG_VERBOSE",
822
+ "name": "verbose",
823
+ "required": false,
824
+ "allowNo": false,
825
+ "type": "boolean"
642
826
  }
643
827
  },
644
828
  "hasDynamicHelp": false,
829
+ "hidden": true,
645
830
  "hiddenAliases": [],
646
- "id": "hydrogen:dev",
831
+ "id": "hydrogen:dev-vite",
647
832
  "pluginAlias": "@shopify/cli-hydrogen",
648
833
  "pluginName": "@shopify/cli-hydrogen",
649
834
  "pluginType": "core",
@@ -653,160 +838,127 @@
653
838
  "dist",
654
839
  "commands",
655
840
  "hydrogen",
656
- "dev.js"
841
+ "dev-vite.js"
657
842
  ]
658
843
  },
659
- "hydrogen:g": {
844
+ "hydrogen:env:list": {
660
845
  "aliases": [],
661
846
  "args": {},
662
- "description": "Shortcut for `hydrogen generate`. See `hydrogen generate --help` for more information.",
663
- "flags": {},
664
- "hasDynamicHelp": false,
665
- "hidden": true,
847
+ "description": "List the environments on your linked Hydrogen storefront.",
848
+ "flags": {
849
+ "path": {
850
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
851
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
852
+ "name": "path",
853
+ "hasDynamicHelp": false,
854
+ "multiple": false,
855
+ "type": "option"
856
+ }
857
+ },
858
+ "hasDynamicHelp": false,
666
859
  "hiddenAliases": [],
667
- "id": "hydrogen:g",
860
+ "id": "hydrogen:env:list",
668
861
  "pluginAlias": "@shopify/cli-hydrogen",
669
862
  "pluginName": "@shopify/cli-hydrogen",
670
863
  "pluginType": "core",
671
- "strict": false,
864
+ "strict": true,
865
+ "descriptionWithMarkdown": "Lists all environments available on the linked Hydrogen storefront.",
672
866
  "isESM": true,
673
867
  "relativePath": [
674
868
  "dist",
675
869
  "commands",
676
870
  "hydrogen",
677
- "g.js"
871
+ "env",
872
+ "list.js"
678
873
  ]
679
874
  },
680
- "hydrogen:init": {
875
+ "hydrogen:env:pull": {
681
876
  "aliases": [],
682
877
  "args": {},
683
- "description": "Creates a new Hydrogen storefront.",
878
+ "description": "Populate your .env with variables from your Hydrogen storefront.",
684
879
  "flags": {
685
- "force": {
686
- "char": "f",
687
- "description": "Overwrites the destination directory and files if they already exist.",
688
- "env": "SHOPIFY_HYDROGEN_FLAG_FORCE",
689
- "name": "force",
690
- "allowNo": false,
691
- "type": "boolean"
692
- },
693
- "path": {
694
- "description": "The path to the directory of the new Hydrogen storefront.",
695
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
696
- "name": "path",
880
+ "env": {
881
+ "description": "Specifies the environment to perform the operation using its handle. Fetch the handle using the `env list` command.",
882
+ "exclusive": [
883
+ "env-branch"
884
+ ],
885
+ "name": "env",
697
886
  "hasDynamicHelp": false,
698
887
  "multiple": false,
699
888
  "type": "option"
700
889
  },
701
- "language": {
702
- "description": "Sets the template language to use. One of `js` or `ts`.",
703
- "env": "SHOPIFY_HYDROGEN_FLAG_LANGUAGE",
704
- "name": "language",
890
+ "env-branch": {
891
+ "deprecated": {
892
+ "to": "env",
893
+ "message": "--env-branch is deprecated. Use --env instead."
894
+ },
895
+ "description": "Specifies the environment to perform the operation using its Git branch name.",
896
+ "env": "SHOPIFY_HYDROGEN_ENVIRONMENT_BRANCH",
897
+ "name": "env-branch",
705
898
  "hasDynamicHelp": false,
706
899
  "multiple": false,
707
900
  "type": "option"
708
901
  },
709
- "template": {
710
- "description": "Scaffolds project based on an existing template or example from the Hydrogen repository.",
711
- "env": "SHOPIFY_HYDROGEN_FLAG_TEMPLATE",
712
- "name": "template",
902
+ "path": {
903
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
904
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
905
+ "name": "path",
713
906
  "hasDynamicHelp": false,
714
907
  "multiple": false,
715
908
  "type": "option"
716
909
  },
717
- "install-deps": {
718
- "description": "Auto installs dependencies using the active package manager.",
719
- "env": "SHOPIFY_HYDROGEN_FLAG_INSTALL_DEPS",
720
- "name": "install-deps",
721
- "allowNo": true,
722
- "type": "boolean"
723
- },
724
- "mock-shop": {
725
- "description": "Use mock.shop as the data source for the storefront.",
726
- "env": "SHOPIFY_HYDROGEN_FLAG_MOCK_DATA",
727
- "name": "mock-shop",
910
+ "force": {
911
+ "char": "f",
912
+ "description": "Overwrites the destination directory and files if they already exist.",
913
+ "env": "SHOPIFY_HYDROGEN_FLAG_FORCE",
914
+ "name": "force",
728
915
  "allowNo": false,
729
916
  "type": "boolean"
730
- },
731
- "styling": {
732
- "description": "Sets the styling strategy to use. One of `tailwind`, `css-modules`, `vanilla-extract`, `postcss`, `none`.",
733
- "env": "SHOPIFY_HYDROGEN_FLAG_STYLING",
734
- "name": "styling",
735
- "hasDynamicHelp": false,
736
- "multiple": false,
737
- "type": "option"
738
- },
739
- "markets": {
740
- "description": "Sets the URL structure to support multiple markets. Must be one of: `subfolders`, `domains`, `subdomains`, `none`. Example: `--markets subfolders`.",
741
- "env": "SHOPIFY_HYDROGEN_FLAG_I18N",
742
- "name": "markets",
743
- "hasDynamicHelp": false,
744
- "multiple": false,
745
- "type": "option"
746
- },
747
- "shortcut": {
748
- "description": "Creates a global h2 shortcut for Shopify CLI using shell aliases. Deactivate with `--no-shortcut`.",
749
- "env": "SHOPIFY_HYDROGEN_FLAG_SHORTCUT",
750
- "name": "shortcut",
751
- "allowNo": true,
752
- "type": "boolean"
753
- },
754
- "routes": {
755
- "description": "Generate routes for all pages.",
756
- "env": "SHOPIFY_HYDROGEN_FLAG_ROUTES",
757
- "hidden": true,
758
- "name": "routes",
759
- "allowNo": true,
760
- "type": "boolean"
761
- },
762
- "git": {
763
- "description": "Init Git and create initial commits.",
764
- "env": "SHOPIFY_HYDROGEN_FLAG_GIT",
765
- "name": "git",
766
- "allowNo": true,
767
- "type": "boolean"
768
917
  }
769
918
  },
770
919
  "hasDynamicHelp": false,
771
920
  "hiddenAliases": [],
772
- "id": "hydrogen:init",
921
+ "id": "hydrogen:env:pull",
773
922
  "pluginAlias": "@shopify/cli-hydrogen",
774
923
  "pluginName": "@shopify/cli-hydrogen",
775
924
  "pluginType": "core",
776
925
  "strict": true,
926
+ "descriptionWithMarkdown": "Pulls environment variables from the linked Hydrogen storefront and writes them to an `.env` file.",
777
927
  "isESM": true,
778
928
  "relativePath": [
779
929
  "dist",
780
930
  "commands",
781
931
  "hydrogen",
782
- "init.js"
932
+ "env",
933
+ "pull.js"
783
934
  ]
784
935
  },
785
- "hydrogen:link": {
936
+ "hydrogen:env:push": {
786
937
  "aliases": [],
787
938
  "args": {},
788
- "description": "Link a local project to one of your shop's Hydrogen storefronts.",
939
+ "description": "Push environment variables from the local .env file to your linked Hydrogen storefront.",
789
940
  "flags": {
790
- "force": {
791
- "char": "f",
792
- "description": "Overwrites the destination directory and files if they already exist.",
793
- "env": "SHOPIFY_HYDROGEN_FLAG_FORCE",
794
- "name": "force",
795
- "allowNo": false,
796
- "type": "boolean"
941
+ "env": {
942
+ "description": "Specifies the environment to perform the operation using its handle. Fetch the handle using the `env list` command.",
943
+ "exclusive": [
944
+ "env-branch"
945
+ ],
946
+ "name": "env",
947
+ "hasDynamicHelp": false,
948
+ "multiple": false,
949
+ "type": "option"
797
950
  },
798
- "path": {
799
- "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
800
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
801
- "name": "path",
951
+ "env-file": {
952
+ "description": "Path to an environment file to override existing environment variables for the selected environment. Defaults to the '.env' located in your project path `--path`.",
953
+ "name": "env-file",
802
954
  "hasDynamicHelp": false,
803
955
  "multiple": false,
804
956
  "type": "option"
805
957
  },
806
- "storefront": {
807
- "description": "The name of a Hydrogen Storefront (e.g. \"Jane's Apparel\")",
808
- "env": "SHOPIFY_HYDROGEN_STOREFRONT",
809
- "name": "storefront",
958
+ "path": {
959
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
960
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
961
+ "name": "path",
810
962
  "hasDynamicHelp": false,
811
963
  "multiple": false,
812
964
  "type": "option"
@@ -814,7 +966,7 @@
814
966
  },
815
967
  "hasDynamicHelp": false,
816
968
  "hiddenAliases": [],
817
- "id": "hydrogen:link",
969
+ "id": "hydrogen:env:push",
818
970
  "pluginAlias": "@shopify/cli-hydrogen",
819
971
  "pluginName": "@shopify/cli-hydrogen",
820
972
  "pluginType": "core",
@@ -824,81 +976,87 @@
824
976
  "dist",
825
977
  "commands",
826
978
  "hydrogen",
827
- "link.js"
979
+ "env",
980
+ "push.js"
828
981
  ]
829
982
  },
830
- "hydrogen:list": {
983
+ "hydrogen:g": {
831
984
  "aliases": [],
832
985
  "args": {},
833
- "description": "Returns a list of Hydrogen storefronts available on a given shop.",
834
- "flags": {
835
- "path": {
836
- "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
837
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
838
- "name": "path",
839
- "hasDynamicHelp": false,
840
- "multiple": false,
841
- "type": "option"
842
- }
843
- },
986
+ "description": "Shortcut for `hydrogen generate`. See `hydrogen generate --help` for more information.",
987
+ "flags": {},
844
988
  "hasDynamicHelp": false,
989
+ "hidden": true,
845
990
  "hiddenAliases": [],
846
- "id": "hydrogen:list",
991
+ "id": "hydrogen:g",
847
992
  "pluginAlias": "@shopify/cli-hydrogen",
848
993
  "pluginName": "@shopify/cli-hydrogen",
849
994
  "pluginType": "core",
850
- "strict": true,
995
+ "strict": false,
851
996
  "isESM": true,
852
997
  "relativePath": [
853
998
  "dist",
854
999
  "commands",
855
1000
  "hydrogen",
856
- "list.js"
1001
+ "g.js"
857
1002
  ]
858
1003
  },
859
- "hydrogen:login": {
1004
+ "hydrogen:generate:route": {
860
1005
  "aliases": [],
861
- "args": {},
862
- "description": "Login to your Shopify account.",
1006
+ "args": {
1007
+ "routeName": {
1008
+ "description": "The route to generate. One of home,page,cart,products,collections,policies,blogs,account,search,robots,sitemap,all.",
1009
+ "name": "routeName",
1010
+ "options": [
1011
+ "home",
1012
+ "page",
1013
+ "cart",
1014
+ "products",
1015
+ "collections",
1016
+ "policies",
1017
+ "blogs",
1018
+ "account",
1019
+ "search",
1020
+ "robots",
1021
+ "sitemap",
1022
+ "all"
1023
+ ],
1024
+ "required": true
1025
+ }
1026
+ },
1027
+ "description": "Generates a standard Shopify route.",
863
1028
  "flags": {
864
- "path": {
865
- "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
866
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
867
- "name": "path",
1029
+ "adapter": {
1030
+ "description": "Remix adapter used in the route. The default is `@shopify/remix-oxygen`.",
1031
+ "env": "SHOPIFY_HYDROGEN_FLAG_ADAPTER",
1032
+ "name": "adapter",
868
1033
  "hasDynamicHelp": false,
869
1034
  "multiple": false,
870
1035
  "type": "option"
871
1036
  },
872
- "shop": {
873
- "char": "s",
874
- "description": "Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).",
875
- "env": "SHOPIFY_SHOP",
876
- "name": "shop",
1037
+ "typescript": {
1038
+ "description": "Generate TypeScript files",
1039
+ "env": "SHOPIFY_HYDROGEN_FLAG_TYPESCRIPT",
1040
+ "name": "typescript",
1041
+ "allowNo": false,
1042
+ "type": "boolean"
1043
+ },
1044
+ "locale-param": {
1045
+ "description": "The param name in Remix routes for the i18n locale, if any. Example: `locale` becomes ($locale).",
1046
+ "env": "SHOPIFY_HYDROGEN_FLAG_ADAPTER",
1047
+ "name": "locale-param",
877
1048
  "hasDynamicHelp": false,
878
1049
  "multiple": false,
879
1050
  "type": "option"
880
- }
881
- },
882
- "hasDynamicHelp": false,
883
- "hiddenAliases": [],
884
- "id": "hydrogen:login",
885
- "pluginAlias": "@shopify/cli-hydrogen",
886
- "pluginName": "@shopify/cli-hydrogen",
887
- "pluginType": "core",
888
- "strict": true,
889
- "isESM": true,
890
- "relativePath": [
891
- "dist",
892
- "commands",
893
- "hydrogen",
894
- "login.js"
895
- ]
896
- },
897
- "hydrogen:logout": {
898
- "aliases": [],
899
- "args": {},
900
- "description": "Logout of your local session.",
901
- "flags": {
1051
+ },
1052
+ "force": {
1053
+ "char": "f",
1054
+ "description": "Overwrites the destination directory and files if they already exist.",
1055
+ "env": "SHOPIFY_HYDROGEN_FLAG_FORCE",
1056
+ "name": "force",
1057
+ "allowNo": false,
1058
+ "type": "boolean"
1059
+ },
902
1060
  "path": {
903
1061
  "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
904
1062
  "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
@@ -910,82 +1068,69 @@
910
1068
  },
911
1069
  "hasDynamicHelp": false,
912
1070
  "hiddenAliases": [],
913
- "id": "hydrogen:logout",
1071
+ "id": "hydrogen:generate:route",
914
1072
  "pluginAlias": "@shopify/cli-hydrogen",
915
1073
  "pluginName": "@shopify/cli-hydrogen",
916
1074
  "pluginType": "core",
917
1075
  "strict": true,
1076
+ "descriptionWithMarkdown": "Generates a set of default routes from the starter template.",
918
1077
  "isESM": true,
919
1078
  "relativePath": [
920
1079
  "dist",
921
1080
  "commands",
922
1081
  "hydrogen",
923
- "logout.js"
1082
+ "generate",
1083
+ "route.js"
924
1084
  ]
925
1085
  },
926
- "hydrogen:preview": {
1086
+ "hydrogen:generate:routes": {
927
1087
  "aliases": [],
928
1088
  "args": {},
929
- "description": "Runs a Hydrogen storefront in an Oxygen worker for production.",
1089
+ "description": "Generates all supported standard shopify routes.",
930
1090
  "flags": {
931
- "path": {
932
- "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
933
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
934
- "name": "path",
935
- "hasDynamicHelp": false,
936
- "multiple": false,
937
- "type": "option"
938
- },
939
- "port": {
940
- "description": "The port to run the server on. Defaults to 3000.",
941
- "env": "SHOPIFY_HYDROGEN_FLAG_PORT",
942
- "name": "port",
943
- "default": 3000,
1091
+ "adapter": {
1092
+ "description": "Remix adapter used in the route. The default is `@shopify/remix-oxygen`.",
1093
+ "env": "SHOPIFY_HYDROGEN_FLAG_ADAPTER",
1094
+ "name": "adapter",
944
1095
  "hasDynamicHelp": false,
945
1096
  "multiple": false,
946
1097
  "type": "option"
947
1098
  },
948
- "worker": {
949
- "hidden": true,
950
- "name": "worker",
951
- "type": "boolean"
952
- },
953
- "legacy-runtime": {
954
- "description": "Runs the app in a Node.js sandbox instead of an Oxygen worker.",
955
- "env": "SHOPIFY_HYDROGEN_FLAG_WORKER",
956
- "name": "legacy-runtime",
1099
+ "typescript": {
1100
+ "description": "Generate TypeScript files",
1101
+ "env": "SHOPIFY_HYDROGEN_FLAG_TYPESCRIPT",
1102
+ "name": "typescript",
957
1103
  "allowNo": false,
958
1104
  "type": "boolean"
959
1105
  },
960
- "env-branch": {
961
- "char": "e",
962
- "description": "Specifies the environment to pull variables from using its Git branch name.",
963
- "env": "SHOPIFY_HYDROGEN_ENVIRONMENT_BRANCH",
964
- "name": "env-branch",
965
- "hasDynamicHelp": false,
966
- "multiple": false,
967
- "type": "option"
968
- },
969
- "inspector-port": {
970
- "description": "The port where the inspector is available. Defaults to 9229.",
971
- "env": "SHOPIFY_HYDROGEN_FLAG_INSPECTOR_PORT",
972
- "name": "inspector-port",
973
- "default": 9229,
1106
+ "locale-param": {
1107
+ "description": "The param name in Remix routes for the i18n locale, if any. Example: `locale` becomes ($locale).",
1108
+ "env": "SHOPIFY_HYDROGEN_FLAG_ADAPTER",
1109
+ "name": "locale-param",
974
1110
  "hasDynamicHelp": false,
975
1111
  "multiple": false,
976
1112
  "type": "option"
977
1113
  },
978
- "debug": {
979
- "description": "Enables inspector connections to the server with a debugger such as Visual Studio Code or Chrome DevTools.",
980
- "env": "SHOPIFY_HYDROGEN_FLAG_DEBUG",
981
- "name": "debug",
1114
+ "force": {
1115
+ "char": "f",
1116
+ "description": "Overwrites the destination directory and files if they already exist.",
1117
+ "env": "SHOPIFY_HYDROGEN_FLAG_FORCE",
1118
+ "name": "force",
982
1119
  "allowNo": false,
983
1120
  "type": "boolean"
1121
+ },
1122
+ "path": {
1123
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1124
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1125
+ "name": "path",
1126
+ "hasDynamicHelp": false,
1127
+ "multiple": false,
1128
+ "type": "option"
984
1129
  }
985
1130
  },
986
1131
  "hasDynamicHelp": false,
987
1132
  "hiddenAliases": [],
988
- "id": "hydrogen:preview",
1133
+ "id": "hydrogen:generate:routes",
989
1134
  "pluginAlias": "@shopify/cli-hydrogen",
990
1135
  "pluginName": "@shopify/cli-hydrogen",
991
1136
  "pluginType": "core",
@@ -995,22 +1140,15 @@
995
1140
  "dist",
996
1141
  "commands",
997
1142
  "hydrogen",
998
- "preview.js"
1143
+ "generate",
1144
+ "routes.js"
999
1145
  ]
1000
1146
  },
1001
- "hydrogen:setup": {
1147
+ "hydrogen:init": {
1002
1148
  "aliases": [],
1003
1149
  "args": {},
1004
- "description": "Scaffold routes and core functionality.",
1150
+ "description": "Creates a new Hydrogen storefront.",
1005
1151
  "flags": {
1006
- "path": {
1007
- "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1008
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1009
- "name": "path",
1010
- "hasDynamicHelp": false,
1011
- "multiple": false,
1012
- "type": "option"
1013
- },
1014
1152
  "force": {
1015
1153
  "char": "f",
1016
1154
  "description": "Overwrites the destination directory and files if they already exist.",
@@ -1019,14 +1157,44 @@
1019
1157
  "allowNo": false,
1020
1158
  "type": "boolean"
1021
1159
  },
1022
- "styling": {
1023
- "description": "Sets the styling strategy to use. One of `tailwind`, `css-modules`, `vanilla-extract`, `postcss`, `none`.",
1024
- "env": "SHOPIFY_HYDROGEN_FLAG_STYLING",
1025
- "name": "styling",
1160
+ "path": {
1161
+ "description": "The path to the directory of the new Hydrogen storefront.",
1162
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1163
+ "name": "path",
1164
+ "hasDynamicHelp": false,
1165
+ "multiple": false,
1166
+ "type": "option"
1167
+ },
1168
+ "language": {
1169
+ "description": "Sets the template language to use. One of `js` or `ts`.",
1170
+ "env": "SHOPIFY_HYDROGEN_FLAG_LANGUAGE",
1171
+ "name": "language",
1172
+ "hasDynamicHelp": false,
1173
+ "multiple": false,
1174
+ "type": "option"
1175
+ },
1176
+ "template": {
1177
+ "description": "Scaffolds project based on an existing template or example from the Hydrogen repository.",
1178
+ "env": "SHOPIFY_HYDROGEN_FLAG_TEMPLATE",
1179
+ "name": "template",
1026
1180
  "hasDynamicHelp": false,
1027
1181
  "multiple": false,
1028
1182
  "type": "option"
1029
1183
  },
1184
+ "install-deps": {
1185
+ "description": "Auto installs dependencies using the active package manager.",
1186
+ "env": "SHOPIFY_HYDROGEN_FLAG_INSTALL_DEPS",
1187
+ "name": "install-deps",
1188
+ "allowNo": true,
1189
+ "type": "boolean"
1190
+ },
1191
+ "mock-shop": {
1192
+ "description": "Use mock.shop as the data source for the storefront.",
1193
+ "env": "SHOPIFY_HYDROGEN_FLAG_MOCK_DATA",
1194
+ "name": "mock-shop",
1195
+ "allowNo": false,
1196
+ "type": "boolean"
1197
+ },
1030
1198
  "markets": {
1031
1199
  "description": "Sets the URL structure to support multiple markets. Must be one of: `subfolders`, `domains`, `subdomains`, `none`. Example: `--markets subfolders`.",
1032
1200
  "env": "SHOPIFY_HYDROGEN_FLAG_I18N",
@@ -1042,129 +1210,71 @@
1042
1210
  "allowNo": true,
1043
1211
  "type": "boolean"
1044
1212
  },
1045
- "install-deps": {
1046
- "description": "Auto installs dependencies using the active package manager.",
1047
- "env": "SHOPIFY_HYDROGEN_FLAG_INSTALL_DEPS",
1048
- "name": "install-deps",
1213
+ "routes": {
1214
+ "description": "Generate routes for all pages.",
1215
+ "env": "SHOPIFY_HYDROGEN_FLAG_ROUTES",
1216
+ "name": "routes",
1049
1217
  "allowNo": true,
1050
1218
  "type": "boolean"
1051
- }
1052
- },
1053
- "hasDynamicHelp": false,
1054
- "hiddenAliases": [],
1055
- "id": "hydrogen:setup",
1056
- "pluginAlias": "@shopify/cli-hydrogen",
1057
- "pluginName": "@shopify/cli-hydrogen",
1058
- "pluginType": "core",
1059
- "strict": true,
1060
- "isESM": true,
1061
- "relativePath": [
1062
- "dist",
1063
- "commands",
1064
- "hydrogen",
1065
- "setup.js"
1066
- ]
1067
- },
1068
- "hydrogen:shortcut": {
1069
- "aliases": [],
1070
- "args": {},
1071
- "description": "Creates a global `h2` shortcut for the Hydrogen CLI",
1072
- "flags": {},
1073
- "hasDynamicHelp": false,
1074
- "hiddenAliases": [],
1075
- "id": "hydrogen:shortcut",
1076
- "pluginAlias": "@shopify/cli-hydrogen",
1077
- "pluginName": "@shopify/cli-hydrogen",
1078
- "pluginType": "core",
1079
- "strict": true,
1080
- "isESM": true,
1081
- "relativePath": [
1082
- "dist",
1083
- "commands",
1084
- "hydrogen",
1085
- "shortcut.js"
1086
- ]
1087
- },
1088
- "hydrogen:unlink": {
1089
- "aliases": [],
1090
- "args": {},
1091
- "description": "Unlink a local project from a Hydrogen storefront.",
1092
- "flags": {
1093
- "path": {
1094
- "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1095
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1096
- "name": "path",
1219
+ },
1220
+ "git": {
1221
+ "description": "Init Git and create initial commits.",
1222
+ "env": "SHOPIFY_HYDROGEN_FLAG_GIT",
1223
+ "name": "git",
1224
+ "allowNo": true,
1225
+ "type": "boolean"
1226
+ },
1227
+ "quickstart": {
1228
+ "description": "Scaffolds a new Hydrogen project with a set of sensible defaults. Equivalent to `shopify hydrogen init --path hydrogen-quickstart --mock-shop --language js --shortcut --routes --markets none`",
1229
+ "env": "SHOPIFY_HYDROGEN_FLAG_QUICKSTART",
1230
+ "name": "quickstart",
1231
+ "allowNo": false,
1232
+ "type": "boolean"
1233
+ },
1234
+ "package-manager": {
1235
+ "env": "SHOPIFY_HYDROGEN_FLAG_PACKAGE_MANAGER",
1236
+ "hidden": true,
1237
+ "name": "package-manager",
1097
1238
  "hasDynamicHelp": false,
1098
1239
  "multiple": false,
1240
+ "options": [
1241
+ "npm",
1242
+ "yarn",
1243
+ "pnpm",
1244
+ "unknown"
1245
+ ],
1099
1246
  "type": "option"
1100
1247
  }
1101
1248
  },
1102
1249
  "hasDynamicHelp": false,
1103
1250
  "hiddenAliases": [],
1104
- "id": "hydrogen:unlink",
1251
+ "id": "hydrogen:init",
1105
1252
  "pluginAlias": "@shopify/cli-hydrogen",
1106
1253
  "pluginName": "@shopify/cli-hydrogen",
1107
1254
  "pluginType": "core",
1108
1255
  "strict": true,
1256
+ "descriptionWithMarkdown": "Creates a new Hydrogen storefront.",
1109
1257
  "isESM": true,
1110
1258
  "relativePath": [
1111
1259
  "dist",
1112
1260
  "commands",
1113
1261
  "hydrogen",
1114
- "unlink.js"
1262
+ "init.js"
1115
1263
  ]
1116
1264
  },
1117
- "hydrogen:upgrade": {
1265
+ "hydrogen:link": {
1118
1266
  "aliases": [],
1119
1267
  "args": {},
1120
- "description": "Upgrade Remix and Hydrogen npm dependencies.",
1268
+ "description": "Link a local project to one of your shop's Hydrogen storefronts.",
1121
1269
  "flags": {
1122
- "path": {
1123
- "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1124
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1125
- "name": "path",
1126
- "hasDynamicHelp": false,
1127
- "multiple": false,
1128
- "type": "option"
1129
- },
1130
- "version": {
1131
- "char": "v",
1132
- "description": "A target hydrogen version to update to",
1133
- "name": "version",
1134
- "required": false,
1135
- "hasDynamicHelp": false,
1136
- "multiple": false,
1137
- "type": "option"
1138
- },
1139
1270
  "force": {
1140
1271
  "char": "f",
1141
- "description": "Ignore warnings and force the upgrade to the target version",
1272
+ "description": "Overwrites the destination directory and files if they already exist.",
1142
1273
  "env": "SHOPIFY_HYDROGEN_FLAG_FORCE",
1143
1274
  "name": "force",
1144
1275
  "allowNo": false,
1145
1276
  "type": "boolean"
1146
- }
1147
- },
1148
- "hasDynamicHelp": false,
1149
- "hiddenAliases": [],
1150
- "id": "hydrogen:upgrade",
1151
- "pluginAlias": "@shopify/cli-hydrogen",
1152
- "pluginName": "@shopify/cli-hydrogen",
1153
- "pluginType": "core",
1154
- "strict": true,
1155
- "isESM": true,
1156
- "relativePath": [
1157
- "dist",
1158
- "commands",
1159
- "hydrogen",
1160
- "upgrade.js"
1161
- ]
1162
- },
1163
- "hydrogen:debug:cpu": {
1164
- "aliases": [],
1165
- "args": {},
1166
- "description": "Builds and profiles the server startup time the app.",
1167
- "flags": {
1277
+ },
1168
1278
  "path": {
1169
1279
  "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1170
1280
  "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
@@ -1173,11 +1283,10 @@
1173
1283
  "multiple": false,
1174
1284
  "type": "option"
1175
1285
  },
1176
- "output": {
1177
- "description": "Specify a path to generate the profile file. Defaults to \"startup.cpuprofile\".",
1178
- "name": "output",
1179
- "required": false,
1180
- "default": "startup.cpuprofile",
1286
+ "storefront": {
1287
+ "description": "The name of a Hydrogen Storefront (e.g. \"Jane's Apparel\")",
1288
+ "env": "SHOPIFY_HYDROGEN_STOREFRONT",
1289
+ "name": "storefront",
1181
1290
  "hasDynamicHelp": false,
1182
1291
  "multiple": false,
1183
1292
  "type": "option"
@@ -1185,24 +1294,24 @@
1185
1294
  },
1186
1295
  "hasDynamicHelp": false,
1187
1296
  "hiddenAliases": [],
1188
- "id": "hydrogen:debug:cpu",
1297
+ "id": "hydrogen:link",
1189
1298
  "pluginAlias": "@shopify/cli-hydrogen",
1190
1299
  "pluginName": "@shopify/cli-hydrogen",
1191
1300
  "pluginType": "core",
1192
1301
  "strict": true,
1302
+ "descriptionWithMarkdown": "Links your local development environment to a remote Hydrogen storefront. You can link an unlimited number of development environments to a single Hydrogen storefront.\n\n Linking to a Hydrogen storefront enables you to run [dev](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-dev) and automatically inject your linked Hydrogen storefront's environment variables directly into the server runtime.\n\n After you run the `link` command, you can access the [env list](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-env-list), [env pull](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-env-pull), and [unlink](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-unlink) commands.",
1193
1303
  "isESM": true,
1194
1304
  "relativePath": [
1195
1305
  "dist",
1196
1306
  "commands",
1197
1307
  "hydrogen",
1198
- "debug",
1199
- "cpu.js"
1308
+ "link.js"
1200
1309
  ]
1201
1310
  },
1202
- "hydrogen:env:list": {
1311
+ "hydrogen:list": {
1203
1312
  "aliases": [],
1204
1313
  "args": {},
1205
- "description": "List the environments on your linked Hydrogen storefront.",
1314
+ "description": "Returns a list of Hydrogen storefronts available on a given shop.",
1206
1315
  "flags": {
1207
1316
  "path": {
1208
1317
  "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
@@ -1215,34 +1324,25 @@
1215
1324
  },
1216
1325
  "hasDynamicHelp": false,
1217
1326
  "hiddenAliases": [],
1218
- "id": "hydrogen:env:list",
1327
+ "id": "hydrogen:list",
1219
1328
  "pluginAlias": "@shopify/cli-hydrogen",
1220
1329
  "pluginName": "@shopify/cli-hydrogen",
1221
1330
  "pluginType": "core",
1222
1331
  "strict": true,
1332
+ "descriptionWithMarkdown": "Lists all remote Hydrogen storefronts available to link to your local development environment.",
1223
1333
  "isESM": true,
1224
1334
  "relativePath": [
1225
1335
  "dist",
1226
1336
  "commands",
1227
1337
  "hydrogen",
1228
- "env",
1229
1338
  "list.js"
1230
1339
  ]
1231
1340
  },
1232
- "hydrogen:env:pull": {
1341
+ "hydrogen:login": {
1233
1342
  "aliases": [],
1234
1343
  "args": {},
1235
- "description": "Populate your .env with variables from your Hydrogen storefront.",
1344
+ "description": "Login to your Shopify account.",
1236
1345
  "flags": {
1237
- "env-branch": {
1238
- "char": "e",
1239
- "description": "Specifies the environment to pull variables from using its Git branch name.",
1240
- "env": "SHOPIFY_HYDROGEN_ENVIRONMENT_BRANCH",
1241
- "name": "env-branch",
1242
- "hasDynamicHelp": false,
1243
- "multiple": false,
1244
- "type": "option"
1245
- },
1246
1346
  "path": {
1247
1347
  "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1248
1348
  "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
@@ -1251,52 +1351,37 @@
1251
1351
  "multiple": false,
1252
1352
  "type": "option"
1253
1353
  },
1254
- "force": {
1255
- "char": "f",
1256
- "description": "Overwrites the destination directory and files if they already exist.",
1257
- "env": "SHOPIFY_HYDROGEN_FLAG_FORCE",
1258
- "name": "force",
1259
- "allowNo": false,
1260
- "type": "boolean"
1354
+ "shop": {
1355
+ "char": "s",
1356
+ "description": "Shop URL. It can be the shop prefix (janes-apparel) or the full myshopify.com URL (janes-apparel.myshopify.com, https://janes-apparel.myshopify.com).",
1357
+ "env": "SHOPIFY_SHOP",
1358
+ "name": "shop",
1359
+ "hasDynamicHelp": false,
1360
+ "multiple": false,
1361
+ "type": "option"
1261
1362
  }
1262
1363
  },
1263
1364
  "hasDynamicHelp": false,
1264
1365
  "hiddenAliases": [],
1265
- "id": "hydrogen:env:pull",
1366
+ "id": "hydrogen:login",
1266
1367
  "pluginAlias": "@shopify/cli-hydrogen",
1267
1368
  "pluginName": "@shopify/cli-hydrogen",
1268
1369
  "pluginType": "core",
1269
1370
  "strict": true,
1371
+ "descriptionWithMarkdown": "Logs in to the specified shop and saves the shop domain to the project.",
1270
1372
  "isESM": true,
1271
1373
  "relativePath": [
1272
1374
  "dist",
1273
1375
  "commands",
1274
1376
  "hydrogen",
1275
- "env",
1276
- "pull.js"
1377
+ "login.js"
1277
1378
  ]
1278
1379
  },
1279
- "hydrogen:env:push__unstable": {
1280
- "aliases": [],
1281
- "args": {},
1282
- "description": "Push environment variables from the local .env file to your linked Hydrogen storefront.",
1283
- "flags": {
1284
- "env": {
1285
- "description": "Specifies an environment's name when using remote environment variables.",
1286
- "env": "SHOPIFY_HYDROGEN_ENVIRONMENT_NAME",
1287
- "name": "env",
1288
- "hasDynamicHelp": false,
1289
- "multiple": false,
1290
- "type": "option"
1291
- },
1292
- "env-file": {
1293
- "description": "Specify the environment variable file name. Default value is '.env'.",
1294
- "env": "SHOPIFY_HYDROGEN_ENVIRONMENT_FILENAME",
1295
- "name": "env-file",
1296
- "hasDynamicHelp": false,
1297
- "multiple": false,
1298
- "type": "option"
1299
- },
1380
+ "hydrogen:logout": {
1381
+ "aliases": [],
1382
+ "args": {},
1383
+ "description": "Logout of your local session.",
1384
+ "flags": {
1300
1385
  "path": {
1301
1386
  "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1302
1387
  "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
@@ -1307,127 +1392,125 @@
1307
1392
  }
1308
1393
  },
1309
1394
  "hasDynamicHelp": false,
1310
- "hidden": true,
1311
1395
  "hiddenAliases": [],
1312
- "id": "hydrogen:env:push__unstable",
1396
+ "id": "hydrogen:logout",
1313
1397
  "pluginAlias": "@shopify/cli-hydrogen",
1314
1398
  "pluginName": "@shopify/cli-hydrogen",
1315
1399
  "pluginType": "core",
1316
1400
  "strict": true,
1401
+ "descriptionWithMarkdown": "Log out from the current shop.",
1317
1402
  "isESM": true,
1318
1403
  "relativePath": [
1319
1404
  "dist",
1320
1405
  "commands",
1321
1406
  "hydrogen",
1322
- "env",
1323
- "push__unstable.js"
1407
+ "logout.js"
1324
1408
  ]
1325
1409
  },
1326
- "hydrogen:generate:route": {
1410
+ "hydrogen:preview": {
1327
1411
  "aliases": [],
1328
- "args": {
1329
- "routeName": {
1330
- "description": "The route to generate. One of home,page,cart,products,collections,policies,blogs,account,search,robots,sitemap,all.",
1331
- "name": "routeName",
1332
- "options": [
1333
- "home",
1334
- "page",
1335
- "cart",
1336
- "products",
1337
- "collections",
1338
- "policies",
1339
- "blogs",
1340
- "account",
1341
- "search",
1342
- "robots",
1343
- "sitemap",
1344
- "all"
1345
- ],
1346
- "required": true
1347
- }
1348
- },
1349
- "description": "Generates a standard Shopify route.",
1412
+ "args": {},
1413
+ "description": "Runs a Hydrogen storefront in an Oxygen worker for production.",
1350
1414
  "flags": {
1351
- "adapter": {
1352
- "description": "Remix adapter used in the route. The default is `@shopify/remix-oxygen`.",
1353
- "env": "SHOPIFY_HYDROGEN_FLAG_ADAPTER",
1354
- "name": "adapter",
1415
+ "path": {
1416
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1417
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1418
+ "name": "path",
1355
1419
  "hasDynamicHelp": false,
1356
1420
  "multiple": false,
1357
1421
  "type": "option"
1358
1422
  },
1359
- "typescript": {
1360
- "description": "Generate TypeScript files",
1361
- "env": "SHOPIFY_HYDROGEN_FLAG_TYPESCRIPT",
1362
- "name": "typescript",
1423
+ "port": {
1424
+ "description": "The port to run the server on. Defaults to 3000.",
1425
+ "env": "SHOPIFY_HYDROGEN_FLAG_PORT",
1426
+ "name": "port",
1427
+ "hasDynamicHelp": false,
1428
+ "multiple": false,
1429
+ "type": "option"
1430
+ },
1431
+ "worker": {
1432
+ "hidden": true,
1433
+ "name": "worker",
1434
+ "type": "boolean"
1435
+ },
1436
+ "legacy-runtime": {
1437
+ "description": "Runs the app in a Node.js sandbox instead of an Oxygen worker.",
1438
+ "env": "SHOPIFY_HYDROGEN_FLAG_WORKER",
1439
+ "name": "legacy-runtime",
1363
1440
  "allowNo": false,
1364
1441
  "type": "boolean"
1365
1442
  },
1366
- "locale-param": {
1367
- "description": "The param name in Remix routes for the i18n locale, if any. Example: `locale` becomes ($locale).",
1368
- "env": "SHOPIFY_HYDROGEN_FLAG_ADAPTER",
1369
- "name": "locale-param",
1443
+ "env": {
1444
+ "description": "Specifies the environment to perform the operation using its handle. Fetch the handle using the `env list` command.",
1445
+ "exclusive": [
1446
+ "env-branch"
1447
+ ],
1448
+ "name": "env",
1370
1449
  "hasDynamicHelp": false,
1371
1450
  "multiple": false,
1372
1451
  "type": "option"
1373
1452
  },
1374
- "force": {
1375
- "char": "f",
1376
- "description": "Overwrites the destination directory and files if they already exist.",
1377
- "env": "SHOPIFY_HYDROGEN_FLAG_FORCE",
1378
- "name": "force",
1379
- "allowNo": false,
1380
- "type": "boolean"
1453
+ "env-branch": {
1454
+ "deprecated": {
1455
+ "to": "env",
1456
+ "message": "--env-branch is deprecated. Use --env instead."
1457
+ },
1458
+ "description": "Specifies the environment to perform the operation using its Git branch name.",
1459
+ "env": "SHOPIFY_HYDROGEN_ENVIRONMENT_BRANCH",
1460
+ "name": "env-branch",
1461
+ "hasDynamicHelp": false,
1462
+ "multiple": false,
1463
+ "type": "option"
1381
1464
  },
1382
- "path": {
1383
- "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1384
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1385
- "name": "path",
1465
+ "inspector-port": {
1466
+ "description": "The port where the inspector is available. Defaults to 9229.",
1467
+ "env": "SHOPIFY_HYDROGEN_FLAG_INSPECTOR_PORT",
1468
+ "name": "inspector-port",
1386
1469
  "hasDynamicHelp": false,
1387
1470
  "multiple": false,
1388
1471
  "type": "option"
1472
+ },
1473
+ "debug": {
1474
+ "description": "Enables inspector connections to the server with a debugger such as Visual Studio Code or Chrome DevTools.",
1475
+ "env": "SHOPIFY_HYDROGEN_FLAG_DEBUG",
1476
+ "name": "debug",
1477
+ "allowNo": false,
1478
+ "type": "boolean"
1479
+ },
1480
+ "verbose": {
1481
+ "description": "Outputs more information about the command's execution.",
1482
+ "env": "SHOPIFY_HYDROGEN_FLAG_VERBOSE",
1483
+ "name": "verbose",
1484
+ "required": false,
1485
+ "allowNo": false,
1486
+ "type": "boolean"
1389
1487
  }
1390
1488
  },
1391
1489
  "hasDynamicHelp": false,
1392
1490
  "hiddenAliases": [],
1393
- "id": "hydrogen:generate:route",
1491
+ "id": "hydrogen:preview",
1394
1492
  "pluginAlias": "@shopify/cli-hydrogen",
1395
1493
  "pluginName": "@shopify/cli-hydrogen",
1396
1494
  "pluginType": "core",
1397
1495
  "strict": true,
1496
+ "descriptionWithMarkdown": "Runs a server in your local development environment that serves your Hydrogen app's production build. Requires running the [build](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-build) command first.",
1398
1497
  "isESM": true,
1399
1498
  "relativePath": [
1400
1499
  "dist",
1401
1500
  "commands",
1402
1501
  "hydrogen",
1403
- "generate",
1404
- "route.js"
1502
+ "preview.js"
1405
1503
  ]
1406
1504
  },
1407
- "hydrogen:generate:routes": {
1505
+ "hydrogen:setup": {
1408
1506
  "aliases": [],
1409
1507
  "args": {},
1410
- "description": "Generates all supported standard shopify routes.",
1508
+ "description": "Scaffold routes and core functionality.",
1411
1509
  "flags": {
1412
- "adapter": {
1413
- "description": "Remix adapter used in the route. The default is `@shopify/remix-oxygen`.",
1414
- "env": "SHOPIFY_HYDROGEN_FLAG_ADAPTER",
1415
- "name": "adapter",
1416
- "hasDynamicHelp": false,
1417
- "multiple": false,
1418
- "type": "option"
1419
- },
1420
- "typescript": {
1421
- "description": "Generate TypeScript files",
1422
- "env": "SHOPIFY_HYDROGEN_FLAG_TYPESCRIPT",
1423
- "name": "typescript",
1424
- "allowNo": false,
1425
- "type": "boolean"
1426
- },
1427
- "locale-param": {
1428
- "description": "The param name in Remix routes for the i18n locale, if any. Example: `locale` becomes ($locale).",
1429
- "env": "SHOPIFY_HYDROGEN_FLAG_ADAPTER",
1430
- "name": "locale-param",
1510
+ "path": {
1511
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1512
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1513
+ "name": "path",
1431
1514
  "hasDynamicHelp": false,
1432
1515
  "multiple": false,
1433
1516
  "type": "option"
@@ -1440,18 +1523,32 @@
1440
1523
  "allowNo": false,
1441
1524
  "type": "boolean"
1442
1525
  },
1443
- "path": {
1444
- "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1445
- "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1446
- "name": "path",
1526
+ "markets": {
1527
+ "description": "Sets the URL structure to support multiple markets. Must be one of: `subfolders`, `domains`, `subdomains`, `none`. Example: `--markets subfolders`.",
1528
+ "env": "SHOPIFY_HYDROGEN_FLAG_I18N",
1529
+ "name": "markets",
1447
1530
  "hasDynamicHelp": false,
1448
1531
  "multiple": false,
1449
1532
  "type": "option"
1533
+ },
1534
+ "shortcut": {
1535
+ "description": "Creates a global h2 shortcut for Shopify CLI using shell aliases. Deactivate with `--no-shortcut`.",
1536
+ "env": "SHOPIFY_HYDROGEN_FLAG_SHORTCUT",
1537
+ "name": "shortcut",
1538
+ "allowNo": true,
1539
+ "type": "boolean"
1540
+ },
1541
+ "install-deps": {
1542
+ "description": "Auto installs dependencies using the active package manager.",
1543
+ "env": "SHOPIFY_HYDROGEN_FLAG_INSTALL_DEPS",
1544
+ "name": "install-deps",
1545
+ "allowNo": true,
1546
+ "type": "boolean"
1450
1547
  }
1451
1548
  },
1452
1549
  "hasDynamicHelp": false,
1453
1550
  "hiddenAliases": [],
1454
- "id": "hydrogen:generate:routes",
1551
+ "id": "hydrogen:setup",
1455
1552
  "pluginAlias": "@shopify/cli-hydrogen",
1456
1553
  "pluginName": "@shopify/cli-hydrogen",
1457
1554
  "pluginType": "core",
@@ -1461,8 +1558,7 @@
1461
1558
  "dist",
1462
1559
  "commands",
1463
1560
  "hydrogen",
1464
- "generate",
1465
- "routes.js"
1561
+ "setup.js"
1466
1562
  ]
1467
1563
  },
1468
1564
  "hydrogen:setup:css": {
@@ -1512,6 +1608,7 @@
1512
1608
  "pluginName": "@shopify/cli-hydrogen",
1513
1609
  "pluginType": "core",
1514
1610
  "strict": true,
1611
+ "descriptionWithMarkdown": "Adds support for certain CSS strategies to your project.",
1515
1612
  "isESM": true,
1516
1613
  "relativePath": [
1517
1614
  "dist",
@@ -1552,6 +1649,7 @@
1552
1649
  "pluginName": "@shopify/cli-hydrogen",
1553
1650
  "pluginType": "core",
1554
1651
  "strict": true,
1652
+ "descriptionWithMarkdown": "Adds support for multiple [markets](https://shopify.dev/docs/custom-storefronts/hydrogen/markets) to your project by using the URL structure.",
1555
1653
  "isESM": true,
1556
1654
  "relativePath": [
1557
1655
  "dist",
@@ -1590,7 +1688,105 @@
1590
1688
  "setup",
1591
1689
  "vite.js"
1592
1690
  ]
1691
+ },
1692
+ "hydrogen:shortcut": {
1693
+ "aliases": [],
1694
+ "args": {},
1695
+ "description": "Creates a global `h2` shortcut for the Hydrogen CLI",
1696
+ "flags": {},
1697
+ "hasDynamicHelp": false,
1698
+ "hiddenAliases": [],
1699
+ "id": "hydrogen:shortcut",
1700
+ "pluginAlias": "@shopify/cli-hydrogen",
1701
+ "pluginName": "@shopify/cli-hydrogen",
1702
+ "pluginType": "core",
1703
+ "strict": true,
1704
+ "descriptionWithMarkdown": "Creates a global h2 shortcut for Shopify CLI using shell aliases.\n\n The following shells are supported:\n\n - Bash (using `~/.bashrc`)\n - ZSH (using `~/.zshrc`)\n - Fish (using `~/.config/fish/functions`)\n - PowerShell (added to `$PROFILE`)\n\n After the alias is created, you can call Shopify CLI from anywhere in your project using `h2 <command>`.",
1705
+ "isESM": true,
1706
+ "relativePath": [
1707
+ "dist",
1708
+ "commands",
1709
+ "hydrogen",
1710
+ "shortcut.js"
1711
+ ]
1712
+ },
1713
+ "hydrogen:unlink": {
1714
+ "aliases": [],
1715
+ "args": {},
1716
+ "description": "Unlink a local project from a Hydrogen storefront.",
1717
+ "flags": {
1718
+ "path": {
1719
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1720
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1721
+ "name": "path",
1722
+ "hasDynamicHelp": false,
1723
+ "multiple": false,
1724
+ "type": "option"
1725
+ }
1726
+ },
1727
+ "hasDynamicHelp": false,
1728
+ "hiddenAliases": [],
1729
+ "id": "hydrogen:unlink",
1730
+ "pluginAlias": "@shopify/cli-hydrogen",
1731
+ "pluginName": "@shopify/cli-hydrogen",
1732
+ "pluginType": "core",
1733
+ "strict": true,
1734
+ "descriptionWithMarkdown": "Unlinks your local development environment from a remote Hydrogen storefront.",
1735
+ "isESM": true,
1736
+ "relativePath": [
1737
+ "dist",
1738
+ "commands",
1739
+ "hydrogen",
1740
+ "unlink.js"
1741
+ ]
1742
+ },
1743
+ "hydrogen:upgrade": {
1744
+ "aliases": [],
1745
+ "args": {},
1746
+ "description": "Upgrade Remix and Hydrogen npm dependencies.",
1747
+ "flags": {
1748
+ "path": {
1749
+ "description": "The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.",
1750
+ "env": "SHOPIFY_HYDROGEN_FLAG_PATH",
1751
+ "name": "path",
1752
+ "hasDynamicHelp": false,
1753
+ "multiple": false,
1754
+ "type": "option"
1755
+ },
1756
+ "version": {
1757
+ "char": "v",
1758
+ "description": "A target hydrogen version to update to",
1759
+ "name": "version",
1760
+ "required": false,
1761
+ "hasDynamicHelp": false,
1762
+ "multiple": false,
1763
+ "type": "option"
1764
+ },
1765
+ "force": {
1766
+ "char": "f",
1767
+ "description": "Ignore warnings and force the upgrade to the target version",
1768
+ "env": "SHOPIFY_HYDROGEN_FLAG_FORCE",
1769
+ "name": "force",
1770
+ "allowNo": false,
1771
+ "type": "boolean"
1772
+ }
1773
+ },
1774
+ "hasDynamicHelp": false,
1775
+ "hiddenAliases": [],
1776
+ "id": "hydrogen:upgrade",
1777
+ "pluginAlias": "@shopify/cli-hydrogen",
1778
+ "pluginName": "@shopify/cli-hydrogen",
1779
+ "pluginType": "core",
1780
+ "strict": true,
1781
+ "descriptionWithMarkdown": "Upgrade Hydrogen project dependencies, preview features, fixes and breaking changes. The command also generates an instruction file for each upgrade.",
1782
+ "isESM": true,
1783
+ "relativePath": [
1784
+ "dist",
1785
+ "commands",
1786
+ "hydrogen",
1787
+ "upgrade.js"
1788
+ ]
1593
1789
  }
1594
1790
  },
1595
- "version": "7.1.2"
1791
+ "version": "8.0.1"
1596
1792
  }