Remove HTTPS setup script and rename dev command (#3966)

Assisted-By: devx/485dfcc0-8160-4274-ae2a-5c0b86649940

Author: fredericoo

.changeset/quick-plums-develop.md

@@ -0,0 +1,5 @@
+---
+"@shopify/hydrogen": patch
+---
+
+Rename local HTTPS development scripts from `https:dev` to `dev:https` and rely on the Vite plugin to provision certificates automatically.

.docs/dependencies.md

@@ -9,6 +9,6 @@ When changing `@shopify/hydrogen/vite` local HTTPS behaviour, update these toget
 - `templates/react-router/README.md`
 - `templates/react-router/package.json`
 - `templates/react-router/vite.config.ts`
-- framework example `https:dev` scripts and configs under `examples/*`
+- framework example `dev:https` scripts and configs under `examples/*`
 
 `scripts/preview-template-dist.ts` copies `packages/hydrogen/skills` into template `.agents/skills` when preparing the dist branch, so template source directories should not duplicate those generated skill copies.

AGENTS.md

@@ -17,6 +17,6 @@ When designing or adjusting APIs for the `hydrogen` package, closely follow the
 ## Local HTTPS for Examples
 
 - Account-enabled framework examples use `https://local.tryhydrogen.dev:5173` for Customer Account OAuth callback testing.
-- Vite-based examples consume Hydrogen's default certificates. Certificates are provisioned automatically on `https:dev` startup, or run `pnpm https:setup` once from the repository root (`npx hydrogen certs install` in a consumer project). Both download a pinned, checksum-verified mkcert release, trust the local certificate authority, and create the certificates under `~/.shopify/hydrogen/certs/`.
+- Vite-based examples consume Hydrogen's default certificates. Certificates are provisioned automatically on `dev:https` startup. This downloads a pinned, checksum-verified mkcert release, trusts the local certificate authority, and creates the certificates under `~/.shopify/hydrogen/certs/`. Nuxt and SolidStart may need one restart after first-run provisioning so their outer dev servers can load the certificate files.
 - The Next.js example provisions its own certificate. The Hydrogen example uses the Shopify CLI tunnel flow.
-- After setup, run the relevant example with `pnpm --filter @shopify/hydrogen-example-<name> https:dev` when that example provides the script.
+- Run the relevant example with `pnpm --filter @shopify/hydrogen-example-<name> dev:https` when that example provides the script.

examples/README.md

@@ -29,15 +29,11 @@ From the repository root:
 - `pnpm dev` — run all workspace examples and templates in parallel.
 - `pnpm dev:hub` — run the examples with automatically allocated ports and open the browser hub with status, previews, and logs.
 - `pnpm --filter @shopify/hydrogen-example-<name> dev` — run one example.
-- `pnpm https:setup` then `pnpm --filter @shopify/hydrogen-example-<name> https:dev` — run an account-enabled example on `https://local.tryhydrogen.dev:5173` when it provides an `https:dev` script. The Hydrogen example uses `--customer-account-push` instead of local certificates.
+- `pnpm --filter @shopify/hydrogen-example-<name> dev:https` — run an account-enabled example on `https://local.tryhydrogen.dev:5173` when it provides a `dev:https` script. The Hydrogen example uses `--customer-account-push` instead of local certificates.
 
-Local HTTPS certificates are provisioned automatically the first time an `https:dev` script starts, or explicitly with:
+The local HTTPS plugin provisions certificates automatically the first time a `dev:https` script starts. It downloads a pinned, checksum-verified [mkcert](https://github.com/FiloSottile/mkcert) release, installs the local certificate authority (this may prompt for your password), and creates trusted `local.tryhydrogen.dev` certificates under `~/.shopify/hydrogen/certs/` so Customer Account OAuth can redirect to `https://local.tryhydrogen.dev:5173/account/authorize`.
 
-```sh
-pnpm https:setup
-```
-
-Both download a pinned, checksum-verified [mkcert](https://github.com/FiloSottile/mkcert) release, install the local certificate authority (this may prompt for your password), and create trusted `local.tryhydrogen.dev` certificates under `~/.shopify/hydrogen/certs/` so Customer Account OAuth can redirect to `https://local.tryhydrogen.dev:5173/account/authorize`.
+Nuxt and SolidStart may need the command restarted once after first-run provisioning so their outer dev servers can load the certificate files.
 
 The Next.js template provisions its own development certificate and does not use the Hydrogen certificates.
 

examples/astro/README.md

@@ -40,8 +40,7 @@ The account flow uses `createCustomerSession` and `createCustomerAccountServerHa
 Customer Account OAuth requires a public HTTPS origin. To test locally without a tunnel, register `https://local.tryhydrogen.dev:5173/account/authorize` as the callback URI and run:
 
 ```sh
-pnpm https:setup
-pnpm --filter @shopify/hydrogen-example-astro https:dev
+pnpm --filter @shopify/hydrogen-example-astro dev:https
 ```
 
 ## Run

examples/astro/astro.config.mjs

@@ -5,7 +5,7 @@ import tailwindcss from "@tailwindcss/vite";
 import { defineConfig } from "astro/config";
 
 const enabled =
-  process.env.VITE_LOCAL_HTTPS === "1" || process.env.npm_lifecycle_event === "https:dev";
+  process.env.VITE_LOCAL_HTTPS === "1" || process.env.npm_lifecycle_event === "dev:https";
 const httpsOptions = { enabled };
 
 export default defineConfig({

examples/astro/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "astro dev",
-    "https:dev": "astro dev",
+    "dev:https": "astro dev",
     "build": "astro build",
     "start": "node ./dist/server/entry.mjs",
     "typecheck": "astro check"

examples/hydrogen/README.md

@@ -49,5 +49,5 @@ Follow step 1 and 2 of <https://shopify.dev/docs/custom-storefronts/building-wit
 For local account testing, use the Customer Account push flow:
 
 ```bash
-pnpm --dir examples/hydrogen https:dev
+pnpm --dir examples/hydrogen dev:https
 ```

examples/hydrogen/package.json

@@ -7,7 +7,7 @@
   "scripts": {
     "build": "shopify hydrogen build --no-lockfile-check",
     "dev": "react-router dev",
-    "https:dev": "shopify hydrogen dev --customer-account-push",
+    "dev:https": "shopify hydrogen dev --customer-account-push",
     "preview": "shopify hydrogen preview --build",
     "typecheck": "react-router typegen && tsc --noEmit",
     "e2e": "playwright test",

examples/nuxt/nuxt.config.ts

@@ -5,7 +5,7 @@ import type { NuxtConfig } from "nuxt/schema";
 type VitePlugin = NonNullable<NonNullable<NuxtConfig["vite"]>["plugins"]>[number];
 
 const enabled =
-  process.env.VITE_LOCAL_HTTPS === "1" || process.env.npm_lifecycle_event === "https:dev";
+  process.env.VITE_LOCAL_HTTPS === "1" || process.env.npm_lifecycle_event === "dev:https";
 const httpsOptions = { enabled };
 const httpsPlugin = localHttps(httpsOptions);