Ready to take your Weaverse Hydrogen project live? This guide covers deploying your storefront to various hosting platforms with production-ready configurations.
The official hosting platform for Hydrogen storefronts with seamless Shopify integration.Best for: Production storefronts, enterprise deployments, maximum performance
Global CDN: Worldwide edge locations for fast loading
Zero Configuration: Automatic scaling and optimization
Native Integration: Direct connection to Shopify APIs
Step-by-step guide to securely deploying your Weaverse Hydrogen Project on Shopify Oxygen, with best practices and troubleshooting.
Custom Domain & DNS Setup
Connect your custom domain to a Shopify Hydrogen storefront with proper DNS configuration.
Deploy with Docker
Containerize your Weaverse theme and deploy it to any cloud provider, with a worked Fly.io example
Deploy to Cloudflare Workers
Migrate a Weaverse Hydrogen theme from Oxygen to Cloudflare Workers, step by step
Last modified on June 22, 2026
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Weaverse","colors":{"primary":"#246aff","light":"#599aff","dark":"#1e40af"},"logo":{"light":"https://mintcdn.com/weaverse/UqDg35noNYU1xQJr/logo/light.svg?fit=max\u0026auto=format\u0026n=UqDg35noNYU1xQJr\u0026q=85\u0026s=03570de959edb471a7177f81be24d246","dark":"https://mintcdn.com/weaverse/UqDg35noNYU1xQJr/logo/dark.svg?fit=max\u0026auto=format\u0026n=UqDg35noNYU1xQJr\u0026q=85\u0026s=37c6ba54acdc2f2fec124b27d05ac379","href":"https://weaverse.io"},"favicon":"https://mintcdn.com/weaverse/EOrmVdYBR-QCAvXJ/favicon.ico?fit=max\u0026auto=format\u0026n=EOrmVdYBR-QCAvXJ\u0026q=85\u0026s=fee3d7a85f68c8b9e62d849017c3c087","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python"]}},"navbar":{"links":[{"href":"https://weaverse.io","label":"Weaverse.io"},{"href":"https://github.com/weaverse","label":"GitHub"},{"href":"https://wvse.cc/weaverse-slack","label":"Community"}],"primary":{"type":"button","label":"Studio","href":"https://studio.weaverse.io/dashboard"}},"footer":{"socials":{"x":"https://x.com/WeaverseIO","github":"https://github.com/weaverse","slack":"https://wvse.cc/weaverse-slack"}},"seo":{"metatags":{"og:site_name":"Weaverse Docs","twitter:site":"@WeaverseIO","keywords":"Weaverse, Shopify Hydrogen, headless commerce, visual page builder, React Router, Next.js"},"organization":{"name":"Weaverse","url":"https://weaverse.io","logo":"https://docs.weaverse.io/logo/light.svg","sameAs":["https://github.com/weaverse","https://x.com/WeaverseIO","https://wvse.cc/weaverse-slack"]}},"integrations":{"posthog":{"apiKey":"phc_BnZAhY8ELZCZukEErb6ab9T7txSsMolcgGIIhMj5oSP","apiHost":"https://posthog.weaverse.io"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","add-mcp","download-spec","cursor","vscode"],"display":"header"},"thumbnails":{"preset":"headline","appearance":"dark"},"metadata":{"timestamp":true},"markdown":{"instructions":["Weaverse component configuration uses `settings`. `inspector` is deprecated; never generate it.","Weaverse Hydrogen themes use React Router v7: import from `react-router`, never `react-router-dom` or `@remix-run/*`.","Before using any code sample, read `@weaverse/hydrogen` in the project's `package.json`: 6.x and 5.x import from different entries and use different type names, so code for one does not build on the other.","`@weaverse/hydrogen` 6 (Shopify Hydrogen 2026.10 and later, the version these docs show) imports from `@weaverse/hydrogen/react-router` and uses `Weaverse*` types such as `WeaverseComponentProps`, `WeaverseComponentLoaderArgs` and `WeaverseComponentSchema`; the root `@weaverse/hydrogen` entry only exports `createSchema()`, data helpers and types.","`@weaverse/hydrogen` 5.x (Hydrogen 2026.4 and earlier) imports everything from `@weaverse/hydrogen` and uses `HydrogenComponentProps`, `ComponentLoaderArgs` and `HydrogenComponentSchema`. On a 5.x project, convert samples to these names. Upgrade to 6 only when asked (`npx @weaverse/cli@latest migrate v6`, plus the Hydrogen 2026.10 upgrade). Do not mix major versions.","Next.js themes use `@weaverse/hydrogen` 6.2.0 or later: import client and shared code from `@weaverse/hydrogen/next` and server-only code from `@weaverse/hydrogen/next/server`. `@weaverse/next` is deprecated; never install or import it.","For live project data (pages, theme settings, translations), use the Weaverse MCP server: https://weaverse.io/docs/developer-tools/weaverse-mcp"]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"weaverse","hasAudioNarration":false,"actualSubdomain":"weaverse","customDomains":["weaverse.io"],"gitSource":{"type":"github","owner":"weaverse","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af5837551057243856f5731","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"Content API","count":54},{"language":"default","tag":"React Router","count":43},{"language":"default","tag":"Guides","count":42},{"language":"default","tag":"Ecosystem","count":22},{"language":"default","tag":"Next.js","count":21},{"language":"default","tag":"SDKs","count":18},{"language":"default","tag":"Drafts and publishing","count":12},{"language":"default","tag":"Hooks","count":10},{"language":"default","tag":"Help \u0026 Community","count":10},{"language":"default","tag":"Building Components","count":7}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"guides/deployment","slug":"/guides/deployment","pageMetadata":{"title":"Deployment","description":"Deploy your Weaverse Hydrogen storefront to Shopify Oxygen, Docker, Cloudflare Workers, and other platforms.","published":true,"href":"/guides/deployment/index"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Deploy your Weaverse Hydrogen storefront to Shopify Oxygen, Docker, Cloudflare Workers, and other platforms.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`deployment`,children:`Deployment`}),`\n`,_jsx(_components.p,{children:`Ready to take your Weaverse Hydrogen project live? This guide covers deploying your storefront to various hosting platforms with production-ready configurations.`}),`\n`,_jsx(Heading,{level:`2`,id:`deployment-options`,children:`Deployment Options`}),`\n`,_jsx(Heading,{level:`3`,id:`recommended-shopify-oxygen`,children:`Recommended: Shopify Oxygen`}),`\n`,_jsx(_components.p,{children:`The official hosting platform for Hydrogen storefronts with seamless Shopify integration.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Best for`}),`: Production storefronts, enterprise deployments, maximum performance`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Global CDN`}),`: Worldwide edge locations for fast loading`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Zero Configuration`}),`: Automatic scaling and optimization`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Native Integration`}),`: Direct connection to Shopify APIs`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Enterprise Support`}),`: Production-grade reliability`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`👉 `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/guides/deployment/oxygen`,children:`Deploy to Oxygen`})}),` - Complete step-by-step guide`]}),`\n`,_jsx(Heading,{level:`3`,id:`alternative-docker-deployment`,children:`Alternative: Docker Deployment`}),`\n`,_jsx(_components.p,{children:`Deploy to any cloud provider using containerized deployment.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Best for`}),`: Custom infrastructure, hybrid setups, specific compliance requirements`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Platform Flexibility`}),`: Works on AWS, Google Cloud, Azure, Digital Ocean`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Custom Configuration`}),`: Full control over server setup`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Scalable Architecture`}),`: Container orchestration support`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Development Consistency`}),`: Same environment from dev to production`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`👉 `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/guides/deployment/docker`,children:`Docker Deployment Guide`})}),` - Containerized deployment setup`]}),`\n`,_jsx(Heading,{level:`2`,id:`quick-start`,children:`Quick Start`}),`\n`,_jsx(Heading,{level:`3`,id:`for-most-projects-recommended`,children:`For Most Projects (Recommended)`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/guides/deployment/oxygen`,children:`Deploy to Shopify Oxygen`})}),` - Official platform with zero configuration`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Set environment variables`}),` - Add your Weaverse Project ID and store configuration`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connect GitHub`}),` - Automatic deployments on code changes`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Go live`}),` - Your storefront is ready for customers`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`for-custom-infrastructure`,children:`For Custom Infrastructure`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/guides/deployment/docker`,children:`Use Docker deployment`})}),` - Containerized setup for any cloud provider`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Configure hosting`}),` - Set up your preferred cloud platform`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Set up CI/CD`}),` - Automated deployment pipeline`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Monitor and scale`}),` - Production monitoring setup`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`production-checklist`,children:`Production Checklist`}),`\n`,_jsx(_components.p,{children:`Before deploying to production:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Environment Variables`}),`: All required variables configured`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Store Connection`}),`: Shopify store properly connected`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Weaverse Project`}),`: Project ID configured and Studio preview working`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Performance`}),`: Site loads fast and Core Web Vitals are green`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Testing`}),`: All features tested in staging environment`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SEO`}),`: Meta tags, sitemap, and structured data configured`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Analytics`}),`: Tracking and monitoring setup`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Security`}),`: SSL certificate and security headers configured`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/development-guide/environment-setup`,children:`Environment Setup`})}),` - Configure your development environment`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/features/page-seo`,children:`Performance Optimization`})}),` - Optimize your storefront for speed`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/features/page-seo`,children:`SEO Best Practices`})}),` - Search engine optimization guide`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`need-help`,children:`Need Help?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/community/community`,children:`Community Support`})}),` - Get help from the Weaverse community`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/intro/quickstart`,children:`Documentation`})}),` - Complete development guides`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`https://studio.weaverse.io/dashboard`,children:`Studio Support`})}),` - Access Studio help resources`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Deployment","description":"Deploy your Weaverse Hydrogen storefront to Shopify Oxygen, Docker, Cloudflare Workers, and other platforms.","published":true,"href":"/guides/deployment/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Deployment","slug":"deployment","depth":1,"children":[]},{"title":"Deployment Options","slug":"deployment-options","depth":2,"children":[{"title":"Recommended: Shopify Oxygen","slug":"recommended-shopify-oxygen","depth":3,"children":[]},{"title":"Alternative: Docker Deployment","slug":"alternative-docker-deployment","depth":3,"children":[]}]},{"title":"Quick Start","slug":"quick-start","depth":2,"children":[{"title":"For Most Projects (Recommended)","slug":"for-most-projects-recommended","depth":3,"children":[]},{"title":"For Custom Infrastructure","slug":"for-custom-infrastructure","depth":3,"children":[]}]},{"title":"Production Checklist","slug":"production-checklist","depth":2,"children":[]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]},{"title":"Need Help?","slug":"need-help","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/weaverse/0543a9a70b6f3643/snitcher.js","/docs/_mintlify/custom/weaverse/20987ec1c9b2ceb6/same-tab-nav.js"],"subdomain":"weaverse","siteName":"Weaverse","title":"Deployment - Weaverse","navMaps":{"firstHrefInVersion":{"v5.x":{"href":"/guides/deployment/index","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-06-17T08:47:18.835Z","gitLastModified":"2026-06-22T04:27:44.000Z","originalFileLocation":"guides/deployment/index.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Deploy your Weaverse Hydrogen storefront to Shopify Oxygen, Docker, Cloudflare Workers, and other platforms.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Weaverse, Shopify Hydrogen, headless commerce, visual page builder, React Router, Next.js\">\u003cmeta data-mint-head name=\"application-name\" content=\"Weaverse\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Deployment - Weaverse\">\u003cmeta data-mint-head property=\"og:description\" content=\"Deploy your Weaverse Hydrogen storefront to Shopify Oxygen, Docker, Cloudflare Workers, and other platforms.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Weaverse Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://weaverse.io/docs/guides/deployment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://weaverse.mintlify.site/docs/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Deployment\u0026amp;description=Deploy+your+Weaverse+Hydrogen+storefront+to+Shopify+Oxygen%2C+Docker%2C+Cloudflare+Workers%2C+and+other+platforms.\u0026amp;theme=27b71a4830417710c5655f27\u0026amp;signature=d2afb61a8f8c4e3b1986aa253b57933dcc59296f7e90b9d58b2e609be042e803\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Deployment - Weaverse\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Deploy your Weaverse Hydrogen storefront to Shopify Oxygen, Docker, Cloudflare Workers, and other platforms.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://weaverse.mintlify.site/docs/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Deployment\u0026amp;description=Deploy+your+Weaverse+Hydrogen+storefront+to+Shopify+Oxygen%2C+Docker%2C+Cloudflare+Workers%2C+and+other+platforms.\u0026amp;theme=27b71a4830417710c5655f27\u0026amp;signature=d2afb61a8f8c4e3b1986aa253b57933dcc59296f7e90b9d58b2e609be042e803\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/weaverse/BNjY59OJurJKyxIa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Weaverse\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#246aff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://weaverse.io/docs/guides/deployment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/guides/deployment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://weaverse.io/#organization\",\"name\":\"Weaverse\",\"url\":\"https://weaverse.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://docs.weaverse.io/logo/light.svg\"},\"sameAs\":[\"https://github.com/weaverse\",\"https://x.com/WeaverseIO\",\"https://wvse.cc/weaverse-slack\"]},{\"@type\":\"WebSite\",\"@id\":\"https://weaverse.io/docs#website\",\"name\":\"Weaverse\",\"url\":\"https://weaverse.io/docs\",\"publisher\":{\"@id\":\"https://weaverse.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://weaverse.io/docs/guides/deployment#webpage\",\"url\":\"https://weaverse.io/docs/guides/deployment\",\"name\":\"Deployment\",\"description\":\"Deploy your Weaverse Hydrogen storefront to Shopify Oxygen, Docker, Cloudflare Workers, and other platforms.\",\"dateModified\":\"2026-06-22T04:27:44.000Z\",\"isPartOf\":{\"@id\":\"https://weaverse.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://weaverse.io/docs/guides/deployment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://weaverse.io/docs/guides/deployment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Weaverse\",\"item\":\"https://weaverse.io/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Deployment\",\"item\":\"https://weaverse.io/docs/guides/deployment\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://weaverse.io/docs/guides/deployment#article\",\"headline\":\"Deployment\",\"name\":\"Deployment\",\"description\":\"Deploy your Weaverse Hydrogen storefront to Shopify Oxygen, Docker, Cloudflare Workers, and other platforms.\",\"url\":\"https://weaverse.io/docs/guides/deployment\",\"mainEntityOfPage\":{\"@id\":\"https://weaverse.io/docs/guides/deployment#webpage\"},\"dateModified\":\"2026-06-22T04:27:44.000Z\",\"publisher\":{\"@id\":\"https://weaverse.io/#organization\"},\"isPartOf\":{\"@id\":\"https://weaverse.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Weaverse\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Weaverse\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/guides/deployment.md","siteName":"Weaverse","nav":{"global":null,"versions":[{"version":"v5.x","default":true,"tag":"Latest","tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":""}]},{"tab":"Guides","dropdowns":[{"dropdown":"React Router","icon":"https://mintlify.s3.us-west-1.amazonaws.com/weaverse/images/icons/react-router.svg","groups":[{"group":"Environment","pages":[{"title":"Environment Variables","href":"/development-guide/environment-setup"},{"title":"Studio vs. Live Environment","href":"/development-guide/design-mode"}]},{"group":"Building Components","pages":[{"title":"Creating Components","href":"/development-guide/creating-components"},{"title":"Component Schema","href":"/development-guide/component-schema"},{"title":"Input Settings","href":"/development-guide/input-settings"},{"title":"Weaverse Hydrogen Component","href":"/development-guide/weaverse-component"},{"title":"Styling \u0026 Theming","href":"/development-guide/styling-theming"},{"title":"Section Data Fetching","href":"/development-guide/data-fetching"},{"title":"Data Connectors","href":"/development-guide/data-connectors"}]},{"group":"Content Management","pages":[{"title":"Global Sections","href":"/features/global-sections"},{"title":"Scheduled Publishing","href":"/features/schedule-publish"},{"title":"Navigation Configuration","href":"/features/navigation-menus"},{"title":"Third-party Integration","href":"/features/third-party-integrations"},{"title":"Installable Mobile App (PWA)","href":"/features/mobile-app-pwa"}]},{"group":"Internationalization","pages":[{"title":"Markets and Localization","href":"/features/markets-localization"},{"title":"Translation Feature Guide","href":"/features/translation-feature-guide"},{"title":"i18next Integration","href":"/features/i18next-integration"}]},{"group":"Security \u0026 Privacy","pages":[{"title":"Content Security Policy","href":"/features/content-security"},{"title":"Cookie Consent Banner","href":"/features/cookie-consent-banner"},{"title":"Analytics \u0026 Conversion Tracking","href":"/features/analytics-tracking"},{"title":"Security \u0026 Deployment Practices","href":"/features/security-deployment-practices"}]},{"group":"Pages \u0026 Routing","pages":[{"title":"Custom Pages","href":"/features/custom-pages"},{"title":"Page SEO","href":"/features/page-seo"},{"title":"Custom Templates","href":"/features/custom-templates"},{"title":"Custom Routing","href":"/features/custom-routing"}]},{"group":"Advanced","pages":[{"title":"Rendering Weaverse Pages","href":"/guides/rendering-page"},{"title":"Advanced Localization Guide","href":"/guides/localization-advanced"},{"title":"Multi-Project Architecture","href":"/guides/multi-project-architecture"},{"title":"Customer Account API Local Development","href":"/development-guide/customer-account-local-dev"},{"title":"Multipass in Hydrogen","description":"Implement Shopify Multipass SSO in a Hydrogen storefront using the legacy customer account flow and Storefront API customer access tokens.","href":"/development-guide/multipass-in-hydrogen"}]},{"group":"Deployment","root":{"title":"Deployment","href":"/guides/deployment/index"},"directory":"card","pages":[{"title":"Deploy to Shopify Oxygen","description":"Step-by-step guide to securely deploying your Weaverse Hydrogen Project on Shopify Oxygen, with best practices and troubleshooting.","href":"/guides/deployment/oxygen"},{"title":"Custom Domain \u0026 DNS Setup","description":"Connect your custom domain to a Shopify Hydrogen storefront with proper DNS configuration.","href":"/guides/deployment/custom-domain-and-dns"},{"title":"Deploy with Docker","description":"Containerize your Weaverse theme and deploy it to any cloud provider, with a worked Fly.io example","href":"/guides/deployment/docker"},{"title":"Deploy to Cloudflare Workers","description":"Migrate a Weaverse Hydrogen theme from Oxygen to Cloudflare Workers, step by step","href":"/guides/deployment/workers"}]}]},{"dropdown":"Next.js","icon":"https://mintlify.s3.us-west-1.amazonaws.com/weaverse/images/icons/nextjs.svg","groups":[{"group":"Getting started","pages":[{"title":"Weaverse for Next.js","href":"/nextjs/overview"},{"title":"Next.js Quickstart","href":"/nextjs/quickstart"}]},{"group":"Next.js","pages":[{"title":"Rendering Pages in Next.js","href":"/nextjs/rendering-pages"},{"title":"Data Fetching in Next.js","href":"/nextjs/data-fetching"},{"title":"Connect Weaverse Studio","href":"/nextjs/studio"},{"title":"Markets \u0026 Translations","href":"/nextjs/markets-translations"}]},{"group":"Content Management","pages":[{"title":"Global Sections","href":"/features/global-sections"},{"title":"Navigation Configuration","href":"/features/navigation-menus"},{"title":"Third-party Integrations in Next.js","href":"/nextjs/third-party-integrations"},{"title":"Installable Mobile App (PWA)","href":"/features/mobile-app-pwa"}]},{"group":"Deployment","pages":[{"title":"Deploy to Vercel","href":"/guides/deployment/vercel"}]}]}]},{"tab":"SDKs","dropdowns":[{"dropdown":"React Router","icon":"https://mintlify.s3.us-west-1.amazonaws.com/weaverse/images/icons/react-router.svg","groups":[{"group":"Overview","pages":[{"title":"Introduction","sidebarTitle":"Overview","href":"/api-reference/introduction"}]},{"group":"Hooks","pages":[{"title":"useWeaverse","href":"/api-reference/use-weaverse"},{"title":"useItemInstance","href":"/api-reference/use-item-instance"},{"title":"useParentInstance","href":"/api-reference/use-parent-instance"},{"title":"useChildInstances","href":"/api-reference/use-child-instances"},{"title":"useThemeSettings","href":"/api-reference/use-theme-settings"}]},{"group":"Components","pages":[{"title":"WeaverseHydrogenRoot","href":"/api-reference/weaverse-root"},{"title":"WeaverseClient","href":"/api-reference/weaverse-client"},{"title":"withWeaverse","href":"/api-reference/with-weaverse"}]},{"group":"Utilities \u0026 Types","pages":[{"title":"getSelectedProductOptions","href":"/api-reference/get-selected-product-options"},{"title":"IMAGES_PLACEHOLDERS","href":"/api-reference/images-placeholders"},{"title":"Types","href":"/api-reference/types"}]}]},{"dropdown":"Next.js","icon":"https://mintlify.s3.us-west-1.amazonaws.com/weaverse/images/icons/nextjs.svg","groups":[{"group":"Overview","pages":[{"title":"@weaverse/hydrogen/next API Reference","href":"/nextjs/api-reference"}]},{"group":"Hooks","pages":[{"title":"useWeaverse","href":"/nextjs/api/use-weaverse"},{"title":"useItemInstance","href":"/nextjs/api/use-item-instance"},{"title":"useParentInstance","href":"/nextjs/api/use-parent-instance"},{"title":"useChildInstances","href":"/nextjs/api/use-child-instances"},{"title":"useThemeSettings","href":"/nextjs/api/use-theme-settings"}]}]}]},{"tab":"Content API","pages":[{"title":"Content API","href":"/content-api/overview"}]},{"tab":"Ecosystem","pages":[{"title":"Ecosystem","href":"/ecosystem"}]},{"tab":"Help \u0026 Community","pages":[{"title":"Help \u0026 Community","href":"/resources"}]}]}]},"basePath":"","title":"Deployment - Weaverse","buildId":"dpl_AHzSCQPRq6mP9FZXEa5AbDZTffie","deploymentId":"dpl_AHzSCQPRq6mP9FZXEa5AbDZTffie","dynamics":[],"chunks":[]}
