Project Scaffolding

สร้างโครงร่างแอป Next.js / TanStack สำหรับ Profound CMS

การติดตั้งและเรียกใช้

ใช้ 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

หากต้องการข้ามการติดตั้ง dependencies โดยอัตโนมัติ:

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

ขั้นตอนถัดไป

cd <project-name>
bun dev

เทมเพลต

• base: โครงเริ่มต้นเว็บไซต์แบบพื้นฐานสำหรับ Profound CMS
• docs: โครงเริ่มต้นเว็บไซต์เอกสารพร้อม UI เฉพาะสำหรับเอกสาร

สร้างเว็บไซต์ใน Profound CMS

แอปที่สร้างจากโครงร่างจำเป็นต้องมีเว็บไซต์สำหรับเชื่อมต่อ สร้างเว็บไซต์ในแผงควบคุมผู้ดูแลระบบก่อนตั้งค่าตัวแปรสภาพแวดล้อม

1. ไปที่ แผงควบคุมผู้ดูแลระบบ
2. หากองค์กรของคุณยังไม่มีเว็บไซต์ คุณจะเข้าสู่แบบฟอร์มสร้างเว็บไซต์โดยตรง มิฉะนั้น ให้เปิดเมนูดรอปดาวน์ขององค์กรที่ด้านบนของแถบด้านข้าง แล้วเลือก สร้างเว็บไซต์ใหม่
3. ตั้ง ชื่อ และ โดเมน ให้เว็บไซต์ และเลือกเทมเพลตเริ่มต้นได้หากต้องการ
4. คลิก สร้าง ระบบจะนำคุณไปที่ /admin/<websiteId> — ID ใน URL นั้นคือ ID ของเว็บไซต์ที่ส่วนถัดไปต้องใช้

จะรับ API KEY และ ID ของเว็บไซต์ได้จากที่ไหน?

จากแผงควบคุมผู้ดูแลระบบ:

1. คัดลอก Website ID จากปุ่ม "คัดลอก ID" บนแดชบอร์ด
2. สร้าง API KEY ใหม่ในส่วน การตั้งค่า > คีย์ API

ตัวแปรสภาพแวดล้อม

สร้างไฟล์ .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 รวมถึงติดตั้ง dependencies ที่จำเป็นได้ตามต้องการ

คำสั่งของเว็บไซต์ที่สร้างขึ้น

ภายในโปรเจกต์ที่สร้างขึ้น คำสั่งหลักมีดังนี้:

bun dev: เรียกใช้เซิร์ฟเวอร์สำหรับการพัฒนา
bun build: สร้างสำหรับใช้งานจริง
bun start: เรียกใช้บิลด์สำหรับใช้งานจริง
bun lint: ตรวจสอบ linting
bun generate-schemas: ซิงค์สคีมา CMS จาก Profound CMS