Critical Alert: ESHOPMAN Admin UI Setup Issues with Next.js Starters (Versions 2.18.0 & 2.19.0)
At Move My Store, we champion a seamless setup experience for your ESHOPMAN headless commerce platform, especially when integrating with HubSpot for storefront management and deployment via HubSpot CMS. A smooth start ensures you can quickly leverage ESHOPMAN's powerful features, from product variants to its robust Admin and Store APIs.
Recently, our ESHOPMAN community identified a critical issue affecting fresh installations of the platform when utilizing the Next.js starter template. This bug prevents the ESHOPMAN Admin UI from functioning correctly, posing a significant hurdle for new users attempting to initialize their projects and connect their stores to HubSpot.
Critical Bug: ESHOPMAN Admin UI Setup Failures
Initializing a new ESHOPMAN project with the Next.js starter (e.g., npx create-eshopman-app@latest projectname --with-nextjs-starter) results in a broken Admin UI. This issue is observed across Node.js versions (20.19.5, 22.23.2) and on Windows 11, indicating a platform-level regression.
Symptoms: Version 2.19.0
With ESHOPMAN version 2.19.0, after successful installation, the browser opens to the ESHOPMAN Admin UI (localhost:9000) but shows a blank page. The console reveals a critical React rendering error:
Uncaught Error: Objects are not valid as a React child (found: object with keys {$$typeof, type, key, props, _owner, _store}). If you meant to render a collection of children, use an array instead
This suggests a problem within the Admin UI's front-end bundling or a compatibility issue with its React dependencies.
Symptoms: Version 2.18.0
Rolling back to ESHOPMAN version 2.18.0, the admin user creation form *does* appear. However, upon submission, an error is displayed:
TypeError: Failed to fetch dynamically imported module: http://localhost:9000/app/@fs//apps/backend/node_modules/.vite/deps/login-REAKYYFI-PT4BGEHE.js?v=5ccd7859
This "Failed to fetch dynamically imported module" error indicates an issue with how the ESHOPMAN Admin UI loads necessary JavaScript modules post-login, potentially due to incorrect paths or bundling configuration.
Impact & Next Steps
These issues highlight a regression in the ESHOPMAN Admin UI's bundling or dependency compatibility, introduced around versions 2.18.0 and 2.19.0. This significantly blocks new users from the crucial initial setup of the ESHOPMAN backend—essential for managing products, orders, and deploying your storefront via HubSpot CMS.
The ESHOPMAN team is actively investigating this critical bug. While an immediate community-verified workaround isn't yet available, we encourage developers and merchants encountering similar issues to contribute to the community discussion. Your detailed reports help the core team diagnose and resolve these issues faster, ensuring a stable and reliable platform.
Move My Store is dedicated to helping you navigate the ESHOPMAN ecosystem. We will update our community with any official fixes or recommended workarounds to ensure setting up your ESHOPMAN store, integrating with HubSpot, and deploying your storefront on HubSpot CMS is as smooth and efficient as possible.