GitHub Pages para Android Devs: Tu Portafolio Gratis y Profesional
Índice de contenidos
🌍 ¿Por qué GitHub Pages?
Como desarrolladores Android, a menudo descuidamos nuestra presencia web. “Yo hago apps, no webs”, decimos. Pero tener un portafolio o un blog técnico es vital para tu carrera.
GitHub Pages es la solución perfecta porque:
- Es Gratis: Hosting ilimitado para proyectos estáticos.
- Es Git-based: Despliegas con un
git push. - Es Rápido: Servido a través de la CDN de GitHub.
- Soporta Dominios Personalizados:
tu-nombre.comcon HTTPS gratis.
🚀 Astro: El Framework Web para No-Web Devs
Este blog está construido con Astro. ¿Por qué Astro y no React/Angular?
- Zero JS by Default: Astro renderiza HTML estático. Carga instantáneamente.
- Content-Driven: Diseñado para blogs y documentación (Markdown nativo).
- Sintaxis Familiar: Si sabes HTML y un poco de JS (o Kotlin/Java), sabes Astro.
---
// Esto es como el "backend" del componente (se ejecuta en build time)
const title = "Mi Portafolio Android";
const apps = ["Sudoku", "TodoApp", "Weather"];
---
<!-- Esto es el template (HTML + variables) -->
<html>
<body>
<h1>{title}</h1>
<ul>
{apps.map((app) => <li>{app}</li>)}
</ul>
</body>
</html>🛠️ Configurando el Pipeline de Despliegue
Para desplegar una web Astro en GitHub Pages automáticamente:
- Habilita Pages en tu repo:
Settings -> Pages -> Source: GitHub Actions. - Crea el workflow
.github/workflows/deploy.yml:
name: Deploy to GitHub Pages
on:
push:
branches: [ main ]
permissions:
contents: read
pages: write
id-token: write
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: withastro/action@v2
with:
package-manager: npm
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🎨 Documentación de Librerías (Dokka + Pages)
Si tienes una librería Android Open Source, debes tener documentación web.
- Genera la documentación con Dokka (ver artículo de documentación).
- Configura el output de Dokka para que vaya a una carpeta
docs/. - En GitHub Pages settings, elige
Source: Deploy from a branchy selecciona la carpeta/docs.
¡Listo! Ahora tienes tu-usuario.github.io/tu-libreria con documentación profesional navegable.
🎯 Conclusión
No necesitas ser un experto en React o gastar dinero en AWS para tener una presencia web profesional. Con GitHub Pages y Astro, puedes construir y mantener tu marca personal usando las mismas herramientas (Git, CI/CD) que ya usas cada día.
También te puede interesar
OpenSpec para Desarrollo Móvil: Desarrollo Impulsado por Especificaciones en Android y Kotlin
Cómo aplicar OpenSpec en proyectos Android y Kotlin para mantener a los agentes de IA alineados con la arquitectura, con ejemplos prácticos de propuestas de cambio, validación de tareas y archivos vivos.
Prompts del Método Socrático: Rompiendo la Sicofancia de la IA en el Desarrollo con Kotlin y Android
Aprende a evitar que los LLMs sean asistentes complacientes y conviértelos en evaluadores implacables. Descubre la anatomía de los prompts socráticos para arquitectura Android, Corrutinas y el Spec-Driven Development.
La Serie de Agentes Socráticos (Parte 3): Construyendo un Orquestador Multi-Agente Socrático en Android
Una guía pragmática para construir interacciones avanzadas multi-agente usando Kotlin Coroutines y StateFlow. De MARS a MotivGraph-SoIQ, llevando la teoría académica a producción.