Skip to main content

Deployment

A storefront from the Accelerator is a server-rendered Node application, not a static export. Deploy it the way you deploy any app of its framework, on a host that runs Node 22. Run the commands below from the app folder: the project root, or frontend/ if you scaffolded with a CMS.

Checked against the boilerplates of 18 October 2026 (Next.js 1.22.1, Vue 1.22.1, Nuxt 1.20.1).

Build and run​

StackBuildStart
Next.jsnpm run buildnpm run start
Nuxtnpm run buildnode .output/server/index.mjs
Vuenpm run build (the browser and server bundles)npm run start (node server.js)

Set PORT to choose the port. The Vue server only listens on its own machine (127.0.0.1) unless you set HOST: in a container or behind a load balancer, set HOST=0.0.0.0.

Settings​

Set the same settings as in development, with production values, in your host's environment or secret store. See Accelerator for the names per stack. Before the first deploy, set at least:

  • the GraphQL endpoint, the API key and the order-editor API key;
  • the channel;
  • the portal mode, the site URL and the default language;
  • REVALIDATE_SECRET, a long random value for the refresh endpoint.

Settings that start with NEXT_PUBLIC_, VITE_ or NUXT_PUBLIC_ are built into the app during npm run build. Set them before you build, and rebuild after you change one. Which keys to use is on Keys and security.

Refreshing cached data​

All three boilerplates cache the catalog data they fetch for anonymous visitors and expose POST /api/revalidate. Point a backend webhook at it, with the X-Revalidate-Secret header, so a catalog change refreshes the affected data without a rebuild. See Routing.

Before you go live​

  • Work through Before you deploy: the keys, the /tracker dashboard, the refresh secret and the payment webhooks.
  • If you scaffolded with a CMS (Next.js), set CMS_PROVIDER and the CMS credentials, and host the CMS itself separately. See CMS integration.
  • The boilerplates do not serve a robots.txt or a sitemap. Add your own.

See also​

Last updated on