Project Scaffolding

Vytvořte základ aplikace Next.js / TanStack pro Profound CMS.

Instalace a spuštění

Pomocí Bun vytvořte nový projekt:

bunx create-profound-app <project-name>

Šablonu můžete vybrat interaktivně nebo ji zadat explicitně:

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

Chcete-li přeskočit automatickou inicializaci Gitu:

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

Chcete-li přeskočit automatickou instalaci závislostí:

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

Další kroky

cd <project-name>
bun dev

Šablony

• base: minimální výchozí web pro Profound CMS.
• docs: výchozí web dokumentace s uživatelským rozhraním specifickým pro dokumentaci.

Vytvoření webu v Profound CMS

Vygenerovaná aplikace potřebuje web, na který bude odkazovat. Před nastavením proměnných prostředí jej vytvořte v panelu pro správu.

1. Přejděte do Panelu pro správu.
2. Pokud vaše organizace zatím nemá žádné weby, zobrazí se vám přímo formulář pro vytvoření. V opačném případě otevřete rozevírací nabídku organizace v horní části postranního panelu a zvolte Vytvořit nový web.
3. Zadejte název a doménu webu a případně vyberte úvodní šablonu.
4. Klikněte na Vytvořit. Budete přesměrováni na /admin/<websiteId> — ID v této URL je ID webu, které budete potřebovat v další části.

Kde získat API KLÍČ a ID webu?

V panelu pro správu:

1. Zkopírujte ID webu pomocí tlačítka „Kopírovat ID“ na nástěnce
2. Vytvořte nový API KLÍČ v sekci Nastavení > API klíče

Proměnné prostředí

Ve vygenerovaném webu vytvořte soubor .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

Co tento nástroj dělá

create-profound-app zkopíruje šablonu do nového adresáře, nahradí zástupné symboly šablony, například název projektu, a volitelně inicializuje úložiště Gitu a nainstaluje požadované závislosti.

Příkazy vygenerovaného webu

Ve vygenerovaném projektu jsou hlavní příkazy:

bun dev: spustí vývojový server
bun build: sestaví produkční verzi
bun start: spustí produkční sestavení
bun lint: provede kontrolu lintování
bun generate-schemas: synchronizuje schémata CMS z Profound CMS