Todas las Guías
Delivery Principiante 15 de marzo de 2026 10 min read

Cómo Desplegar Tu Template Estático

Pon tu template estático de FSEVO en producción en minutos — paso a paso para Vercel, Netlify y GitHub Pages. Sin backend necesario.

Los templates estáticos de FSEVO son sitios Astro puros — sin backend, sin base de datos, sin CMS. Editas el contenido directamente en los archivos fuente y despliegas con un push. Esta guía cubre las tres plataformas recomendadas.

Plataformas recomendadas (en orden): Vercel → Netlify → GitHub Pages

Qué Recibes

Cuando compras un template estático de FSEVO, recibes acceso a un repositorio privado de GitHub que contiene:

  • El código fuente completo de Astro (páginas, componentes, estilos, contenido)
  • .env.example con las variables de entorno necesarias
  • Esta guía

Paso 1 — Obtener Acceso al Repositorio

Después de la compra recibirás una invitación de colaborador de GitHub por email. Acéptala y clona el repo:

git clone https://github.com/fsevo/nombre-de-tu-template
cd nombre-de-tu-template
npm install

Si no recibes la invitación en 10 minutos, revisa spam o envía un email a fullstackevolved@gmail.com con tu confirmación de compra.

Paso 2 — Ejecutar Localmente

Antes de desplegar, confirma que todo funciona en tu máquina:

npm run dev

Abre http://localhost:4321 — el sitio debería cargar con contenido de demostración. Si lo hace, estás listo para desplegar.

Opción A — Vercel (Recomendado)

Vercel tiene el mejor soporte para Astro, deploys sin configuración y un tier gratuito generoso. Es la plataforma que usamos y recomendamos primero.

  1. Ve a vercel.com e inicia sesión (funciona con login de GitHub)
  2. Haz clic en Add New Project → importa tu repositorio
  3. Vercel detecta Astro automáticamente — la configuración de build es correcta por defecto
  4. Si el template tiene variables de entorno, agrégalas en Environment Variables antes de desplegar
  5. Haz clic en Deploy

Tu sitio estará en vivo en tu-proyecto.vercel.app en unos 60 segundos.

Para conectar un dominio personalizado: ve a Settings → Domains, agrega tu dominio y sigue las instrucciones de DNS. Vercel maneja HTTPS automáticamente.

Opción B — Netlify (Recomendado)

Netlify es igualmente capaz y una gran alternativa si lo prefieres o ya tienes cuenta.

  1. Ve a netlify.com e inicia sesión
  2. Haz clic en Add new site → Import an existing project
  3. Conecta tu cuenta de GitHub y selecciona el repositorio
  4. La configuración de build se detectará automáticamente:
    • Build command: npm run build
    • Publish directory: dist
  5. Si es necesario, agrega variables de entorno en Site configuration → Environment variables
  6. Haz clic en Deploy site

Tu sitio estará en vivo en tu-sitio.netlify.app en menos de un minuto.

Para conectar un dominio personalizado: ve a Domain management en la configuración de tu sitio, agrega tu dominio y actualiza tus registros DNS según las instrucciones.

Opción C — GitHub Pages

GitHub Pages es gratuito pero tiene algunas limitaciones — funciona mejor cuando tu repositorio es público y requiere un pequeño cambio de configuración.

1. Actualizar astro.config.mjs

Configura site y base para que coincidan con tu URL de GitHub Pages:

// astro.config.mjs
export default defineConfig({
  site: 'https://tu-usuario.github.io',
  base: '/nombre-de-tu-repo',
  // ... resto de la configuración
});

Si usas un dominio personalizado, configura site con tu dominio y base como '/'.

2. Agregar el workflow de GitHub Actions

Crea .github/workflows/deploy.yml:

name: Deploy to GitHub Pages

on:
  push:
    branches: [main, master]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pages: write
      id-token: write
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm install
      - run: npm run build
      - uses: actions/upload-pages-artifact@v3
        with:
          path: dist
      - id: deployment
        uses: actions/deploy-pages@v4

3. Habilitar GitHub Pages

En tu repositorio, ve a Settings → Pages, configura el source como GitHub Actions y guarda.

Haz push a main — el workflow se ejecutará y tu sitio estará en vivo en https://tu-usuario.github.io/nombre-de-tu-repo/.

Editar Contenido

Todo el contenido vive en src/content/ (archivos JSON o Markdown). Abre cualquier archivo, edita el texto y haz push para redesplegar. En Vercel y Netlify, cada push a main activa un rebuild automático — no se necesitan deploys manuales.

Solución de Problemas

El build falla en el deploy Ejecuta npm run build localmente primero. Si falla localmente, arréglalo ahí antes de hacer push. La causa más común es una variable de entorno faltante.

Las imágenes no se muestran en GitHub Pages Asegúrate de que base en astro.config.mjs coincida exactamente con el nombre de tu repo, incluyendo mayúsculas. Todos los links internos usan import.meta.env.BASE_URL — no escribas / directamente.

El sitio se despliega pero faltan estilos Mismo problema — revisa la configuración de base en astro.config.mjs.

El dominio personalizado no propaga Los cambios de DNS toman entre 1 minuto y 24 horas. Vercel y Netlify muestran el estado de propagación en sus dashboards.

¿Necesitas Ayuda?

Envía un email a fullstackevolved@gmail.com con tu referencia de compra y una descripción del problema. Tiempo de respuesta menor a 24 horas.

deployment vercel netlify github-pages astro setup