Skip to content

Free shipping over ¥22,000

NOVA
NOVA

Section F

Customer accounts

Live mode registers Hydrogen's OAuth handlers (/account/login, /authorize, /refresh, /logout). Demo mode swaps OAuth for a profile picker and serves the same typed Customer Account API queries from a mock CAAPI.

Authentication, sessions, login & logout

Signed HttpOnly session cookie; isLoggedIn() for read-only UI, getAccessToken() before CAAPI calls, and a one-shot refresh redirect. Tokens never reach loader data.

Real HydrogenMock adapterNeeds a store
Hydrogen API
createCustomerSessioncreateCustomerAccountServerHandlersWritableCustomerSessionManager
Data
Demo session / Shopify OAuth (requires HTTPS + client id)
Docs
.claude/skills/hydrogen-customer-account/SKILL.md
{
  "mode": "demo",
  "loggedIn": false,
  "shopIdConfigured": true,
  "clientIdConfigured": false
}

Demo mode: /account/login renders a profile picker, and the session stores a demo customer id. The mock CAAPI derives the customer from the access token.

See it in the store:Account

Customer profile & order history

Profile edit, addresses CRUD, order list, order detail with fulfillment timelines and tracking.

Real HydrogenMock adapter
Hydrogen API
createCustomerAccountClientgql (customer-account)
Data
Mock CAAPI over customer-account.schema.json
TypeScript
import { createCustomerAccountClient, gql } from "@shopify/hydrogen/customer-account";
const client = createCustomerAccountClient({ shopId, requestContext /* demo: fetch: mockCaapi */ });
const { data } = await client.graphql(CUSTOMER_QUERY, { accessToken });

See it in the store:Orders

Next · GShopify Markets

Your bag

Popular

Browse

Loading…
Demo mode