Cómo Desplegar Tu Template Estático

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 un archivo ZIP que contiene:

El código fuente completo de Astro (páginas, componentes, estilos, contenido)
.env.example con las variables de entorno necesarias
LICENSE.md con los términos de tu licencia
Esta guía

Paso 1 — Descargar Tu Template

Tu template llega como un archivo ZIP:

Si compraste en fullstackevolved.com: usa el enlace de descarga de la página de confirmación del pedido. Por seguridad caduca tras un tiempo limitado; si ya caducó, escribe a hello@fullstackevolved.com con tu referencia de pedido y te enviamos uno nuevo.
Si compraste en Gumroad: descárgalo desde tu biblioteca de Gumroad cuando quieras.

Descomprímelo e instala las dependencias:

unzip nombre-de-tu-template-astro-template.zip
cd nombre-de-tu-template
npm install

Vercel, Netlify y GitHub Pages despliegan desde un repositorio Git, así que sube el código a un repositorio privado tuyo:

git init && git add . && git commit -m "Initial commit"
gh repo create tu-sitio --private --source=. --push

(O crea un repositorio privado en github.com y haz push.) Mantenlo privado: la licencia no permite publicar el código fuente del template.

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.

Ve a vercel.com e inicia sesión (funciona con login de GitHub)
Haz clic en Add New Project → importa tu repositorio
Vercel detecta Astro automáticamente — la configuración de build es correcta por defecto
Si el template tiene variables de entorno, agrégalas en Environment Variables antes de desplegar
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.

Ve a netlify.com e inicia sesión
Haz clic en Add new site → Import an existing project
Conecta tu cuenta de GitHub y selecciona el repositorio
La configuración de build se detectará automáticamente:
- Build command: npm run build
- Publish directory: dist
Si es necesario, agrega variables de entorno en Site configuration → Environment variables
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 requiere un pequeño cambio de configuración y una precaución: en una cuenta gratuita de GitHub solo sirve repositorios públicos, y un repositorio público publica el código fuente del template, algo que la licencia no permite. Úsalo solo con un repositorio privado en un plan de pago de GitHub (Pro, Team o Enterprise); si no, elige Vercel o Netlify.

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 hello@fullstackevolved.com con tu referencia de compra y una descripción del problema. Tiempo de respuesta menor a 24 horas.