rsc-universal 0.1.1

package/skills/astro/SKILL.md

@@ -0,0 +1,275 @@
+---
+name: astro
+description: "Use when building a content-driven or marketing site with Astro 6 — static-first pages, islands, content collections, partial hydration, server islands, per-route on-demand rendering, and deploy adapters. Triggers: 'Astro blog with content collections', 'make this widget interactive only when it scrolls into view', 'server island to personalize a static page', 'migrate Astro 5 to 6', the non-obvious 'ship zero JS but keep one form interactive', and Catalan/Spanish 'web de marketing rápida con Astro' / 'una web de contingut amb Astro'. NOT app-router React or server actions (that is nextjs)."
+tags: [astro, ssg, islands, content-collections, partial-hydration, marketing-site, frameworks]
+recommends: [landing-copy, seo-geo, vercel, cloudflare, netlify]
+origin: risco
+---
+
+# Astro 6 — static-first sites, islands, content collections
+
+> Build fast content and marketing sites with Astro 6: ship zero client JS by default, hydrate the
+> smallest possible surface, model content with type-safe collections, deploy static or hybrid.
+
+## The prime directive
+
+**Ship zero client JavaScript by default. Hydrate the smallest possible surface, as late as you can
+get away with.** Every island is a JS bundle the visitor downloads, parses, and executes — marketing
+and content sites win on TTFB/LCP and Lighthouse, not on React-everywhere. An `.astro` component
+renders to HTML at build time and ships *no* runtime. Only reach for an interactive island when a
+piece of UI genuinely needs client state, effects, or event handlers.
+
+If you find yourself adding `client:load` to make a page "work," stop — the page already works; you
+are adding interactivity, and interactivity is the expensive exception, not the default.
+
+## First: detect the project version
+
+Astro 6.0 is stable (released 2026-03-10); the Astro 5 line is still production-ready. Do not mix
+advice across majors. Every v6-only claim below is sourced to the official release post or the
+upgrade guide — cited inline so you can re-check before acting.
+
+1. Read `package.json` → the `astro` version.
+2. Astro 6 **requires Node `22.12.0` or higher** (Node 18 and 20 are dropped) — verbatim floor from
+   the [upgrade-to-v6 guide](https://docs.astro.build/en/guides/upgrade-to/v6/). Check the runtime.
+3. v6 content config lives at `src/content.config.ts`. The legacy `src/content/config.ts` path is
+   **removed**, not merely discouraged: the v6 upgrade guide instructs you to "Rename and move this
+   file to `src/content.config.ts`," and the old auto-detection (with the `legacy.collections` flag)
+   is gone. A temporary `legacy.collectionsBackwardsCompat` escape hatch exists but is a migration
+   crutch, not a supported layout.
+4. v6 ships **Vite 7** (Vite v7.0), **Zod 4** for content schemas (imported from `astro/zod`, **not**
+   `astro:content` — see Content collections below), and makes **Live Content Collections**, the
+   **Fonts API**, and the **CSP API** stable. Sources: [Astro 6.0 release post,
+   2026-03-10](https://astro.build/blog/astro-6/) and the
+   [upgrade-to-v6 guide](https://docs.astro.build/en/guides/upgrade-to/v6/). (v6 also ships an
+   *experimental* Rust compiler succeeding the Go one — experimental, so do not rely on or configure
+   it in production advice.)
+
+## Decision table — what kind of thing is this?
+
+Pick the cheapest row that satisfies the requirement. Read top-down; stop at the first match.
+
+| Need                                                   | Use                                      | Why                                                        |
+| ------------------------------------------------------ | ---------------------------------------- | ---------------------------------------------------------- |
+| Pure content, no interactivity                         | `.astro` component, static               | Renders to HTML at build, ships **0 KB** JS                |
+| One small interactive widget                           | UI-framework component + `client:*`      | Hydrate just that island; the rest stays static            |
+| Per-request personalization on a mostly-static page    | server island (`server:defer`)           | Static CDN page + one deferred fragment, no full SSR       |
+| Whole route needs request data on every load           | `export const prerender = false` + adapter | Opt that one route into on-demand rendering              |
+| Many static routes generated from data                 | `getStaticPaths()`                       | Build-time fan-out, still fully static                     |
+
+## Rendering model
+
+Default: **every page is prerendered to static HTML** at build time. You opt *into* dynamism per
+route — never the other way around.
+
+```astro
+---
+// src/pages/dashboard.astro — opt this ONE route into on-demand (SSR) rendering.
+// Requires a configured adapter (Vercel/Netlify/Cloudflare/Node). Everything else stays static.
+export const prerender = false;
+const user = await getUser(Astro.request); // runs per request
+---
+<h1>Hello {user.name}</h1>
+```
+
+```astro
+---
+// src/pages/blog/[slug].astro — many STATIC routes generated from data at build time.
+import { getCollection } from "astro:content";
+
+export async function getStaticPaths() {
+  const posts = await getCollection("blog");
+  return posts.map((post) => ({ params: { slug: post.id }, props: { post } }));
+}
+const { post } = Astro.props;
+---
+<h1>{post.data.title}</h1>
+```
+
+In Astro 6 the dev server runs the **production runtime** (Vite 7 Environment API), so dev no longer
+diverges from prod on Cloudflare/Bun/Deno — fewer "works in dev, breaks on deploy" surprises. Adapter
+choice per platform → `references/deploy-and-integrations.md`.
+
+## Islands & client directives
+
+A `client:*` directive turns a framework component into a hydrated island. Choose the **latest**
+directive that still feels instant to the user — never default to `client:load`.
+
+| Directive               | Hydrates when                       | Use for                                              |
+| ----------------------- | ----------------------------------- | ---------------------------------------------------- |
+| `client:load`           | Immediately on page load            | Above-the-fold, must-be-interactive-now controls     |
+| `client:idle`           | On `requestIdleCallback`            | Important but not first-paint-critical widgets       |
+| `client:visible`        | When it scrolls into view (IO)      | Below-the-fold carousels, comment boxes, maps        |
+| `client:media={query}`  | When a media query matches          | Mobile-only menu, desktop-only panel                 |
+| `client:only="react"`   | Client-only, **no SSR HTML**        | Components that crash during SSR (browser-only deps)  |
+
+```astro
+---
+import Carousel from "../components/Carousel.tsx";
+---
+<!-- Bad: a below-the-fold carousel paying for JS at first paint -->
+<Carousel client:load />
+
+<!-- Good: defer its bundle until the user actually scrolls to it -->
+<Carousel client:visible />
+```
+
+`client:only` gotcha: it **skips SSR entirely**, so the component produces no server HTML (expect a
+flash/layout shift) and you **must** name the framework (`client:only="react"`) — Astro can't infer
+it without the server render. Reach for it only when SSR genuinely breaks; otherwise prefer
+`client:visible`.
+
+## Content collections (Content Layer)
+
+Type-safe content lives in a single config file. The path is load-bearing:
+
+```typescript
+// src/content.config.ts  ← v6 path. NOT src/content/config.ts (legacy path removed in v6)
+import { defineCollection } from "astro:content";
+import { z } from "astro/zod"; // v6: z moved OUT of astro:content into astro/zod (Zod 4)
+import { glob } from "astro/loaders";
+
+const blog = defineCollection({
+  // glob() sources files from anywhere; `id` comes from the filename minus extension
+  loader: glob({ pattern: "**/*.{md,mdx}", base: "./src/data/blog" }),
+  schema: z.object({
+    title: z.string(),
+    pubDate: z.coerce.date(),
+    draft: z.boolean().default(false),
+    tags: z.array(z.string()).default([]),
+  }),
+});
+
+export const collections = { blog };
+```
+
+Query and render in a page. `render()` is now a standalone call (not `entry.render()`):
+
+```astro
+---
+// src/pages/blog/[slug].astro
+import { getCollection, getEntry, render } from "astro:content";
+
+export async function getStaticPaths() {
+  const posts = await getCollection("blog", ({ data }) => !data.draft);
+  return posts.map((post) => ({ params: { slug: post.id }, props: { post } }));
+}
+const { post } = Astro.props;
+const { Content } = await render(post);
+---
+<article><h1>{post.data.title}</h1><Content /></article>
+```
+
+Built-in loaders are `glob()` (many files) and `file()` (one JSON/YAML array). Custom and CMS
+loaders, collection references, Live Content Collections (real-time data with no rebuild, stable in
+v6), and MDX details → `references/content-layer.md`.
+
+## Server islands
+
+When most of a page is static and CDN-cacheable but **one fragment** is per-visitor, use a server
+island instead of turning the whole route into SSR. The page ships static; the island is fetched
+and rendered after first paint.
+
+```astro
+---
+// src/components/UserGreeting.astro — rendered on demand, deferred after the static shell
+const user = await getUserFromCookie(Astro.request);
+---
+<span>Welcome back, {user.name}</span>
+```
+
+```astro
+---
+import UserGreeting from "../components/UserGreeting.astro";
+---
+<header>
+  <!-- static page, one deferred personalized fragment with a placeholder while it loads -->
+  <UserGreeting server:defer>
+    <span slot="fallback">Welcome</span>
+  </UserGreeting>
+</header>
+```
+
+This beats full SSR when: the page is otherwise cacheable on a CDN, and only a small slice depends on
+the request. You keep static LCP and personalize without making every request hit the origin.
+
+## Integrations & setup
+
+Use `astro add` so it patches `astro.config.mjs` and installs peers in one step:
+
+```bash
+npx astro add react mdx sitemap
+```
+
+- **Tailwind 4** wires through the official **Vite plugin** (`@tailwindcss/vite`), not the legacy
+  `@astrojs/tailwind` integration (that path was for Tailwind 3).
+- **Fonts API** (stable in v6 per the [Astro 6.0 release post,
+  2026-03-10](https://astro.build/blog/astro-6/)) self-hosts and optimizes fonts from
+  `astro.config.mjs` — no manual `@font-face`.
+- **CSP API** (stable in v6, same release) emits a Content-Security-Policy with hashes for your
+  inline scripts/styles.
+
+Adapter recipes, env handling, and SSR endpoints (`src/pages/api/*.ts`) →
+`references/deploy-and-integrations.md`.
+
+## Performance rules
+
+- Images: always `<Image>`/`<Picture>` from `astro:assets` — automatic width/height, format, and
+  lazy-loading kill CLS and over-sized payloads. Never a raw `<img>` for local assets.
+- Never global-hydrate: there is no "make the page interactive" switch; hydrate per island.
+- View transitions: add `<ClientRouter />` from `astro:transitions` to the `<head>` for SPA-like
+  navigation without an SPA. Prefetch links with the `prefetch` config/attribute.
+
+## Astro 5 → 6 migration checklist
+
+Run the codemod first, then verify each item:
+
+```bash
+npx @astrojs/upgrade
+```
+
+- [ ] Node runtime is **`22.12.0`+** (CI image, local, deploy target).
+- [ ] Dependencies on **Vite 7** (Vite v7.0; custom Vite plugins/config may need updates).
+- [ ] Schema `z` import moved: **`import { z } from "astro/zod"`** — `z` and `astro:schema` are gone
+      from `astro:content`. Then review for **Zod 4** breaking changes.
+- [ ] Content config renamed to **`src/content.config.ts`** (delete `src/content/config.ts`; the
+      legacy path is removed, not just deprecated).
+- [ ] Full guide (dated 2026): `docs.astro.build/en/guides/upgrade-to/v6`.
+
+## Anti-patterns → STOP
+
+| Rationalization                                          | Reality / STOP                                                              |
+| -------------------------------------------------------- | --------------------------------------------------------------------------- |
+| "Add `client:load` so the page works"                    | An `.astro` page already works statically; you're shipping JS for nothing   |
+| "`client:load` everywhere, simplest"                     | Pick `client:visible`/`idle`/`media`; first-paint JS is the LCP killer       |
+| "Make the whole route SSR to personalize the header"     | Use a server island (`server:defer`); keep the page static & CDN-cached     |
+| "`src/content/config.ts` worked before, keep it"         | v6 removed that path (LegacyContentConfigError) — must be `src/content.config.ts` |
+| "`fetch()` the CMS inside the `.astro` frontmatter"      | Write a content-collection loader so content is typed, cached, and queryable |
+| "Pull in React just to render this static markup"        | Static markup is an `.astro` component — 0 KB, no framework runtime          |
+| "Skip the Zod schema, content is just frontmatter"       | Untyped content = silent build-time drift; the schema is the contract        |
+| "`client:only` without the framework name"               | It can't infer the framework with no SSR — must be `client:only="react"`     |
+| "Use the old `@astrojs/tailwind` for Tailwind 4"         | Tailwind 4 wires through `@tailwindcss/vite`; the old integration is v3-era  |
+
+## Verify
+
+Run `bash scripts/verify.sh` from the Astro project root. It is grep-based and needs no install: it
+**FAILS** if a v6 project still has `src/content/config.ts` instead of `src/content.config.ts`,
+**WARNS** on over-hydration smells (many `client:load`, or `client:only` with no framework string),
+**CHECKS** that content schemas import from `astro:content`, and — only if the `astro` binary
+resolves — optionally runs `npx astro check`. On an empty or clean tree it prints OK and exits 0;
+warnings are advisory and never fail the run.
+
+## References
+
+- `references/content-layer.md` — loaders (`glob`/`file`/custom/CMS), Zod 4 schema patterns,
+  collection references, Live Content Collections, querying & rendering, MDX.
+- `references/deploy-and-integrations.md` — adapter table per platform, hybrid rendering, SSR
+  endpoints, env handling, `astro add` recipes, Fonts API & CSP API config.
+
+## See Also
+
+- `../nextjs/SKILL.md` — when the project is really an app-router React app with server actions and
+  heavy client interactivity, not a content/marketing site.
+- `../landing-copy/SKILL.md` and `../seo-geo/SKILL.md` — this skill builds the site; those write the
+  copy and decide the SEO/structured-data strategy that fills it.
+- `../vercel/SKILL.md`, `../netlify/SKILL.md`, `../cloudflare/SKILL.md` — platform mechanics (DNS,
+  env, build settings) once the code and adapter are ready.

package/skills/astro/evals/README.md

@@ -0,0 +1,3 @@
+# astro evals
+
+Trigger and capability checks for Astro content and marketing sites.

package/skills/astro/evals/cases.yaml

@@ -0,0 +1,41 @@
+skill: astro
+
+should_trigger:
+  - prompt: "Build an Astro blog with content collections."
+    why: "Astro content collections and static-first pages are core to the skill."
+  - prompt: "Make this widget hydrate only when it scrolls into view in Astro."
+    why: "Partial hydration/client directives are Astro-specific."
+  - prompt: "Use a server island to personalize a static Astro page."
+    why: "Server islands and static-plus-dynamic composition belong here."
+  - prompt: "Migrate this project from Astro 5 to Astro 6."
+    why: "Astro version migration and v6 content config are skill-specific."
+  - prompt: "Quiero una web de marketing rapida con Astro y cero JS innecesario."
+    why: "Spanish marketing site with Astro and zero-JS directive triggers this skill."
+
+should_not_trigger:
+  - prompt: "Implement a Next.js server action with App Router."
+    route_to: "nextjs"
+    why: "Next.js RSC/App Router is not Astro."
+  - prompt: "Write conversion copy for this landing page."
+    route_to: "landing-copy"
+    why: "Copywriting belongs to landing-copy; Astro may implement it later."
+  - prompt: "Configure Cloudflare DNS and workers."
+    route_to: "cloudflare"
+    why: "Platform configuration is the Cloudflare skill."
+  - prompt: "Design the visual system for this marketing page."
+    route_to: "design"
+    why: "Visual design belongs to design."
+  - prompt: "Write the hooks and state logic for this React island."
+    route_to: "react"
+    why: "The component-internals (hooks/state) of a React island are React's job; Astro only decides whether and how the island hydrates (client:* directive), not its internal logic — the closest near-miss sibling."
+
+capability:
+  - scenario: "A user wants an Astro 6 marketing site with a static blog, one interactive pricing calculator, and per-request personalization."
+    must_include:
+      - "Keeps the default static/zero-client-JS model and hydrates only the calculator island."
+      - "Chooses the appropriate client directive such as client:visible/client:idle instead of client:load by habit."
+      - "Uses content collections for typed blog/content data."
+      - "Uses server islands or per-route on-demand rendering only for request-specific personalization."
+      - "Checks Astro major version and Node/runtime requirements before giving migration advice."
+      - "Routes copy, SEO, deploy-platform details to their matching skills when needed."
+      - "Explains that interactivity is the exception, not the default."

package/skills/astro/references/content-layer.md

@@ -0,0 +1,118 @@
+# Content Layer — loaders, schemas, querying
+
+The Content Layer (stable since Astro 5.0) sources content from anywhere through **loaders** and
+gives you type-safe, queryable collections. Config lives in `src/content.config.ts` (v6 path; the
+legacy `src/content/config.ts` location is removed in v6, per the
+[upgrade-to-v6 guide](https://docs.astro.build/en/guides/upgrade-to/v6/)).
+
+## defineCollection: loader + schema
+
+A collection is `defineCollection({ loader, schema })`. The loader produces entries; the schema (Zod
+4) validates and types their `data`.
+
+```typescript
+// src/content.config.ts
+import { defineCollection, reference } from "astro:content";
+import { z } from "astro/zod"; // v6: z is imported from astro/zod, not astro:content
+import { glob, file } from "astro/loaders";
+
+// glob() — many files, one entry per file. `id` = path minus base & extension.
+const blog = defineCollection({
+  loader: glob({ pattern: "**/*.{md,mdx}", base: "./src/data/blog" }),
+  schema: ({ image }) =>
+    z.object({
+      title: z.string(),
+      description: z.string().max(160),
+      pubDate: z.coerce.date(),
+      updated: z.coerce.date().optional(),
+      draft: z.boolean().default(false),
+      cover: image(), // astro:assets image, validated at build
+      author: reference("authors"), // cross-collection reference
+      tags: z.array(z.string()).default([]),
+    }),
+});
+
+// file() — ONE structured file (JSON/YAML) holding an array of entries.
+const authors = defineCollection({
+  loader: file("./src/data/authors.json"), // each object needs an `id`
+  schema: z.object({ id: z.string(), name: z.string(), url: z.string().url().optional() }),
+});
+
+export const collections = { blog, authors };
+```
+
+## Zod 4 notes (Astro 6)
+
+In Astro 6 you import `z` from **`astro/zod`** (it is **Zod 4**); `z` was removed from `astro:content`
+and the old `astro:schema` alias is gone — both consolidate into `astro/zod`. Source:
+[upgrade-to-v6 guide](https://docs.astro.build/en/guides/upgrade-to/v6/) and the
+[Astro 6.0 release post, 2026-03-10](https://astro.build/blog/astro-6/). When migrating from v5:
+
+- Replace `import { z } from "astro:content"` with `import { z } from "astro/zod"` (and any
+  `astro:schema` import likewise). `defineCollection`, `reference`, `getCollection`, etc. still come
+  from `astro:content`.
+- `z.coerce.date()` for ISO date strings in frontmatter — unchanged, still the right call.
+- Review any custom error-map / `.refine()` usage and string-format helpers; Zod 4 changed some
+  error shapes and deprecated a few v3 APIs. Run a build and read the validation errors.
+- `image()` (injected via the `({ image }) => ...` schema form) validates and optimizes local images
+  referenced in frontmatter.
+
+## Querying & rendering
+
+```astro
+---
+import { getCollection, getEntry, render } from "astro:content";
+
+// All non-draft posts, newest first
+const posts = (await getCollection("blog", ({ data }) => !data.draft))
+  .sort((a, b) => b.data.pubDate.getTime() - a.data.pubDate.getTime());
+
+// A single entry by id
+const post = await getEntry("blog", "hello-world");
+
+// Resolve a reference() to the full entry
+const author = post ? await getEntry(post.data.author) : undefined;
+
+// Render Markdown/MDX body to a component (standalone render(), not entry.render())
+const { Content, headings } = await render(posts[0]);
+---
+<h2>{author?.data.name}</h2>
+<Content />
+```
+
+## Custom & CMS loaders
+
+When content comes from an API/CMS rather than files, write an inline loader or use a community one
+(`@ascorbic/*`, Storyblok, Contentful, etc.). The contract: return an array of objects each with an
+`id`, validated by the same `schema`.
+
+```typescript
+// src/content.config.ts — minimal inline loader fetching from a headless CMS at build time
+const products = defineCollection({
+  loader: async () => {
+    const res = await fetch("https://cms.example.com/api/products");
+    const items = await res.json();
+    return items.map((p: any) => ({ id: String(p.id), ...p })); // each entry needs an `id`
+  },
+  schema: z.object({ id: z.string(), name: z.string(), price: z.number() }),
+});
+```
+
+For incremental/syncing loaders that cache between builds, implement the full loader object
+(`{ name, load(context) }`) and use `context.store` — see
+`docs.astro.build/en/reference/content-loader-reference`.
+
+## Live Content Collections (stable in Astro 6)
+
+Stable as of the [Astro 6.0 release, 2026-03-10](https://astro.build/blog/astro-6/). Live collections
+fetch **at request time** instead of build time, so data stays fresh without a rebuild — ideal for
+inventory, prices, or anything that changes between deploys on an otherwise static site. They use a
+separate `src/live.config.ts` and `getLiveCollection`/`getLiveEntry`. Use them only for genuinely
+live data; build-time `glob()`/`file()` collections stay faster and cacheable for everything stable.
+Reference: [Live Content Collections guide](https://docs.astro.build/en/guides/content-collections/).
+
+## MDX
+
+`npx astro add mdx` enables `.mdx` in the same `glob()` pattern. MDX lets a content file import and
+render components (including hydrated islands with `client:*`). Keep islands inside MDX rare and
+deferred for the same reason as everywhere else: they ship JS.

package/skills/astro/references/deploy-and-integrations.md

@@ -0,0 +1,163 @@
+# Deploy adapters & integrations
+
+Static output needs no adapter — Astro builds HTML you can host anywhere. The moment any route uses
+`prerender = false` (on-demand rendering) or a server island, you need an **adapter** for the target
+platform.
+
+## Adapter table
+
+| Platform        | Adapter                | Install                                   | Notes                                          |
+| --------------- | ---------------------- | ----------------------------------------- | ---------------------------------------------- |
+| Vercel          | `@astrojs/vercel`      | `npx astro add vercel`                     | Serverless/edge functions for on-demand routes |
+| Netlify         | `@astrojs/netlify`     | `npx astro add netlify`                    | Netlify Functions for SSR                      |
+| Cloudflare      | `@astrojs/cloudflare`  | `npx astro add cloudflare`                 | Workers runtime; v6 dev runs this in dev too   |
+| Node (self-host)| `@astrojs/node`        | `npx astro add node`                       | `mode: "standalone"` for a standalone server   |
+
+Platform mechanics (DNS, env vars in the dashboard, build settings) are out of scope here — those
+belong to `../vercel/SKILL.md`, `../netlify/SKILL.md`, `../cloudflare/SKILL.md`. This file covers the
+*code* side: which adapter, and how rendering modes interact with it.
+
+## Rendering modes
+
+Astro renders static by default; you opt routes into on-demand individually.
+
+```javascript
+// astro.config.mjs — add an adapter once; static routes still build to HTML.
+import { defineConfig } from "astro/config";
+import vercel from "@astrojs/vercel";
+
+export default defineConfig({
+  adapter: vercel(),
+  // no top-level `output` needed in v6: per-route `prerender` decides static vs on-demand
+});
+```
+
+```astro
+---
+// A route that needs request data on every load → on-demand.
+export const prerender = false;
+---
+```
+
+Astro 6's dev server runs the production runtime via Vite 7's Environment API, so adapter-specific
+behavior (Cloudflare Workers APIs, Bun, Deno) shows up in dev — far fewer deploy-only surprises.
+
+## SSR endpoints (API routes)
+
+Server endpoints live in `src/pages/api/*.ts` and export HTTP-method functions. They need an adapter
+(they are on-demand by definition).
+
+```typescript
+// src/pages/api/subscribe.ts
+import type { APIRoute } from "astro";
+
+export const prerender = false;
+
+export const POST: APIRoute = async ({ request }) => {
+  const data = await request.formData();
+  const email = String(data.get("email") ?? "");
+  if (!email.includes("@")) {
+    return new Response(JSON.stringify({ error: "invalid" }), { status: 422 });
+  }
+  // ... persist / forward
+  return new Response(JSON.stringify({ ok: true }), { status: 201 });
+};
+```
+
+## Env handling
+
+Use `astro:env` for typed, validated env with a clear client/server split — never leak a secret to
+the client bundle.
+
+```javascript
+// astro.config.mjs
+import { defineConfig, envField } from "astro/config";
+
+export default defineConfig({
+  env: {
+    schema: {
+      // server-only secret: never reaches the browser
+      CMS_TOKEN: envField.string({ context: "server", access: "secret" }),
+      // safe to expose to the client
+      PUBLIC_SITE_NAME: envField.string({ context: "client", access: "public" }),
+    },
+  },
+});
+```
+
+```astro
+---
+import { CMS_TOKEN } from "astro:env/server"; // server context only
+---
+```
+
+## `astro add` recipes
+
+`astro add` patches `astro.config.mjs` and installs peers in one step:
+
+```bash
+npx astro add react          # React islands
+npx astro add mdx            # .mdx content
+npx astro add sitemap        # sitemap.xml at build
+npx astro add vercel         # (or netlify / cloudflare / node) adapter for on-demand
+```
+
+## Fonts API (stable in Astro 6)
+
+Stable as of the [Astro 6.0 release, 2026-03-10](https://astro.build/blog/astro-6/). Self-host and
+optimize fonts from config — no manual `@font-face`, no extra round-trip, zero CLS.
+
+```javascript
+// astro.config.mjs
+import { defineConfig, fontProviders } from "astro/config";
+
+export default defineConfig({
+  experimental: {}, // Fonts API is stable in v6; configure under `fonts`
+  fonts: [
+    {
+      provider: fontProviders.google(),
+      name: "Inter",
+      cssVariable: "--font-inter",
+      weights: [400, 600, 700],
+    },
+  ],
+});
+```
+
+Use the CSS variable in your styles. Reference:
+[Fonts guide](https://docs.astro.build/en/guides/fonts/).
+
+## CSP API (stable in Astro 6)
+
+Stable as of the [Astro 6.0 release, 2026-03-10](https://astro.build/blog/astro-6/). Astro can emit a
+Content-Security-Policy with hashes for your inline scripts/styles, tightening XSS defenses on static
+and on-demand pages alike.
+
+```javascript
+// astro.config.mjs
+export default defineConfig({
+  csp: true, // or an object to extend directives (e.g. allowed connect-src for islands)
+});
+```
+
+Reference: [Content Security Policy guide](https://docs.astro.build/en/reference/configuration-reference/#csp).
+
+## Tailwind 4
+
+Tailwind 4 wires through the official Vite plugin, **not** the legacy `@astrojs/tailwind`
+integration (that was for Tailwind 3).
+
+```javascript
+// astro.config.mjs
+import { defineConfig } from "astro/config";
+import tailwindcss from "@tailwindcss/vite";
+
+export default defineConfig({
+  vite: { plugins: [tailwindcss()] },
+});
+```
+
+```css
+/* src/styles/global.css */
+@import "tailwindcss";
+```