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
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