Astro
Deploy your Astro Site to Zephyr Cloud
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
<PackageManagerTabs>
<Fragment slot="npm">
```shell
npx with-zephyr@latest
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm dlx with-zephyr@latest
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn dlx with-zephyr@latest
```
</Fragment>
</PackageManagerTabs>
Build and deploy your Astro site:
```shell npm run build ``` ```shell pnpm run build ``` ```shell yarn run build ``` Your application is deployed! Zephyr will provide a deployment URL and comprehensive build analytics.
Manual Installation
<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm install zephyr-astro-integration
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm add zephyr-astro-integration
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn add zephyr-astro-integration
```
</Fragment>
</PackageManagerTabs>
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:
```shell npm run build ``` ```shell pnpm run build ``` ```shell 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