Todas las Guías
Delivery Intermedio 14 de marzo de 2026 15 min read

Cómo Desplegar Tu Template con Sanity

Guía paso a paso para llevar tu template con Sanity desde la descarga hasta producción — incluyendo configuración del Studio, variables de entorno, deploy en Vercel y población de contenido.

Acabas de comprar un template con Sanity. Aquí está el proceso completo para ponerlo en funcionamiento en un dominio real, paso a paso.

¿Buscas la guía para templates estáticos? Si tu template no usa Sanity, consulta Cómo Desplegar Tu Template Estático — cubre Vercel, Netlify y GitHub Pages.

Qué Recibes

Cuando compras un template con Sanity de FSEVO, recibes acceso a un repositorio privado de GitHub que contiene:

  • El frontend de Astro (completamente construido, listo para producción)
  • Una carpeta /studio con el Sanity Studio preconfigurado
  • Template de variables de entorno (.env.example)
  • Esta guía

Paso 1 — Obtener Acceso al Repositorio

Después de la compra, recibirás un email con una invitación de colaborador de GitHub. Acepta la invitación y clona el repo en tu máquina:

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 tu carpeta de spam o envía un email a fullstackevolved@gmail.com con tu confirmación de compra.

Paso 2 — Crear Tu Proyecto en Sanity

Ve a sanity.io/manage e inicia sesión (crea una cuenta gratuita si es necesario).

  1. Haz clic en Create new project
  2. Dale un nombre (por ejemplo, el nombre de tu dominio)
  3. Elige el plan Free — es más que suficiente
  4. Anota tu Project ID — lo necesitarás pronto
  5. Tu dataset se llama production por defecto

Ahora tienes un backend de Sanity vacío listo para recibir contenido.

Paso 3 — Configurar Variables de Entorno

En la raíz del proyecto, duplica .env.example y renómbralo a .env:

cp .env.example .env

Abre .env y completa tus valores:

PUBLIC_SANITY_PROJECT_ID=tu_project_id_aqui
PUBLIC_SANITY_DATASET=production

Eso es todo lo que necesitas localmente. El frontend lee desde el CDN público de Sanity, así que no se requieren tokens de API para el frontend de solo lectura.

Paso 4 — Desplegar Sanity Studio

La carpeta /studio es una app independiente de Sanity Studio. Despliégala en el hosting gratuito de Sanity:

cd studio
npx sanity deploy

Cuando te pregunte, elige un hostname — este será tu URL del Studio:

https://nombre-de-tu-studio.sanity.studio

Guarda esta URL en favoritos. La usarás para gestionar todo el contenido de tu sitio.

Paso 5 — Poblar Tu Contenido

Abre la URL de tu Studio en el navegador y comienza a agregar contenido.

El schema está preconstruido para coincidir exactamente con el frontend. Cada campo mapea directamente a lo que ves en el sitio en vivo. Algunos consejos:

  • Imágenes — súbelas a la biblioteca de medios de Sanity; se sirven automáticamente a través del CDN global de Sanity
  • Texto enriquecido — usa el editor de bloques; encabezados, enlaces y listas están todos estilizados en el frontend
  • Slugs — haz clic en “Generate” junto al campo de slug; no los escribas manualmente
  • Borradores — el contenido permanece en borrador hasta que presiones “Publish”; el sitio en vivo no lo mostrará

Comienza con la página más importante (generalmente el hero de la homepage y la sección about) y trabaja hacia afuera.

Paso 6 — Desplegar el Frontend en Vercel (Recomendado)

Vercel es nuestra plataforma recomendada para todos los templates de FSEVO — mejor soporte para Astro, sin configuración y el tier gratuito es más que suficiente para la mayoría de proyectos.

Ve a vercel.com, inicia sesión y haz clic en Add New Project.

  1. Importa el repositorio de GitHub que clonaste en el Paso 1
  2. Vercel detecta Astro automáticamente — la configuración de build es correcta por defecto
  3. Antes de desplegar, ve a Environment Variables y agrega:
    • PUBLIC_SANITY_PROJECT_ID → tu project ID
    • PUBLIC_SANITY_DATASET → production
  4. Haz clic en Deploy

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

Paso 7 — Conectar un Dominio Personalizado

En tu proyecto de Vercel, ve a Settings → Domains y agrega tu dominio.

Vercel te mostrará los registros DNS que debes agregar. Ve a tu registrador de dominios (Namecheap, Cloudflare, GoDaddy, etc.) y agrega:

  • Un registro A apuntando a la IP de Vercel: 76.76.21.21
  • O un CNAME apuntando a cname.vercel-dns.com (para subdominios)

La propagación DNS toma entre 1 minuto y 24 horas dependiendo de tu registrador. Vercel maneja HTTPS automáticamente — no se necesita configuración de SSL.

Paso 8 — Configurar Revalidación (Opcional pero Recomendado)

Por defecto, el frontend se reconstruye en cada deploy de Vercel. Para activar un rebuild automáticamente cuando publicas contenido en Sanity:

  1. En Vercel, ve a Settings → Git → Deploy Hooks y crea un hook — copia la URL
  2. En Sanity Studio, instala el plugin de Vercel Deploy:
cd studio
npx sanity install @sanity/vercel-deploy
  1. Agrega la URL del hook a la configuración de tu Studio

Ahora cada vez que presiones “Publish” en Sanity, el frontend se reconstruye automáticamente — no se necesitan deploys manuales.

Solución de Problemas

El contenido no se muestra en el sitio en vivo Asegúrate de presionar Publish en Sanity Studio. El contenido en borrador nunca se envía al frontend.

El build falla en Vercel Verifica que tus variables de entorno estén configuradas correctamente en el dashboard de Vercel. Un PUBLIC_SANITY_PROJECT_ID faltante es la causa más común.

Las imágenes no cargan Tu project ID de Sanity debe coincidir exactamente en .env. Verifica el valor en sanity.io/manage.

El Studio muestra “Unauthorized” Ve a sanity.io/manage → tu proyecto → API → CORS Origins y agrega la URL de tu Studio y tu dominio en vivo.

¿Necesitas Ayuda?

Si encuentras algo no cubierto aquí, 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.

sanity deployment vercel astro setup