Sanity

Documentación del CMS headless. Cubre la configuración del Studio, el modelo de contenido y cómo extenderlo para nuevos proyectos.

En esta sección

• Schemas de Sanity — Estructura del modelo de contenido: objetos reutilizables, secciones y documentos raíz.
• Integración con el frontend — Configuración del cliente, variables de entorno y queries GROQ desde apps/web.

Configuración inicial (nuevos miembros)

Antes de poder desarrollar con el Studio en local, hay que autenticarse con la cuenta de Sanity del proyecto y configurar las variables de entorno.

1. Iniciar sesión en el CLI de Sanity

pnpm --filter @asamamx/studio exec sanity login

Abre el navegador para completar el login. Usa la cuenta de asamamx (no una cuenta personal). Una vez autenticado, el CLI queda con sesión activa en la máquina.

Si ya tenías sesión con otra cuenta, el comando la reemplaza automáticamente. Puedes verificar la sesión activa con sanity whoami.

2. Crear apps/studio/.env.local

El Studio necesita el Project ID y el dataset para conectarse. Crea el archivo (no versionado) basándote en .env.example:

SANITY_STUDIO_API_PROJECT_ID=
SANITY_STUDIO_API_DATASET=

3. Agregar las variables al frontend

En apps/web/.env.local, asegúrate de tener:

NEXT_PUBLIC_SANITY_PROJECT_ID=
NEXT_PUBLIC_SANITY_DATASET=

4. Levantar el Studio

pnpm --filter @asamamx/studio dev
# Studio disponible en http://localhost:3333

Comandos frecuentes

# Desarrollo local
pnpm --filter @asamamx/studio dev
 
# Build para autoalojamiento (output estático en apps/studio/dist/)
pnpm --filter @asamamx/studio build
 
# Ver sesión activa
pnpm --filter @asamamx/studio exec sanity whoami
 
# Cerrar sesión
pnpm --filter @asamamx/studio exec sanity logout

Proyecto