Forward

Forward

Forward is a fresh Next.js App Router storefront theme for Shopify, powered by Weaverse.

Status

The storefront now has a hybrid production data source. With the approved server-only Shopify environment, products, canonical collection structure, Header `main-menu`, and the complete three-column `footer` navigation tree are read from the Storefront API. Footer navigation has one Store-owned source: it is not derived from `main-menu`, `forward-footer`, or theme-owned Support links. Without that environment it remains a deterministic, network-independent static storefront. Journal/page/policy bodies, theme copy, the browser-local demo cart, and prototype account surfaces still use fixtures; checkout, Customer Account OAuth, Weaverse Studio composition, and locale/market routing remain deferred.

Setup

Requires [Bun](https://bun.sh) (package manager and script runner) and Node.js >= 22.18.0 (the route tooling executes TypeScript directly with Node's built-in type stripping; the app itself stays Node-compatible — Bun is a tooling decision, not a production runtime).

bun install
bun run dev

Open [http://localhost:3333](http://localhost:3333). The development script uses port `3333` by default.

The Hydrogen baseline was initialized in this existing Next.js app with:

npx @shopify/hydrogen@preview setup

That deterministic command installs the preview package and copies Shopify's Hydrogen implementation skills into `.agents/skills/`. The server-owned Storefront read client is wired; cart mutations, request-specific buyer context, checkout, and Customer Account remain explicit future work.

Commands

Command	What it does
bun run dev	Start the development server on http://localhost:3333.
bun run build	Create the production build.
bun run start	Serve the production build.
bun run typecheck	Strict TypeScript check (tsc --noEmit).
bun run lint	Biome lint (biome lint .