Project Scaffolding

Configura una aplicación de Next.js / TanStack para Profound CMS.

Instalar y ejecutar

Usa Bun para crear un proyecto nuevo:

bunx create-profound-app <project-name>

Puedes elegir una plantilla de forma interactiva o indicar una explícitamente:

bunx create-profound-app <project-name> --framework=next/tanstack --template=base/docs

Para omitir la inicialización automática de Git:

bunx create-profound-app <project-name> --no-git

Para omitir la instalación automática de dependencias:

bunx create-profound-app <project-name> --no-install

Próximos pasos

cd <project-name>
bun dev

Plantillas

• base: plantilla inicial de sitio web minimalista para Profound CMS.
• docs: plantilla inicial de sitio de documentación con una interfaz de usuario específica para documentación.

Crear el sitio web en Profound CMS

La aplicación configurada necesita un sitio web al que apuntar. Créalo en el Panel de administración antes de configurar las variables de entorno.

1. Ve al Panel de administración.
2. Si tu organización aún no tiene sitios web, accederás directamente al formulario de creación. De lo contrario, abre el menú desplegable de la organización en la parte superior de la barra lateral y selecciona Crear un sitio web nuevo.
3. Asigna al sitio web un nombre y un dominio y, opcionalmente, elige una plantilla inicial.
4. Haz clic en Crear. Se te llevará a /admin/<websiteId>; el ID de esa URL es el ID del sitio web que se solicita en la siguiente sección.

¿Dónde obtener la API KEY y el ID del sitio web?

Desde el Panel de administración:

1. Copia el ID del sitio web mediante el botón «Copiar ID» del panel
2. Crea una nueva API KEY en la sección Configuración > Claves de API

Variables de entorno

Crea un archivo .env.local en el sitio web generado:

PROFOUND_API_KEY=your_api_key
NEXT_PUBLIC_PROFOUND_WEBSITE_ID=your_website_id
NEXT_PUBLIC_CMS_API_URL=https://cms.dev.tryprofound.com
NEXT_PUBLIC_BUNNY_CDN_URL=https://cms-profound.b-cdn.net

Qué hace

create-profound-app copia una plantilla en un directorio nuevo, reemplaza los marcadores de posición de la plantilla, como el nombre del proyecto, y, opcionalmente, inicializa un repositorio de Git e instala las dependencias necesarias.

Comandos del sitio web generado

Dentro del proyecto generado, los comandos principales son:

bun dev: iniciar el servidor de desarrollo
bun build: compilar para producción
bun start: ejecutar la compilación de producción
bun lint: ejecutar la comprobación de estilo
bun generate-schemas: sincronizar los esquemas del CMS desde Profound CMS