Fix theme dev storefront host for preview stores

[alfonso-noriega]

WHY are these changes introduced?

Preview-store and local development can require separate URLs for Admin API, storefront rendering, theme editor, and shareable storefront preview access. theme dev previously had one store host and used it for all generated links and local rendering. That breaks prototype preview-store flows where the Admin API host is usable but browser-facing links need different routing or a backend-generated tokenized preview URL.

WHAT is this pull request doing?

• Adds an optional storefrontFqdn to theme dev server sessions.
• Keeps Admin API operations on storeFqdn, while SFR rendering/proxy/cookie-domain handling can use storefrontFqdn when explicitly provided.
• Adds hidden theme dev --storefront-host / SHOPIFY_FLAG_STOREFRONT_HOST for experiments where storefront rendering differs from --store.
• Adds hidden theme dev --preview-url / SHOPIFY_FLAG_PREVIEW_URL so preview-store flows can show/open a backend-generated preview URL instead of the standard ?preview_theme_id= URL.
• Generates local dev-api editor links through the browser-facing admin host (admin.shop.dev/store/<shop>/themes/<theme>/editor) while preserving the original /admin/themes/... URL for normal stores.
• Defaults to original behavior when no hidden overrides are provided.

How to test your changes?

Automated checks run locally:

pnpm vitest packages/theme/src/cli/services/dev.test.ts packages/theme/src/cli/utilities/theme-environment/storefront-renderer.test.ts packages/theme/src/cli/utilities/theme-environment/dev-server-session.test.ts --run
pnpm nx run theme:type-check
pnpm nx run theme:lint

Manual smoke test target:

shopify theme dev --store preview-<id>.dev-api.shop.dev --password <admin-api-token>

If a preview-store environment needs explicit storefront/preview routing, pass:

shopify theme dev --store preview-<id>.dev-api.shop.dev --storefront-host <storefront-host> --preview-url <backend-preview-url> --password <admin-api-token>

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes
• I've considered analytics changes to measure impact
• The change is user-facing — bump/changeset decision pending for prototype stack

[alfonso-noriega]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Fix theme dev storefront host for preview stores #7667 👈 (View in Graphite)
• feat(store): add shopify store list command #7609 : 1 other dependent PR (#7610 )
• Add shopify store create preview command #7558
• Add preview-store discriminator to stored store auth sessions #7557
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

Differences in type declarations

We detected differences in the type declarations generated by Typescript for this branch compared to the baseline ('main' branch). Please, review them to ensure they are backward-compatible. Here are some important things to keep in mind:

• Some seemingly private modules might be re-exported through public modules.
• If the branch is behind main you might see odd diffs, rebase main into this branch.

New type declarations

We found no new type declarations in this PR

Existing type declarations

packages/cli-kit/dist/public/node/local-storage.d.ts

@@ -34,6 +34,19 @@ export declare class LocalStorage<T extends Record<string, any>> {
      * @throws BugError if an unexpected error occurs.
      */
     delete<TKey extends keyof T>(key: TKey): void;
+    /**
+     * Get every  pair currently held in the local storage.
+     *
+     * Useful for callers that need to enumerate all stored values without knowing the
+     * full set of keys in advance (for example, a  command iterating over every
+     * stored session). The  package stores its entire state as a single JSON
+     * object, so this is just a typed wrapper around that object.
+     *
+     * @returns An array of  tuples.
+     * @throws AbortError if a permission error occurs.
+     * @throws BugError if an unexpected error occurs.
+     */
+    entries(): [keyof T, T[keyof T]][];
     /**
      * Clear the local storage (delete all values).
      *

[github-actions]

This PR seems inactive. If it's still relevant, please add a comment saying so. Otherwise, take no action.
→ If there's no activity within a week, then a bot will automatically close this.
Thanks for helping to improve Shopify's dev tooling and experience.