Project Scaffolding

Vytvorte základ aplikácie Next.js / TanStack pre Profound CMS.

Inštalácia a spustenie

Na vytvorenie nového projektu použite Bun:

bunx create-profound-app <project-name>

Šablónu môžete vybrať interaktívne alebo ju zadať explicitne:

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

Ak chcete preskočiť automatickú inicializáciu Gitu:

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

Ak chcete preskočiť automatickú inštaláciu závislostí:

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

Ďalšie kroky

cd <project-name>
bun dev

Šablóny

• base: minimálna úvodná webová stránka pre Profound CMS.
• docs: úvodná šablóna dokumentačnej stránky s používateľským rozhraním špecifickým pre dokumentáciu.

Vytvorenie webovej stránky v Profound CMS

Vygenerovaná aplikácia potrebuje webovú stránku, na ktorú bude odkazovať. Pred nastavením premenných prostredia ju vytvorte v paneli administrátora.

1. Prejdite do panela administrátora.
2. Ak vaša organizácia zatiaľ nemá žiadne webové stránky, zobrazí sa vám priamo formulár na vytvorenie. V opačnom prípade otvorte rozbaľovaciu ponuku organizácie v hornej časti bočného panela a vyberte Vytvoriť novú webovú stránku.
3. Zadajte názov a doménu webovej stránky a prípadne vyberte úvodnú šablónu.
4. Kliknite na Vytvoriť. Dostanete sa na stránku /admin/<websiteId> — ID v tejto URL je ID webovej stránky, ktoré sa vyžaduje v nasledujúcej časti.

Kde nájsť API KĽÚČ a ID webovej stránky?

V paneli administrátora:

1. Skopírujte ID webovej stránky pomocou tlačidla „Kopírovať ID“ na nástenke
2. Vytvorte nový API KĽÚČ v časti Nastavenia > API kľúče

Premenné prostredia

Vo vygenerovanej webovej stránke vytvorte súbor .env.local:

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

Čo to robí

create-profound-app skopíruje šablónu do nového adresára, nahradí zástupné symboly v šablóne, napríklad názov projektu, a voliteľne inicializuje repozitár Git a nainštaluje požadované závislosti.

Príkazy vygenerovanej webovej stránky

V rámci vygenerovaného projektu sú hlavné príkazy:

bun dev: spustenie vývojového servera
bun build: zostavenie produkčnej verzie
bun start: spustenie produkčnej zostavy
bun lint: spustenie kontroly kódu
bun generate-schemas: synchronizácia schém CMS z Profound CMS