Project Scaffolding

Maak een Next.js / TanStack-app aan voor Profound CMS.

Installeren en uitvoeren

Gebruik Bun om een nieuw project aan te maken:

bunx create-profound-app <project-name>

Je kunt interactief een template kiezen of er expliciet een meegeven:

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

Om automatische initialisatie van Git over te slaan:

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

Om automatische installatie van afhankelijkheden over te slaan:

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

Volgende stappen

cd <project-name>
bun dev

Templates

• base: minimale website-starter voor Profound CMS.
• docs: starter voor een documentatiewebsite met UI die specifiek is ontworpen voor documentatie.

De website aanmaken in Profound CMS

De aangemaakte app heeft een website nodig om naar te verwijzen. Maak er een aan in het Admin Panel voordat je je omgevingsvariabelen instelt.

1. Ga naar het Admin Panel.
2. Als je organisatie nog geen websites heeft, kom je rechtstreeks op het aanmaakformulier terecht. Open anders het dropdownmenu van de organisatie bovenaan de zijbalk en kies Nieuwe website aanmaken.
3. Geef de website een naam en een domein en kies eventueel een startertemplate.
4. Klik op Aanmaken. Je wordt naar /admin/<websiteId> gebracht — de ID in die URL is de website-ID waar in de volgende sectie om wordt gevraagd.

Waar vind je de API-SLEUTEL en website-ID?

Vanuit het Admin Panel:

1. Kopieer de website-ID via de knop "ID kopiëren" op het dashboard
2. Maak een nieuwe API-SLEUTEL aan in de sectie Instellingen > API-sleutels

Omgevingsvariabelen

Maak een bestand .env.local aan in je gegenereerde website:

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

Wat het doet

create-profound-app kopieert een template naar een nieuwe map, vervangt plaatshouders in de template, zoals de projectnaam, en initialiseert optioneel een Git-repository en installeert de vereiste afhankelijkheden.

Opdrachten voor de gegenereerde website

In het gegenereerde project zijn de belangrijkste opdrachten:

bun dev: start de ontwikkelserver
bun build: bouwen voor productie
bun start: de productiebuild uitvoeren
bun lint: linting uitvoeren
bun generate-schemas: CMS-schema's synchroniseren vanuit Profound CMS