Cómo probar tu aplicación con Vue en GitHub Pages

¡Hola developer 👋🏼! Estos días he estado jugando con Vue (otra vez sí… 💚😅) para una demo rápida y quería tener la aplicación desplegada en algún sitio sin montar un entorno complejo, sin configurar infraestructura y, sobre todo, sin invertir demasiado tiempo.

Después de darle una vuelta, pensé: ¿por qué no tirar de algo sencillo que ya tengo disponible?
Y así volvió a mi mente un clásico que muchas veces olvidamos: GitHub Pages.

Lo interesante es que no solo sirve para sitios estáticos públicos…
👉 También puedes publicar sitios privados, visibles únicamente para usuarios autenticados de tu organización.

Perfecto para demos internas, prototipos rápidos o pruebas que no quieres abrir al mundo. 🔒✨


🧩 Cómo lo he montado

Mi objetivo era simple:

  • Hacer push ➝ ver la demo desplegada
  • Cero configuración externa
  • Entorno privado
  • Flujo fácil de mantener

Antes de nada, para que esto funcione he tenido que irme a la sección de Settings del repositorio en cuestión y ahí acceder a Pages, donde verás algo como lo siguiente:

Lo único que tienes que hacer es seleccionar la opción GitHub Actions y con ello quedará listo.

Después he creado un workflow de GitHub Actions que:

  1. Instala las dependencias de Vue
  2. Construye el proyecto
  3. Publica el contenido generado en GitHub Pages automáticamente
  4. Mantiene la página lista cada vez que actualizo el repositorio

Aquí dejo el flujo que estoy utilizando actualmente:

name: Deploy to GitHub Pages 🚀
on:
  push:
    branches: [main]
  workflow_dispatch:
permissions:
  contents: read
  pages: write
  id-token: write
concurrency:
  group: 'pages'
  cancel-in-progress: true
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: 📥 Checkout code
        uses: actions/checkout@v4
      - name: 🟢 Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - name: 📦 Install dependencies
        run: npm ci
      - name: 🏗️ Build
        run: npm run build
      - name: 📤 Upload artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: dist
  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - name: 🌐 Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

🔒 ¿Qué tiene de especial que sea privado?

GitHub Pages, cuando se usa desde repositorios privados en orgs o cuentas personales de pago, permite que el acceso esté restringido:

  • Si es un repo de tu organización, solo personas logadas con permisos pueden verlo.
  • Si es un repo privado personal, solo tú (o quienes autorices) podéis acceder.

Esto lo convierte en una opción ideal para:

  • Demos internas
  • Documentación no pública
  • Prototipos
  • Pruebas con frameworks (como en mi caso con Vue)
  • Cualquier mini-app que quieras tener lista sin exposiciones innecesarias

🎯 El resultado

A veces no necesitamos Kubernetes, Vercel, Azure Static Web Apps o despliegues complejos para validar una idea.
GitHub Pages + Actions puede ser más que suficiente, especialmente cuando quieres algo rápido, privado y automatizado.

Si quieres saber más sobre GitHub Actions puedes echar un vistazo a mi curso en mi canal de YouTube:

¡Nos vemos 👋🏼!

Deja un comentario

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.