> ## Documentation Index
> Fetch the complete documentation index at: https://weaverse.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

# Deployment

> Deploy your Weaverse Hydrogen storefront to Shopify Oxygen, Docker, Cloudflare Workers, and other platforms.

# Deployment

Ready to take your Weaverse Hydrogen project live? This guide covers deploying your storefront to various hosting platforms with production-ready configurations.

## Deployment Options

### Recommended: Shopify Oxygen

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
* **Enterprise Support**: Production-grade reliability

👉 **[Deploy to Oxygen](https://weaverse.io/docs/guides/deployment/oxygen.md)** - Complete step-by-step guide

### Alternative: Docker Deployment

Deploy to any cloud provider using containerized deployment.

**Best for**: Custom infrastructure, hybrid setups, specific compliance requirements

* **Platform Flexibility**: Works on AWS, Google Cloud, Azure, Digital Ocean
* **Custom Configuration**: Full control over server setup
* **Scalable Architecture**: Container orchestration support
* **Development Consistency**: Same environment from dev to production

👉 **[Docker Deployment Guide](https://weaverse.io/docs/guides/deployment/docker.md)** - Containerized deployment setup

## Quick Start

### For Most Projects (Recommended)

1. **[Deploy to Shopify Oxygen](https://weaverse.io/docs/guides/deployment/oxygen.md)** - Official platform with zero configuration
2. **Set environment variables** - Add your Weaverse Project ID and store configuration
3. **Connect GitHub** - Automatic deployments on code changes
4. **Go live** - Your storefront is ready for customers

### For Custom Infrastructure

1. **[Use Docker deployment](https://weaverse.io/docs/guides/deployment/docker.md)** - Containerized setup for any cloud provider
2. **Configure hosting** - Set up your preferred cloud platform
3. **Set up CI/CD** - Automated deployment pipeline
4. **Monitor and scale** - Production monitoring setup

## Production Checklist

Before deploying to production:

* **Environment Variables**: All required variables configured
* **Store Connection**: Shopify store properly connected
* **Weaverse Project**: Project ID configured and Studio preview working
* **Performance**: Site loads fast and Core Web Vitals are green
* **Testing**: All features tested in staging environment
* **SEO**: Meta tags, sitemap, and structured data configured
* **Analytics**: Tracking and monitoring setup
* **Security**: SSL certificate and security headers configured

## Next Steps

* **[Environment Setup](https://weaverse.io/docs/development-guide/environment-setup.md)** - Configure your development environment
* **[Performance Optimization](https://weaverse.io/docs/features/page-seo.md)** - Optimize your storefront for speed
* **[SEO Best Practices](https://weaverse.io/docs/features/page-seo.md)** - Search engine optimization guide

## Need Help?

* **[Community Support](https://weaverse.io/docs/community/community.md)** - Get help from the Weaverse community
* **[Documentation](https://weaverse.io/docs/intro/quickstart.md)** - Complete development guides
* **[Studio Support](https://studio.weaverse.io/dashboard)** - Access Studio help resources


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.