Deploy your Astro Site to Zephyr Cloud

You can use Zephyr Cloud to deploy an Astro site with intelligent asset management, comprehensive build analytics, and first-class support for Module Federation architectures.

Zephyr operates on a Bring Your Own Cloud (BYOC) model, deploy to your choice of supported clouds through a unified interface without vendor lock-in. Switch providers anytime without changing your deployment workflow.

How to deploy

Automatic Installation

Add the Zephyr integration to your Astro project with the following command. This will install the integration and update your astro.config.mjs file automatically:
- npm
- pnpm
- Yarn
Окно терминала
npx with-zephyr@latest
Окно терминала
pnpm dlx with-zephyr@latest
Окно терминала
yarn dlx with-zephyr@latest
Build and deploy your Astro site:
- npm
- pnpm
- Yarn
Окно терминала
npm run build
Окно терминала
pnpm run build
Окно терминала
yarn run build
Your application is deployed! Zephyr will provide a deployment URL and comprehensive build analytics.

Manual Installation

Install the Zephyr Astro integration:
- npm
- pnpm
- Yarn
Окно терминала
npm install zephyr-astro-integration
Окно терминала
pnpm add zephyr-astro-integration
Окно терминала
yarn add zephyr-astro-integration

Add the integration to your astro.config.mjs:

import { defineConfig } from 'astro/config';
import { withZephyr } from 'zephyr-astro-integration';

export default defineConfig({
  integrations: [
    withZephyr(),
  ],
});

Build and deploy your Astro site:
- npm
- pnpm
- Yarn
Окно терминала
npm run build
Окно терминала
pnpm run build
Окно терминала
yarn run build
Your application is deployed! Zephyr will provide a deployment URL and comprehensive build analytics.

More details

For more detailed information refer to the Zephyr Cloud documentation on deploying with Astro.

What happens during deployment

When you build your Astro site with the Zephyr integration, the following process occurs:

Build Context Extraction: Zephyr captures Git information (commit, branch, author) and package metadata
Asset Hashing: All build outputs are hashed using SHA-256 for content-addressable storage
Delta Detection: Zephyr queries the CDN edge to identify which assets already exist
Optimized Upload: Only new or modified assets are uploaded
Snapshot Creation: An immutable deployment snapshot is created with all asset references
Analytics Upload: Build statistics, module graphs, and dependency information are sent to the dashboard
CDN Deployment: Assets are published to your configured CDN with permanent cache headers