Astro

Guía para Crear y Desplegar una Página con Astro en GitHub Pages

Aprende paso a paso cómo crear un sitio web con Astro y publicarlo gratis en GitHub Pages. Ideal para portafolios, blogs y proyectos personales.

Alberto Guaman diciembre 21, 2024 10 min de lectura

Categorías

Etiquetas

Temas

Astro GitHub Pages Despliegue Web

Guía para Crear y Desplegar una Página con Astro en GitHub Pages

¿Quieres publicar tu sitio Astro gratis y fácil?
¡GitHub Pages es la opción perfecta para proyectos estáticos y personales!

¿Por qué usar Astro + GitHub Pages?

Astro genera sitios ultrarrápidos y modernos.
GitHub Pages permite publicar gratis cualquier sitio estático.
Ideal para portafolios, blogs, documentación y proyectos open source.

Requisitos previos

Tener Node.js y npm instalados (descargar aquí).
Tener una cuenta en GitHub.
Conocimientos básicos de terminal y git.

Paso 1: Crear un nuevo proyecto Astro

npm create astro@latest

Sigue el asistente y elige la plantilla básica o la que prefieras.

Paso 2: Inicializa un repositorio git y sube tu proyecto a GitHub

git init
git add .
git commit -m "Proyecto Astro inicial"
git branch -M main
git remote add origin https://github.com/tu-usuario/tu-repo.git
git push -u origin main

Paso 3: Instala la integración de GitHub Pages para Astro

npm install @astrojs/github

Agrega la integración en tu astro.config.mjs:

import { defineConfig } from 'astro/config';
import github from '@astrojs/github';

export default defineConfig({
  integrations: [github()],
  // ...otras opciones
});

Paso 4: Configura el base path (si usas un subdirectorio)

Si tu sitio estará en https://usuario.github.io/repositorio, agrega en astro.config.mjs:

export default defineConfig({
  base: '/repositorio/',
  // ...
});

Paso 5: Genera el sitio estático

npm run build

Esto creará la carpeta dist/ lista para publicar.

Paso 6: Publica en GitHub Pages

Puedes usar la acción oficial de GitHub Actions para desplegar automáticamente:

Crea el archivo .github/workflows/deploy.yml en la raíz del proyecto:

name: Deploy Astro site to GitHub Pages

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: withastro/action@v2
        with:
          path: .

Haz commit y push de este archivo:

git add .github/workflows/deploy.yml
git commit -m "Configura despliegue en GitHub Pages"
git push

Ve a la pestaña Actions en tu repositorio y verifica que el workflow se ejecute correctamente.

Paso 7: Accede a tu sitio publicado

Ve a la configuración de tu repositorio en GitHub.
Busca la sección Pages.
Verifica la URL de tu sitio (será algo como https://usuario.github.io/repositorio/).

¡Listo! Tu sitio Astro está en línea y gratis.

Consejos y buenas prácticas

Personaliza tu dominio con un archivo CNAME si tienes uno propio.
Usa el comando npm run preview para revisar tu sitio antes de publicar.
Mantén tu repositorio actualizado y documentado.

Recursos útiles

¿Listo para mostrar tu proyecto al mundo?
¡Con Astro y GitHub Pages, publicar tu web nunca fue tan fácil!

Explorar etiquetas

astro github-pages despliegue web tutorial gratis

Más artículos

Testimonios

Qué dicen nuestros clientes

Comentarios reales de negocios que ya trabajaron con nosotros en web, sistemas y apps.

5.0

Google

23 reseñas

Raúl Muñoz Jara

13 ago 2024

Excelente profesional, rápido y amable en todo el proceso de lo que necesitas crear.

Bryan German Leon Rueda

22 feb 2024

Tinguar es una empresa de diseño web de primer nivel que superó todas mis expectativas. La calidad de su trabajo es impecable.

Jorge Luis

26 abr 2024

Excelente servicio, me ayudo con mi pagina EEUU. Lo recomiendo 100%.

Daniel Jaramillo

4 mar 2024

Excelente servicio, me realizo la pagina web y va de maravilla. Recomendable.

Adrian Alejandro Villena

6 jun 2023

Excelente servicio y atención, recomendado llevo años con esta empresa y son muy profesionales.

Carranza Luis

2 sept 2023

El gerente excelente profesional, realizó nuestra página para el centro pre universitario.. 10 / 10

María González

15 ene 2024

Increíble trabajo, muy profesional y puntual. Mi sitio web quedó perfecto.

Carlos Rodríguez

20 may 2024

Excelente atención al cliente y resultados sobresalientes. Altamente recomendado.

Ana Martínez

18 mar 2024

Trabajo de calidad superior, entregaron antes de lo esperado. Muy satisfecho.

Luis Fernández

10 jun 2024

Profesionales de primera, entendieron perfectamente lo que necesitaba.

Patricia Silva

5 abr 2024

Servicio excepcional, comunicación clara y resultados excelentes.

Roberto Torres

22 jul 2024

Equipo muy competente, transformaron mi idea en una realidad digital increíble.

Karina Espinoza

11 feb 2025

Pedí un POS para mi tienda y al final me ayudaron hasta con el ticket de la impresora térmica. Antes tenía todo en cuaderno jaja.

MÁ

Miguel Ángel Paredes

3 may 2025

La verdad se demoraron un poquito al inicio pero me avisaron. La web quedó bien y me enseñaron a subir productos yo mismo.

Diego Cárdenas

19 ago 2025

Buscaba algo para controlar renovaciones de streaming y ya no pelear con Excel. Me salió mucho más ordenado de lo que imaginaba.

Dra. Verónica Acosta

28 nov 2024

Hicieron la página de mi consultorio. Nada exagerado, limpia y fácil de leer. Mis pacientes ahora agendan por WhatsApp sin problema.

Esteban Mora

17 ene 2025

Lo bueno es que contestan. Uno escribe a las 9 de la noche y al día siguiente ya tienen avance. Yo soy de Cuenca y todo fue remoto.

Paola Ríos

9 mar 2025

Nos armó un panel chiquito para el inventario de 2 locales. No es un monstruo de software, es justo lo que necesitábamos.

Andrés Villacís

14 sept 2024

Me hicieron landing de un curso online. En 2 semanas ya tenía formulario y pagos. Precio razonable frente a otras cotizaciones.

Sofía Naranjo

21 jun 2025

Había trabajado con otro provider y me dejaron botado. Aquí por lo menos explican qué están haciendo y por qué.

Héctor Zambrano

2 abr 2025

App android para mi equipo de ventas. Falló un detalle al principio, lo corrigieron el mismo viernes. Eso me convenció.

Camila Ordóñez

8 jul 2025

No soy técnica, solo quería una web seria para mi marca de ropa. Me guiaron sin hablar en código y quedó linda.

Jaime Maldonado

25 sept 2025

Llevo el hosting con ellos desde el 2023. Si algo se cae, avisan. Eso vale oro cuando uno vende online.