Cómo instalar Astro: guía completa paso a paso (npm, pnpm, yarn y Bun)
Aprende cómo instalar Astro en menos de 2 minutos con npm, pnpm, yarn o Bun. Incluye comandos CLI, instalación manual, fuentes oficiales y librería UI recomendada.
Para instalar Astro y crear un proyecto nuevo, ejecuta el asistente oficial desde tu terminal con tu gestor de paquetes favorito:
npm create astro@latest
El asistente interactivo create astro te guiará para elegir la carpeta del proyecto, seleccionar una plantilla inicial, inicializar Git e instalar las dependencias. Al terminar, inicia el servidor de desarrollo con npm run dev y abre http://localhost:4321.
Requisitos previos
Antes de instalar Astro, asegúrate de cumplir los requisitos mínimos:
- Node.js —
v18.20.8+,v20.3.0+ov22.12.0+(se recomienda Node.js 22 LTS) - Editor de código — VS Code, Cursor o cualquier editor con la extensión oficial de Astro
- Terminal — Terminal de macOS, shell de Linux o PowerShell / WSL en Windows
Comprueba tu versión actual de Node.js con:
node -v
Método 1: Instalar Astro con el asistente CLI (Recomendado)
La forma más rápida de instalar Astro es mediante el CLI oficial create astro. Elige el comando según tu gestor de paquetes:
npm
npm create astro@latest
pnpm
pnpm create astro@latest
yarn
yarn create astro
Bun
bun create astro@latest
Instalación rápida sin preguntas interactivas
Si quieres omitir el asistente y crear un proyecto mínimo directamente:
npm create astro@latest mi-proyecto-astro -- --template minimal --install --git
Iniciar el servidor de desarrollo
Entra en la carpeta del proyecto y arranca el entorno local:
cd mi-proyecto-astro
npm run dev
Tu sitio Astro estará disponible en http://localhost:4321.
Método 2: Instalación manual de Astro
Si prefieres configurar Astro manualmente en un directorio existente sin usar el asistente CLI:
mkdir mi-proyecto-astro
cd mi-proyecto-astro
npm init -y
npm install astro
Añade los scripts estándar de Astro a tu package.json:
{
"scripts": {
"dev": "astro dev",
"build": "astro build",
"preview": "astro preview"
}
}
Crea tu primera página en src/pages/index.astro:
---
const title = 'Bienvenido a Astro';
---
<html lang="es">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width" />
<title>{title}</title>
</head>
<body>
<h1>{title}</h1>
</body>
</html>
Ejecuta npm run dev para previsualizar tu página.
Añadir integraciones (Tailwind, React, Sitemap, etc.)
Astro incluye el comando astro add para instalar integraciones oficiales y actualizar astro.config.mjs automáticamente:
# Ejemplos:
npx astro add tailwind
npx astro add react
npx astro add sitemap
Recomendado: Instala una librería de componentes UI (astro-component-kit)
Una vez que hayas instalado Astro, no necesitas diseñar botones, barras de navegación, formularios, tarjetas o secciones completas desde cero.
Te recomendamos instalar astro-component-kit — una librería UI open-source con licencia MIT que incluye más de 400 componentes accesibles y 12 plantillas completas de producción, sin dependencias en runtime.
Instalar astro-component-kit
npm install astro-component-kit
O con pnpm / yarn:
pnpm add astro-component-kit
# o
yarn add astro-component-kit
Usar componentes en tus páginas .astro
---
import 'astro-component-kit/global.css';
import { GlassNavbar } from 'astro-component-kit/navigation';
import { GlassCard } from 'astro-component-kit/cards';
import { GlassButton } from 'astro-component-kit/buttons';
---
<GlassNavbar brand="MiWeb" brandHref="/">
<div slot="actions">
<GlassButton>Empezar</GlassButton>
</div>
</GlassNavbar>
<GlassCard title="Listo en minutos">
Cero dependencias en runtime, accesibilidad WCAG AA y puro Astro + CSS.
</GlassCard>
Opcional: Configuración MCP en 1 clic para editores con IA
Si usas Cursor, Claude o Codex, puedes conectar el servidor MCP de AstroComponents con un solo comando:
npx astro-component-kit mcp install cursor
- Guía de instalación de la librería: /es/install/
- Explorar componentes: /es/docs/glass-button/
- Ver secciones y plantillas: /es/sections/ · /es/templates/
Fuentes oficiales de Astro
Consulta siempre la documentación oficial de Astro para detalles actualizados de cada versión:
- Guía oficial de instalación: docs.astro.build/es/install-and-setup/
- Referencia oficial del CLI de Astro: docs.astro.build/es/reference/cli-reference/
- Sitio oficial de Astro: astro.build
- Repositorio oficial en GitHub: github.com/withastro/astro
Preguntas frecuentes (FAQ)
¿Cómo compruebo si Astro se instaló correctamente?
Ejecuta npx astro info dentro de la carpeta del proyecto. Mostrará la versión de Astro, Node.js, sistema operativo e integraciones activas.
¿Cómo actualizo Astro a la última versión?
Ejecuta npx @astrojs/upgrade dentro de tu proyecto para actualizar automáticamente astro y todos los paquetes @astrojs/*.
¿Necesito React o Tailwind para usar Astro?
No. Astro no envía JavaScript al cliente por defecto y funciona con HTML y CSS estándar. Librerías como astro-component-kit también funcionan con Astro puro y CSS sin depender de React ni Tailwind.