Project Scaffolding

최소한의 시작 템플릿 또는 문서 사이트 템플릿 중 하나를 사용하여 Profound CMS에 맞게 사전 구성된 웹사이트의 기본 구조를 생성합니다.

Profound CMS를 위한 Next.js / TanStack 앱의 기본 구조를 생성합니다.

설치 및 실행

Bun을 사용하여 새 프로젝트를 생성하세요.

bunx create-profound-app <project-name>

대화형으로 템플릿을 선택하거나, 템플릿을 명시적으로 전달할 수 있습니다.

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

자동 Git 초기화를 건너뛰려면 다음을 실행하세요.

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

자동 종속성 설치를 건너뛰려면 다음을 실행하세요.

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

다음 단계

cd <project-name>
bun dev

템플릿

base: Profound CMS를 위한 최소한의 웹사이트 시작 템플릿입니다.
docs: 문서 전용 UI가 포함된 문서 사이트 시작 템플릿입니다.

Profound CMS에서 웹사이트 만들기

생성된 앱이 연결될 웹사이트가 필요합니다. 환경 변수를 설정하기 전에 Admin Panel에서 웹사이트를 만드세요.

Admin Panel로 이동합니다.
조직에 아직 웹사이트가 없는 경우 생성 양식으로 바로 이동합니다. 그렇지 않은 경우 사이드바 상단의 조직 드롭다운을 열고 Create new website를 선택합니다.
웹사이트의 이름과 도메인을 입력하고, 선택적으로 시작 템플릿을 선택합니다.
Create를 클릭합니다. /admin/<websiteId>로 이동하게 되며, 해당 URL의 ID가 다음 섹션에서 요구하는 웹사이트 ID입니다.

API KEY와 웹사이트 ID는 어디에서 확인할 수 있나요?

Admin Panel에서 다음을 수행하세요.

대시보드의 "Copy ID" 버튼을 클릭하여 Website ID를 복사합니다.
Settings > API Keys 섹션에서 새 API KEY를 생성합니다.

환경 변수

생성된 웹사이트에 .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

기능

create-profound-app은 템플릿을 새 디렉터리에 복사하고, 프로젝트 이름과 같은 템플릿 플레이스홀더를 교체하며, 선택적으로 Git 저장소를 초기화하고 필요한 종속성을 설치합니다.

생성된 웹사이트 명령어

생성된 프로젝트 내에서 사용할 수 있는 주요 명령어는 다음과 같습니다.

bun dev: 개발 서버 실행
bun build: 프로덕션용 빌드
bun start: 프로덕션 빌드 실행
bun lint: 린트 실행
bun generate-schemas: Profound CMS에서 CMS 스키마 동기화

Previous‹템플릿 빌더에서 스크립팅 Next미디어 라이브러리›