feat: add astro docs

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.”**

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)
+
+:::
+
+<CodemodDisclaimer />
+
+## Installation
+
+Install the Astro integration in your project:
+
+<PackageManagerTabs command="add --dev zephyr-astro-integration" />
+
+:::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()],
+});
+```

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',