diff --git a/docs/features/tags-environments.mdx b/docs/features/tags-environments.mdx
index 1871959..da2159f 100644
--- a/docs/features/tags-environments.mdx
+++ b/docs/features/tags-environments.mdx
@@ -55,17 +55,19 @@ You can create sophisticated rules by combining conditions. A "stable" tag might
Tag conditions can be **nested**, allowing deeply flexible and expressive logic trees using combinations of `AND` and `OR` groups.
Each condition group can contain:
-- **Individual conditions**, and/or
+
+- **Individual conditions**, and/or
- **Other nested groups** of conditions.
This lets you describe logic such as:
-> **Example:**
-> - `isCI is true`
-> - **AND**
-> - (`branch is main` **OR** `branch is release`)
-> - **AND**
-> - (`user is Zephyr User` **OR** `user is Tech Team`)
+> **Example:**
+>
+> - `isCI is true`
+> - **AND**
+> - (`branch is main` **OR** `branch is release`)
+> - **AND**
+> - (`user is Zephyr User` **OR** `user is Tech Team`)
This rule means:
**“Select CI builds from the main or release branches made by Zephyr User or the Tech team.”**
diff --git a/docs/meta-frameworks/astro.mdx b/docs/meta-frameworks/astro.mdx
new file mode 100644
index 0000000..d589b6b
--- /dev/null
+++ b/docs/meta-frameworks/astro.mdx
@@ -0,0 +1,65 @@
+import { PackageManagerTabs } from '@rspress/core/theme';
+import CodemodDisclaimer from '../../components/codemod-disclaimer.mdx';
+
+# 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.
+
+:::info Prerequisites
+
+- Finished our [Prerequisites](/getting-started/installation) setup guide
+- Installed our [Chrome extension](https://chromewebstore.google.com/detail/zephyr-mission-control/liflhldchhinbaeplljlplhnbkdidedn)
+
+:::
+
+
+
+## Installation
+
+Install the Astro integration in your project:
+
+
+
+:::info 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:
+
+```javascript
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import { withZephyr } from 'zephyr-astro-integration';
+
+export default defineConfig({
+ integrations: [withZephyr()],
+});
+```
+
+:::warning 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:
+
+```javascript
+// 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()],
+});
+```
diff --git a/rspress.config.ts b/rspress.config.ts
index a48950c..c43b31f 100644
--- a/rspress.config.ts
+++ b/rspress.config.ts
@@ -168,6 +168,10 @@ const sidebar: Sidebar = {
text: 'Meta Frameworks',
collapsible: true,
items: [
+ {
+ text: 'Astro',
+ link: '/meta-frameworks/astro',
+ },
{
text: 'Ember.js',
link: '/meta-frameworks/emberjs',