Skip to content

chore(cli): always scaffold routes when creating new apps with the cli#3448

Draft
fredericoo wants to merge 4 commits intomainfrom
feat-always-setup-routes
Draft

chore(cli): always scaffold routes when creating new apps with the cli#3448
fredericoo wants to merge 4 commits intomainfrom
feat-always-setup-routes

Conversation

@fredericoo
Copy link
Contributor

@fredericoo fredericoo commented Feb 6, 2026

WHY are these changes introduced?

Improve the first-run experience by ensuring routes are always scaffolded and clearly communicating when the storefront is showing mocked data because no store is linked.

WHAT is this pull request doing?

  • Always run i18n/route setup during local onboarding so projects are fully scaffolded by default.
  • Add a mock shop notice to the skeleton homepage when no store is linked.
  • Refine the notice styles for clarity and prominence with minimal CSS.

HOW to test your changes?

  • run npm run build to build packages
  • run node packages/cli/dist/create-app.js to verify it skips the setup step. this will scaffold a new app with routes. Starting the app should reveal the fully fledged app as we expect, with a welcome notice instructing you to link your store
  • run node packages/cli/dist/create-app.js --no-routes to scaffold an app with no routes. Starting the app should display the virtual index route with instructions. I have not touched this in this PR.

Checklist

  • I've read the Contributing Guidelines
  • I've considered possible cross-platform impacts (Mac, Linux, Windows)
  • I've added a changeset if this PR contains user-facing or noteworthy changes
  • I've added tests to cover my changes
  • I've added or updated the documentation

@shopify
Copy link
Contributor

shopify bot commented Feb 6, 2026

Oxygen deployed a preview of your feat-always-setup-routes branch. Details:

Storefront Status Preview link Deployment details Last update (UTC)
Skeleton (skeleton.hydrogen.shop) ✅ Successful (Logs) Preview deployment Inspect deployment February 6, 2026 1:10 PM

Learn more about Hydrogen's GitHub integration.

Comment on lines +8 to +17
<h2 id="mock-shop-notice-heading">Welcome to Hydrogen!</h2>
<p>
You&rsquo;re seeing mocked products because no store is connected to
this project yet.
</p>
<p>
Link a store by running <code>npx shopify hydrogen link</code> in your
terminal.
</p>
</div>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

these messages are inspired by this article

it’s a great read and helps writing better notification messages in general

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant