Zephyr Cloud Docs
Zephyr Cloud →

Astro

Deploy your Astro applications to Zephyr Cloud with seamless integration. Astro is a modern web framework that delivers lightning-fast performance with a content-first architecture, perfect for building blogs, marketing sites, documentation, and more.

Prerequisites
Quick Setup with Codemod
npm
yarn
pnpm
bun
npx with-zephyr

This detects your bundler and configures Zephyr automatically. Learn more →

For manual setup, continue below.

Installation

Install the Astro integration in your project:

npm
yarn
pnpm
bun
npm add --dev zephyr-astro-integration
Version Requirement

Astro integration requires zephyr-astro-integration version 0.1.0 or higher. Make sure you have the latest version installed.

Configuration

Add the Zephyr integration to your Astro configuration:

// astro.config.mjs import { defineConfig } from 'astro/config'; import { withZephyr } from 'zephyr-astro-integration';  export default defineConfig({  integrations: [withZephyr()], });
Static Sites Only

Zephyr currently supports Astro's static site generation (SSG) mode only. Server-side rendering (SSR) and hybrid modes are not supported at this time. Ensure your output is set to 'static' (default) in your Astro configuration.

Working with Other Integrations

Astro's integration system allows you to combine Zephyr with other integrations seamlessly:

// astro.config.mjs import mdx from '@astrojs/mdx'; import sitemap from '@astrojs/sitemap'; import { defineConfig } from 'astro/config'; import { withZephyr } from 'zephyr-astro-integration';  export default defineConfig({  site: 'https://example.com',  output: 'static', // Required: Zephyr only supports static mode  integrations: [mdx(), sitemap(), withZephyr()], });