Project Scaffolding

Izradite osnovnu Next.js / TanStack aplikaciju za Profound CMS.

Instalacija i pokretanje

Upotrijebite Bun za izradu novog projekta:

bunx create-profound-app <project-name>

Predložak možete odabrati interaktivno ili ga izričito proslijediti:

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

Za preskakanje automatske inicijalizacije Gita:

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

Za preskakanje automatske instalacije ovisnosti:

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

Sljedeći koraci

cd <project-name>
bun dev

Predlošci

• base: početni predložak minimalne web-stranice za Profound CMS.
• docs: početni predložak dokumentacijske web-stranice sa sučeljem specifičnim za dokumentaciju.

Izrada web-stranice u sustavu Profound CMS

Aplikacija izrađena iz predloška treba web-stranicu na koju će upućivati. Izradite je na administracijskoj ploči prije postavljanja varijabli okruženja.

1. Otvorite administracijsku ploču.
2. Ako vaša organizacija još nema web-stranica, obrazac za izradu otvorit će se izravno. U suprotnom otvorite padajući izbornik organizacije pri vrhu bočne trake i odaberite Izradi novu web-stranicu.
3. Dodijelite web-stranici naziv i domenu te po želji odaberite početni predložak.
4. Kliknite Izradi. Bit ćete preusmjereni na /admin/<websiteId> — ID u tom URL-u jest ID web-stranice koji se traži u sljedećem odjeljku.

Gdje pronaći API KLJUČ i ID web-stranice?

Na administracijskoj ploči:

1. Kopirajte ID web-stranice pomoću gumba „Kopiraj ID” na nadzornoj ploči
2. Izradite novi API KLJUČ u odjeljku Postavke > API ključevi

Varijable okruženja

Izradite datoteku .env.local u generiranoj web-stranici:

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

Što radi

create-profound-app kopira predložak u novi direktorij, zamjenjuje rezervirana mjesta u predlošku, kao što je naziv projekta, te po želji inicijalizira Git repozitorij i instalira potrebne ovisnosti.

Naredbe generirane web-stranice

Unutar generiranog projekta glavne su naredbe:

bun dev: pokretanje razvojnog poslužitelja
bun build: izrada produkcijske verzije
bun start: pokretanje produkcijske verzije
bun lint: pokretanje provjere koda
bun generate-schemas: sinkronizacija CMS shema iz sustava Profound CMS