Section L
Oxygen
Oxygen is a Web Worker runtime. This app runs on Node by default but keeps the server code worker-friendly: Web Request/Response, no Node-only APIs in request paths, env read in one module, and per-request Shopify objects.
Deployment compatibility & runtime requirements
Checklist of what the codebase already satisfies and what a deploy adds (worker entry, MiniOxygen, cache, waitUntil).
Needs a store
- Hydrogen API
@shopify/hydrogen/viteskill: hydrogen-oxygen- Data
- Requires Shopify Oxygen deployment
- Docs
.claude/skills/hydrogen-oxygen/SKILL.md
- ✓Web Request/Response in every request path
- ✓No Node-only APIs (fs, Buffer, process) in middleware, handlers or mock API request paths
- ✓Environment read in one server module (env.server.ts)
- ✓Per-request Storefront client + request context
- ✓Module-scope handler groups and i18n/route templates (define*)
- ○Worker entry (server.ts) + MiniOxygen via @shopify/hydrogen/vite
- ○CacheStorage + waitUntil passed to createStorefrontClient
- ○Mock carts in memory → per-isolate on workers (use DEMO_MODE=false in production)
{
"node": "v26.13.1",
"hasCacheStorage": false,
"runtime": "Node.js/26",
"envKeys": [
{
"key": "DEMO_MODE",
"set": false
},
{
"key": "PUBLIC_STORE_DOMAIN",
"set": false
},
{
"key": "PUBLIC_STOREFRONT_API_TOKEN",
"set": false
},
{
"key": "PRIVATE_STOREFRONT_API_TOKEN",
"set": false
},
{
"key": "PUBLIC_STOREFRONT_ID",
"set": false
},
{
"key": "SHOP_ID",
"set": false
},
{
"key": "PUBLIC_CUSTOMER_ACCOUNT_API_CLIENT_ID",
"set": false
},
{
"key": "CUSTOMER_ACCOUNT_SESSION_SECRET",
"set": false
}
]
}