# Zephyr Cloud Docs

> Documentation for Zephyr Cloud

## Guide

- [Introduction](/getting-started/introduction.md): Deploy every build from the bundler you already use, with preview URLs, controlled releases, and instant rollbacks on any cloud. From the team behind Module Federation.
- [Quick Start](/getting-started/quick-start.md): Get up and running with Zephyr Cloud in minutes using our one-line codemod or start fresh with your preferred bundler.
- [Prerequisites](/getting-started/installation.md): Set up your development environment with Node.js, package managers, and the Zephyr Mission Control browser extension.
- [Find the Right SDK](/getting-started/find-your-sdk.md): Choose the right Zephyr SDK for your framework, bundler, or runtime integration.
- [Zephyr API MCP](/tools/api-mcp.md): Connect an AI assistant to Zephyr Cloud to inspect and manage organizations, projects, applications, versions, tags, and environments.
- [Frequently Asked Questions](/getting-started/faq.md): Common questions about Zephyr Cloud and how to get the most out of the platform.
- [Versions](/features/versions.md): Manage application versions and deployments in Zephyr Cloud
- [Version Statuses](/features/version-statuses.md): Track and manage application versions with statuses including Live, Available, Deprecated, Unavailable, Failed, and Rolled back.
- [Tags & Environments](/features/tags-environments.md): Manage application deployments with smart tags and flexible environments in Zephyr Cloud
- [Locking Tags & Environments](/features/locking-tags-environments.md): Prevent unintended changes by locking tags and environments in Zephyr Cloud
- [Instant Rollbacks](/features/instant-rollbacks.md): Quickly revert to previous application versions with zero downtime
- [Environment-Level Overrides](/features/environment-overrides.md): Dynamically control remote dependencies and environment variables per deployment environment
- [Remote Dependencies](/features/remote-dependencies.md): Manage and visualize remote module dependencies across your applications
- [Deployment Hooks](/features/deployment-hooks.md): Zephyr provides hooks to tap into the deployment lifecycle, allowing you to integrate with external services, send notifications, update registries, or perform custom actions after successful deployments.
- [Structured File Logs](/features/file-logging.md): Persist Zephyr build output as structured files for easier debugging, CI archiving, and log ingestion.
- [React Native OTA Updates (Beta)](/features/react-native-ota-updates.md): Ship beta over-the-air updates for React Native Metro Module Federation remotes with Zephyr Cloud.
- [CI Tokens](/features/ci-tokens.md): Authenticate Zephyr deployments from GitHub Actions, GitLab CI/CD, and EAS Build with organization-scoped CI tokens and the ZE_CI_TOKEN environment variable.
- [CI/CD Automation](/features/automation.md): Configure CI/CD automation for Zephyr Cloud using CI tokens with GitHub Actions and GitLab CI/CD pipelines
- [Migrate deployment auth to CI tokens](/migrations/ci-token-migration.md): Replace ZE_SERVER_TOKEN, ZE_USER_EMAIL, and ZE_SECRET_TOKEN deployment authentication with organization-scoped CI tokens using ZE_CI_TOKEN.
- [Personal token deployments](/features/ci-cd-personal-token.md): Personal tokens work today. Using them for CI deployments is planned for deprecation, and CI tokens are recommended instead.
- [Server token deployments](/features/ci-cd-server-token.md): Server tokens work today for CI deployments. Using them for deployments is planned for deprecation, and CI tokens are recommended instead.
- [Organization Structure](/features/organization-structure.md): Understand how Zephyr Cloud organizes your deployments with organizations, projects, and applications
- [Teams & Members](/features/teams-members.md): Collaborate with team members and manage organization access
- [Subscriptions](/features/subscriptions.md): Manage your Zephyr Cloud subscription plans and billing
- [Multi-Organization Subscriptions](/features/multi-organization-subscriptions.md): Link child organizations to an Enterprise subscription so multiple organizations can share billing, quotas, and seats
- [create-zephyr-apps](/tools/create-zephyr-apps.md): Scaffold new applications with Zephyr integration
- [Zephyr Codemod](/tools/zephyr-codemod.md): Automatically integrate Zephyr plugins into your existing bundler configurations
- [Zephyr Chrome Extension](/tools/browser-extension.md): Streamline your development workflow with deployment management and live preview capabilities
- [Zephyr Devtools](/tools/browser-devtools.md): Advanced debugging and performance analysis for your micro-frontend applications
- [Module Federation Devtools](/tools/module-federation-devtools.md): Debug and inspect your micro-frontend applications with browser extensions
- [Versioning, Tags and Environments](/features/versioning-tags.md): Manage application versions with Zephyr Cloud using semantic versioning, automated tags, and environment-based deployments

