¡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:
- Instala las dependencias de Vue
- Construye el proyecto
- Publica el contenido generado en GitHub Pages automáticamente
- 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 👋🏼!
