Project Scaffolding

Tạo khung ứng dụng Next.js / TanStack cho Profound CMS.

Cài đặt và chạy

Sử dụng Bun để tạo một dự án mới:

bunx create-profound-app <project-name>

Bạn có thể chọn mẫu một cách tương tác hoặc truyền mẫu cụ thể:

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

Để bỏ qua việc khởi tạo Git tự động:

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

Để bỏ qua việc cài đặt dependency tự động:

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

Các bước tiếp theo

cd <project-name>
bun dev

Các mẫu

• base: mẫu khởi đầu website tối giản cho Profound CMS.
• docs: mẫu khởi đầu website tài liệu với giao diện dành riêng cho tài liệu.

Tạo website trong Profound CMS

Ứng dụng được tạo khung cần có một website để trỏ đến. Hãy tạo một website trong Bảng điều khiển quản trị trước khi thiết lập các biến môi trường.

1. Truy cập Bảng điều khiển quản trị.
2. Nếu tổ chức của bạn chưa có website nào, bạn sẽ được chuyển thẳng đến biểu mẫu tạo. Nếu không, hãy mở danh sách thả xuống của tổ chức ở đầu thanh bên và chọn Tạo website mới.
3. Đặt tên và tên miền cho website, đồng thời có thể chọn một mẫu khởi đầu.
4. Nhấp vào Tạo. Bạn sẽ được chuyển đến /admin/<websiteId> — ID trong URL đó chính là ID website mà phần tiếp theo yêu cầu.

Lấy API KEY và ID website ở đâu?

Từ Bảng điều khiển quản trị:

1. Sao chép ID website từ nút "Sao chép ID" trên bảng điều khiển
2. Tạo một API KEY mới trong mục Cài đặt > API Keys

Biến môi trường

Tạo tệp .env.local trong website đã tạo:

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

Chức năng

create-profound-app sao chép một mẫu vào thư mục mới, thay thế các phần giữ chỗ trong mẫu, chẳng hạn như tên dự án, đồng thời có thể khởi tạo kho lưu trữ Git và cài đặt các dependency cần thiết.

Các lệnh của website được tạo

Trong dự án đã tạo, các lệnh chính là:

bun dev: khởi động máy chủ phát triển
bun build: tạo bản dựng cho môi trường production
bun start: chạy bản dựng production
bun lint: chạy kiểm tra lint
bun generate-schemas: đồng bộ các schema CMS từ Profound CMS