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

כדי לדלג על ההתקנה האוטומטית של תלויות:

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

השלבים הבאים

cd <project-name>
bun dev

תבניות

• base: תבנית התחלתית לאתר מינימלי עבור Profound CMS.
• docs: תבנית התחלתית לאתר תיעוד עם ממשק משתמש ייעודי לתיעוד.

יצירת האתר ב-Profound CMS

האפליקציה שנוצרה זקוקה לאתר שאליו היא תתחבר. צרו אתר בלוח הניהול לפני הגדרת משתני הסביבה.

1. עברו אל לוח הניהול.
2. אם עדיין אין לארגון שלכם אתרים, תגיעו ישירות לטופס היצירה. אחרת, פתחו את הרשימה הנפתחת של הארגון בראש סרגל הצד ובחרו יצירת אתר חדש.
3. תנו לאתר שם ודומיין, ובחרו תבנית התחלתית, אם תרצו.
4. לחצו על יצירה. תועברו אל /admin/<websiteId> — המזהה בכתובת הזו הוא מזהה האתר שהסעיף הבא מבקש.

היכן מוצאים את מפתח ה-API ואת מזהה האתר?

מלוח הניהול:

1. העתיקו את מזהה האתר מהלחצן "העתקת מזהה" בלוח הבקרה
2. צרו מפתח API חדש בקטע הגדרות > מפתחות 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 ומתקין את התלויות הנדרשות.

פקודות באתר שנוצר

בתוך הפרויקט שנוצר, הפקודות העיקריות הן:

bun dev: הפעלת שרת הפיתוח
bun build: בנייה לסביבת ייצור
bun start: הרצת גרסת הייצור
bun lint: הפעלת בדיקת lint
bun generate-schemas: סנכרון סכמות CMS מ-Profound CMS