CMS 1.0
CMS 1.0Próximo release · En desarrollo

Instalar y configurar el SDK

Instala el paquete público desde npm y configura Next.js y las variables de servidor.

9 min de lectura

Requisitos

  • Next.js >=16.2.0 <17, React y React DOM >=19.2.0 <20.
  • Node.js >=20.9 y un proyecto que use App Router.
  • El project slug y, para delivery privado, una API key READ_CONTENT creada en Veetcuna Platform.

Instalar el paquete

Instala @veetcuna/cms-next desde npm:

$ShellSolo lectura
npm install @veetcuna/cms-next

También puedes usar el gestor de paquetes habitual del website, por ejemplo pnpm add @veetcuna/cms-next o yarn add @veetcuna/cms-next.

Activar el generador

Envuelve la configuración existente de Next.js. En cada arranque o build, el SDK descubre definiciones exportadas desde src, mantiene un índice estático y calcula el release del registry.

TSTypeScriptSolo lectura
import type { NextConfig } from 'next';
import { withVeetcunaCms } from '@veetcuna/cms-next/generator';
 
const nextConfig: NextConfig = {};
 
export default withVeetcunaCms(nextConfig);

Por defecto se genera src/cms/cms.generated.ts. Es un archivo machine-owned: debe versionarse junto con los cambios del sitio, pero nunca editarse manualmente.

Variables de entorno

Configura únicamente variables server-side:

ENVVariables de entornoSolo lectura
VEETCUNA_CMS_ENABLED=true
VEETCUNA_CMS_API_URL=https://platform.veetcuna.com
VEETCUNA_CMS_API_KEY=vee_cms_replace_me
VEETCUNA_CMS_PROJECT_SLUG=@tenant/project-slug
VEETCUNA_CMS_ENABLED

Usa false para desactivar delivery remoto y conservar únicamente el contenido local.

VEETCUNA_CMS_API_URL

Origen de Platform. En desarrollo local normalmente es https://platform.veetcuna.dev.

VEETCUNA_CMS_API_KEY

Clave de runtime con READ_CONTENT. No cruza a Client Components.

VEETCUNA_CMS_PROJECT_SLUG

Referencia estable @tenant/proyecto; debe coincidir con el proyecto creado en Platform y con createCmsSite.

La conexión del editor no necesita una API key de escritura en el website. Platform emite sesiones cortas según la cuenta, el tenant, el proyecto, el origen y los permisos del usuario.