## Tutorials

- [Get started](/tutorials/first-app.md)
- [Create module federation app](/tutorials/create-mf-app.md): Zephyr Cloud Documentation - Creating a basic module federation app and deploy it through Zephyr.
- [Micro-Frontends with Zephyr - The Complete Guide](/tutorials/mf-guide.md): Learn how to configure, build, and deploy Micro-Frontends with Module Federation using Zephyr Cloud. This complete guide covers configuration setup, dependency resolution, circular dependency management, and deployment best practices.
- [Rsbuild + React Module Federation Monorepo](/tutorials/rsbuild-react-mf-monorepo.md): Build, deploy, diagnose, and browser-verify a pnpm monorepo with an Rsbuild host, two React remotes, Module Federation, and Zephyr Cloud.
- [React Native, Metro and Module Federation](/tutorials/metro.md): This guide will explain how to build a React Native app with Metro bundler that uses Module Federation to share code between apps. This approach enables you to create micro-frontend architectures in React Native applications, allowing teams to develop, deploy, and scale mini-applications independently.
- [End to End Testing](/tutorials/e2e-testing.md): Learn how to implement end-to-end testing for both basic and federated applications using Zephyr. This tutorial covers extracting deployment URLs from CI builds, testing federated remotes with session storage overrides, and testing in production environments.

## Reference

