Project Scaffolding

Utwórz szkielet aplikacji Next.js / TanStack dla Profound CMS.

Instalacja i uruchamianie

Użyj Bun, aby utworzyć nowy projekt:

bunx create-profound-app <project-name>

Możesz wybrać szablon interaktywnie lub przekazać go jawnie:

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

Aby pominąć automatyczną inicjalizację Git:

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

Aby pominąć automatyczną instalację zależności:

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

Następne kroki

cd <project-name>
bun dev

Szablony

• base: minimalny szablon startowy witryny dla Profound CMS.
• docs: szablon startowy witryny dokumentacji ze specjalistycznym interfejsem użytkownika.

Utwórz witrynę w Profound CMS

Wygenerowana aplikacja potrzebuje witryny, z którą będzie połączona. Utwórz ją w Panelu administracyjnym przed skonfigurowaniem zmiennych środowiskowych.

1. Przejdź do Panelu administracyjnego.
2. Jeśli Twoja organizacja nie ma jeszcze żadnych witryn, od razu przejdziesz do formularza tworzenia. W przeciwnym razie otwórz rozwijane menu organizacji u góry paska bocznego i wybierz Utwórz nową witrynę.
3. Nadaj witrynie nazwę i domenę, a opcjonalnie wybierz szablon startowy.
4. Kliknij Utwórz. Zostaniesz przeniesiony(-a) do /admin/<websiteId> — identyfikator w tym adresie URL to identyfikator witryny wymagany w następnej sekcji.

Gdzie znaleźć KLUCZ API i identyfikator witryny?

W Panelu administracyjnym:

1. Skopiuj identyfikator witryny za pomocą przycisku „Kopiuj identyfikator” na pulpicie
2. Utwórz nowy KLUCZ API w sekcji Ustawienia > Klucze API

Zmienne środowiskowe

Utwórz plik .env.local w wygenerowanej witrynie:

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

Jak to działa

create-profound-app kopiuje szablon do nowego katalogu, zastępuje symbole zastępcze szablonu, takie jak nazwa projektu, oraz opcjonalnie inicjalizuje repozytorium Git i instaluje wymagane zależności.

Polecenia wygenerowanej witryny

W wygenerowanym projekcie dostępne są następujące główne polecenia:

bun dev: uruchom serwer deweloperski
bun build: utwórz wersję produkcyjną
bun start: uruchom wersję produkcyjną
bun lint: uruchom sprawdzanie lintingu
bun generate-schemas: zsynchronizuj schematy CMS z Profound CMS