Indicación para crear un sitio SEO estático con Astro
Indicación lista para copiar y pegar para crear un sitio estático Astro completamente optimizado con colecciones de contenido, mapa del sitio, imágenes OG y TypeScript.
CursorClaude CodeCodexWindsurf AstroTypeScriptTailwind
Entrégueselo a su agente para crear un sitio estático Astro listo para producción con colecciones de contenido, Tailwind v4, meta SEO, mapa del sitio e imágenes OG por página, sin que invente integraciones incompatibles ni omita etiquetas canónicas.
Indicación principal
You are scaffolding a new Astro static site. Use Astro 5, TypeScript strict mode,and Tailwind CSS v4 (via @tailwindcss/vite — NOT the legacy @astrojs/tailwind integration).
Requirements:- Initialize with `bun create astro@latest` defaults, then layer in: - A `src/content/blog/` collection with a Zod schema (title, description, pubDate, tags). - A shared `<BaseLayout>` with `<head>` containing: canonical URL, og:title, og:description, og:image (per-page), twitter:card, and the Astro `<ViewTransitions />` component. - `@astrojs/sitemap` integration configured with `customPages` for any dynamic routes. - A `public/robots.txt` that disallows `/api/` and allows everything else. - A `/blog/[slug].astro` dynamic route that renders MDX blog posts. - A `/tags/[tag].astro` route that filters posts by tag. - Tailwind applied globally via `src/styles/global.css` imported in BaseLayout.- All components must be `.astro` — no React unless explicitly asked.- Export a typed `getStaticPaths` for every dynamic route.- Do NOT install `@astrojs/react`, `next`, or any SSR adapter — this is a static build.
Stop after listing all files you plan to create or modify. Wait for my approval before writing any code.Notas de implementación
- Las colecciones de contenido de Astro 5 usan
defineCollectionensrc/content.config.ts, no la ruta antiguasrc/content/config.ts— confirme que el agente usa la ubicación correcta. - Tailwind v4 se distribuye como un plugin de Vite; el patrón antiguo
integrations: [tailwind()]enastro.config.tsestá obsoleto y causará un error en tiempo de ejecución. getStaticPathsdebe devolver objetos{ params, props }; el agente a veces devuelve cadenas simples.
Cambios esperados en archivos
astro.config.ts (new)src/content.config.ts (new)src/layouts/BaseLayout.astro (new)src/pages/index.astro (new)src/pages/blog/[slug].astro (new)src/pages/tags/[tag].astro (new)src/styles/global.css (new)public/robots.txt (new)package.json (edited)tsconfig.json (edited)Criterios de aceptación
bun run buildtermina con código 0 y sin errores de tipo.- Cada página de publicación de blog incluye una URL canónica única y
og:imageen el HTML renderizado. - Se genera
/sitemap-index.xmly contiene todas las URL de las publicaciones del blog. - Existe
/robots.txty no permite/api/.
Comandos de prueba
bun run buildbun run previewcurl -s http://localhost:4321/sitemap-index.xml | grep '<loc>'curl -s http://localhost:4321/robots.txtbun run typecheckErrores comunes de la IA
- Instalar el obsoleto
@astrojs/tailwinden lugar de@tailwindcss/vite. - Colocar
content.config.tsensrc/content/config.ts(ruta antigua de Astro 4). - Olvidar llamar a
getCollection('blog')dentro degetStaticPaths— devolviendo un array vacío. - Añadir
output: 'server'aastro.config.ts, lo que rompe la exportación estática.
Indicación correctiva
The build failed. Check for these issues in order:1. Tailwind: remove `@astrojs/tailwind` from integrations and add `@tailwindcss/vite` to the `vite.plugins` array in astro.config.ts.2. Content config: the file must be at `src/content.config.ts` (not `src/content/config.ts`).3. `getStaticPaths`: each entry must be `{ params: { slug }, props: { post } }`.Fix only the broken items. Show me the corrected diff.