- [Declarative Configuration](/reference/declarative-configuration.md): Configure Zephyr application identity, remote dependencies, and dependency URL behavior with zephyr.config files.
- [Architecture](/reference/architecture.md): Zephyr is a distributed edge deployment platform that integrates directly with JavaScript build tools including but not limited to rspack, webpack, rollup, rolldown, vite, parcel and repack - to provide instant deployment and global distribution of web applications. This document details the technical architecture, design decisions, and implementation strategies that enable sub-second deployments and millisecond-latency serving. The platform achieves its performance characteristics through a combination of compile-time integration, intelligent asset processing, and a globally distributed edge network. By intercepting the build process at the bundler level, Zephyr can analyze, optimize, and deploy applications without modifying the build output or requiring changes to existing workflows.
- [Why Zephyr Cloud](/reference/why-zephyr-cloud.md): Learn why Zephyr Cloud is purpose-built for Micro-Frontends with instant versioning, rollbacks, and simplified deployment for enterprise teams.
- [SSR Worker (beta)](/reference/ssr-worker.md): Zephyr SSR Worker runtime for server-rendered deployments. Currently beta and Cloudflare-only on Zephyr's default integration.
- [Allow IP Addresses](/reference/allow-ip-addresses.md): Configure your origin server to allow Zephyr Cloud IP addresses for BYOC deployments and private network setups.
- [Additional Resources](/reference/resources.md): Explore curated video tutorials, articles, podcasts, and community resources for Module Federation and micro-frontend development.
- [Error Encyclopedia](/errors.md): Comprehensive reference of build, deploy, and browser errors you may encounter while using Zephyr Cloud.
- [ZE10010: Unable to locate package.json](/errors/ze10010.md): ZE10010: Unable to locate package.json file in project directory
- [ZE10011: Invalid JSON in package.json](/errors/ze10011.md): ZE10011: package.json file is not in valid JSON format
- [ZE10013: Missing name or version in package.json](/errors/ze10013.md): ZE10013: Missing required name or version fields in package.json
- [ZE10014: Git remote origin not configured](/errors/ze10014.md): ZE10014: Git remote origin URL is not configured for the project
- [ZE10015: Git username or email not configured](/errors/ze10015.md): ZE10015: Git username or email is not configured
- [ZE10016: Missing Git information](/errors/ze10016.md): ZE10016: Stable Git branch, commit, identity, or remote information is unavailable
- [ZE10017: Local configuration not found](/errors/ze10017.md): ZE10017: Local configuration does not exist for application_uid
- [ZE10018: Authentication error](/errors/ze10018.md): ZE10018: Zephyr authentication is missing, invalid, or expired
- [ZE10019: Failed to obtain build ID](/errors/ze10019.md): ZE10019: Build ID creation failed; inspect the reported reason for recovery
- [ZE10022: Target access forbidden](/errors/ze10022.md): ZE10022: The authenticated account cannot access the requested target
- [ZE10023: Invalid Module Federation config](/errors/ze10023.md): ZE10023: Invalid Module Federation configuration detected
- [ZE10024: Invalid app ID](/errors/ze10024.md): ZE10024: The provided application ID is invalid
- [ZE10032: JWT invalid](/errors/ze10032.md): ZE10032: The JSON Web Token is invalid or expired
- [ZE20010: Asset upload failed](/errors/ze20010.md): ZE20010: Asset for remote module failed to upload during deployment
- [ZE20011: URL doesn't exist](/errors/ze20011.md): ZE20011: URL doesn't exist - mistyped project_uid or path
- [ZE20012: Failed to provide valid application_uid](/errors/ze20012.md): ZE20012: Failed to provide valid application_uid when getting asset list
- [ZE20013: Failed to provide valid upload params](/errors/ze20013.md): ZE20013: Failed to provide valid params when uploading file
- [ZE20014: Failed to load application configuration](/errors/ze20014.md): ZE20014: Zephyr could not load the application configuration during deployment
- [ZE20017: Error not yet documented](/errors/ze20017.md): ZE20017: Error code not yet documented
- [ZE20019: Error not yet documented](/errors/ze20019.md): ZE20019: Error code not yet documented
- [ZE20020: Unable to connect to cloud provider](/errors/ze20020.md): ZE20020: Unable to connect to cloud provider (Cloudflare or Fastly)
- [ZE20022: Error not yet documented](/errors/ze20022.md): ZE20022: Error code not yet documented
- [ZE20023: Error not yet documented](/errors/ze20023.md): ZE20023: Error code not yet documented
- [ZE20024: Error not yet documented](/errors/ze20024.md): ZE20024: Error code not yet documented
- [ZE20037: Max payload size exceeded](/errors/ze20037.md): ZE20037: The deployment payload exceeds the maximum allowed size
- [ZE30026: Error not yet documented](/errors/ze30026.md): ZE30026: Error code not yet documented
- [ZE40001: Resolve remotes error](/errors/ze40001.md): ZE40001: Failed to resolve remote module configurations
- [ZE40003: Cannot resolve app name with version](/errors/ze40003.md): ZE40003: Failed to resolve application name with the specified version
- [ZE40005: MF config missing filename](/errors/ze40005.md): ZE40005: Module Federation configuration is missing the filename field
- [ZE40006: Missing platform](/errors/ze40006.md): ZE40006: Platform configuration is missing
- [ZE40035: HTTP error](/errors/ze40035.md): ZE40035: An HTTP error occurred during configuration operations
- [ZE00000: Unknown error](/errors/ze00000.md): ZE00000: Unknown error occurred during Zephyr operation
- [Core Concepts](/reference/concepts.md): Understanding fundamental concepts of Micro-Frontends, Module Federation, and Zephyr Cloud's edge deployment architecture.
- [Zephyr Cloud - Common Questions](/reference/faq.md): Zephyr Cloud Documentation - Common questions

## Other

- [Metro (React Native)](/bundlers/metro.md): Deploy React Native applications to Zephyr Cloud with Metro bundler and Module Federation support.
- [Parcel](/bundlers/parcel.md): Deploy Parcel applications to Zephyr Cloud with zero-configuration bundling and seamless integration.
- [Re.Pack (React Native)](/bundlers/repack.md): Deploy React Native applications to Zephyr Cloud with Re.Pack and cross-platform Module Federation.
- [Rolldown](/bundlers/rolldown.md): Deploy Rolldown applications to Zephyr Cloud with blazing-fast Rust-powered next-generation bundling.
- [Rollup](/bundlers/rollup.md): Deploy Rollup applications to Zephyr Cloud with optimized bundling and Module Federation support.
- [Rsbuild](/bundlers/rsbuild.md): Deploy Rsbuild applications to Zephyr Cloud with lightning-fast builds and Module Federation support.
- [Rspack](/bundlers/rspack.md): Deploy Rspack applications to Zephyr Cloud with blazing-fast Rust-based bundling and Module Federation.
- [Vite](/bundlers/vite.md): Deploy Vite applications to Zephyr Cloud with lightning-fast builds and Module Federation support.
- [Webpack](/bundlers/webpack.md): Deploy Webpack applications to Zephyr Cloud with full Module Federation support and optimized edge delivery.
- [Manage Cloud Providers](/cloud.md): With Zephyr's bring your own cloud feature, you can use Zephyr with your existing cloud infrastructure to manage your applications
- [Configure Akamai on Zephyr](/cloud/akamai.md): Configuring Akamai as your deployment integration provider on Zephyr
- [Configure AWS on Zephyr](/cloud/aws.md): Configuring AWS as your deployment integration provider on Zephyr
- [Configure Cloudflare on Zephyr](/cloud/cloudflare.md): Configuring Cloudflare as your deployment integration provider on Zephyr
- [Configure Fastly on Zephyr](/cloud/fastly.md): Configuring Fastly as your deployment integration provider on Zephyr
- [Kubernetes Deployment](/cloud/kubernetes.md): Configuration reference for Zephyr Kubernetes edge worker deployment
- [Updating Deployment Integrations](/cloud/updating-integrations.md): Step-by-step guide to update your deployment integrations and keep them current
- [Add Zephyr to an existing application](/integrations/existing-app.md): Zephyr Cloud Documentation - How to add Zephyr to existing application, using React, webpack and Nx as an example
- [React Native, Re.Pack and Module Federations](/integrations/react-native-repack.md): Learn how to build React Native apps with Re.Pack and Module Federation, enabling code sharing between apps with Zephyr Cloud integration.
- [React + Rsbuild](/integrations/react-rsbuild.md): Zephyr Cloud Documentation - React with Rsbuild guide
- [React + Rspack + Nx](/integrations/react-rspack-nx.md): Zephyr Cloud Documentation - Get started guide
- [React + Vite](/integrations/react-vite.md): Create and deploy a React app using Vite for bundling with the Zephyr plugin. Quick setup guide with step-by-step configuration.
- [Vite + Webpack + Rspack with Module Federation](/integrations/vite-rspack-webpack-mf.md): Deploy Micro-Frontend applications using Module Federation with Vite, Webpack, and Rspack. Complete guide to configuring host and remote apps with Zephyr.
- [Learning](/learning.md): Learning resources and tutorials for Zephyr Cloud deployment platform.
- [Astro](/meta-frameworks/astro.md): Deploy your Astro static sites to Zephyr Cloud with seamless integration. Learn how to configure the Astro integration for lightning-fast content-first websites.
- [Ember.js](/meta-frameworks/emberjs.md): Deploy your Ember.js applications to Zephyr Cloud using Vite and Embroider. Combine Ember's powerful conventions with Vite's fast build system and Zephyr's deployment capabilities.
- [Modern.js](/meta-frameworks/modernjs.md): Deploy your Modern.js applications to Zephyr Cloud with built-in Rspack integration. Build full-stack applications with performance-first architecture and convention-based development.
- [Nitro](/meta-frameworks/nitro.md): Deploy Nitro v3 applications to Zephyr using Nitro's built-in Zephyr deploy target. Configure Nitro once, then build and upload directly to Zephyr.
- [Nuxt](/meta-frameworks/nuxt.md): Deploy Nuxt applications to Zephyr with zephyr-nuxt-module. Upload Nitro build output during nuxt build, with SSR entrypoint detection and optional Zephyr overrides.
- [Rslib](/meta-frameworks/rslib.md): Deploy your JavaScript/TypeScript libraries to Zephyr Cloud using Rslib. Build fast, flexible libraries with excellent TypeScript support and multiple output formats powered by Rsbuild.
- [Rspress](/meta-frameworks/rspress.md): Deploy your Rspress documentation sites to Zephyr Cloud with lightning-fast builds powered by Rspack. Create React-based static documentation sites with seamless Markdown content.
- [TanStack Start](/meta-frameworks/tanstack-start.md): Deploy TanStack Start (Cloudflare template) to Zephyr by adding the Zephyr TanStack Start Vite plugin.
- [Recipes](/recipes.md): Step-by-step recipes and guides for integrating Zephyr Cloud with various frameworks and tools.
- [Features](/usage.md): Core features of Zephyr Cloud including build integration, deployment workflow, preview versions, and dependency management.