Shopify / Shopify/hydrogen

Quickstart with mock.shop not working (with sfw-free installed)

Open
#3,877 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
2.1k
Forks
443
Avg merge
4d 19h
Merged PRs (30d)
24

Description

What is the location of your example repository?

No response

Which package or tool is having this issue?

Hydrogen

What version of that package or tool are you using?

@shopify/hydrogen@latest

What version of React Router 7 are you using?

whatever @shopify/hydrogen@latest uses

Steps to Reproduce

Following https://shopify.dev/docs/storefronts/headless/hydrogen/getting-started

  1. npm create @shopify/hydrogen@latest -- --quickstart
  2. cd hydrogen-quickstart && npm run dev
  3. Load up http://localhost:3000 in browser
  4. Watch error in browser and terminal

My system:

node -v && npm -v && lsb_release -a
v24.15.0
11.12.1
No LSB modules are available.
Distributor ID:	Ubuntu
Description:	Ubuntu 24.04.4 LTS
Release:	24.04
Codename:	noble

npm run dev log:

> hydrogen-quickstart@2026.4.5 dev
> shopify hydrogen dev --codegen

The `envFile` option is deprecated, please use `envDir: false` instead.
The `envFile` option is deprecated, please use `envDir: false` instead. (x4)

Environment variables injected into MiniOxygen:

SESSION_SECRET   from local .env

  ➜  Local:   http://localhost:3000/
  ➜  Network: use --host to expose
  ➜  press h + enter to show help


╭─ success ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                                     │
│  View Hydrogen app: http://localhost:3000/                                                                          │
│                                                                                                                     │
│  View GraphiQL API browser:                                                                                         │
│  http://localhost:3000/graphiql                                                                                     │
│                                                                                                                     │
│  View server network requests:                                                                                      │
│  http://localhost:3000/subrequest-profiler                                                                          │
│                                                                                                                     │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

╭─ info ──────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                                     │
│                                                                                                                     │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

╭─ warning ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                                     │
│  [Codegen] The `envFile` option is deprecated, please use `envDir: false` instead.                                  │
│                                                                                                                     │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

╭─ info ──────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                                     │
│                                                                                                                     │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

╭─ warning ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                                     │
│  [Codegen] The `envFile` option is deprecated, please use `envDir: false` instead.                                  │
│                                                                                                                     │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Load http://localhost:3000 log:

╭─ info ──────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                                     │
│  In Hydrogen's `createStorefrontClient`:                                                                            │
│                                                                                                                     │
│  storeDomain missing, defaulting to mock.shop                                                                       │
│                                                                                                                     │
│  Next steps                                                                                                         │
│    • Run `h2 link` to link your store.                                                                              │
│                                                                                                                     │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

[Error: internal error; reference = 63hlbvcnl3qs40dpo8g8ksqc]
Error: internal error; reference = 84ct85jvbt47a4jkvuhfbpee
    at loadDeferredData (/home/marius/Projects/Internettum/hydrogen-quickstart/app/root.jsx:124:6)
    at loader (/home/marius/Projects/Internettum/hydrogen-quickstart/app/root.jsx:66:24)
    at callRouteHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:533:22)
    at commonRoute.loader (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:668:25)
    at actualHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5032:14)
    at /home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5045:91
    at runHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5050:5)
    at callLoaderOrAction (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5097:22)
   GET  500  render  /  533ms
[Error: internal error; reference = f9u8fi0mj8a1eu83qrqrru91]
[Error: internal error; reference = cnasfqav3dl8ia8e3c5cfbgc]
[Error: internal error; reference = 4b2v60u6f0vdovlp0uqkkb2d]
Error: internal error; reference = 6jric4ollrv8s4jgivnonv09
    at loadCriticalData (/home/marius/Projects/Internettum/hydrogen-quickstart/app/root.jsx:101:16)
    at loader (/home/marius/Projects/Internettum/hydrogen-quickstart/app/root.jsx:69:30)
    at callRouteHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:533:22)
    at commonRoute.loader (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:668:25)
    at actualHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5032:14)
    at /home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5045:91
    at runHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5050:5)
    at callLoaderOrAction (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5097:22)
Error: internal error; reference = gpvmqqorkqcn1svnovp9r912
    at loadDeferredData (/home/marius/Projects/Internettum/hydrogen-quickstart/app/routes/_index.jsx:52:6)
    at loader (/home/marius/Projects/Internettum/hydrogen-quickstart/app/routes/_index.jsx:19:24)
    at callRouteHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:533:22)
    at commonRoute.loader (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:668:25)
    at actualHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5032:14)
    at /home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5045:91
    at runHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5050:5)
    at callLoaderOrAction (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5097:22)
[Error: internal error; reference = nhlaie93vsmug1nvsas5u327]
Error: internal error; reference = gjgfqndhdj8e0b76r91821b1
    at loadDeferredData (/home/marius/Projects/Internettum/hydrogen-quickstart/app/root.jsx:124:6)
    at loader (/home/marius/Projects/Internettum/hydrogen-quickstart/app/root.jsx:66:24)
    at callRouteHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:533:22)
    at commonRoute.loader (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:668:25)
    at actualHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5032:14)
    at /home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5045:91
    at runHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5050:5)
    at callLoaderOrAction (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5097:22)
   GET  500  render  /sw.js  21ms
[Error: internal error; reference = 2m8tpa787sp8q403vhbmcd6r]
Error: internal error; reference = p8e24uqvk0evpad721idu1pd
    at loadCriticalData (/home/marius/Projects/Internettum/hydrogen-quickstart/app/root.jsx:101:16)
    at loader (/home/marius/Projects/Internettum/hydrogen-quickstart/app/root.jsx:69:30)
    at callRouteHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:533:22)
    at commonRoute.loader (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-S54KXAEJ.mjs:668:25)
    at actualHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5032:14)
    at /home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5045:91
    at runHandler (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5050:5)
    at callLoaderOrAction (/home/marius/Projects/Internettum/hydrogen-quickstart/node_modules/react-router/dist/development/chunk-QUQL4437.mjs:5097:22)

Relevant closed issue: https://github.com/Shopify/hydrogen/issues/2825

Expected Behavior

The starter should work

Actual Behavior

The starter does not work

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the failure with npm create @shopify/hydrogen@latest -- --quickstart, then npm run dev, as described in the issue. Start by comparing the generated app/root.jsx and app/routes/_index.jsx loader locations in the stack traces with the Hydrogen quickstart setup. Done means the generated app loads at http://localhost:3000 without the reported 500 errors when using the mock.shop default.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js, react, typescript
Domain
backend, developer-experience, web-dev
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.