Next.js · פקודת CLI

Next.js

פקודה אחת בונה את ה-webhook route, עמודי הבלוג, הרכיבים, וסכמת ה-SQL, מוכנים לפרויקט שלכם אוטומטית.

סקירה כללית

vellumup-init הוא כלי ה-CLI הרשמי והקוד-פתוח של VellumUp. הוא בודק את פרויקט ה-Next.js שלכם וכותב את ה-webhook receiver, עמודי הבלוג, וקבצי העזר ישירות לתוכו, בלי העתקה ידנית, בלי צורך בעוזר AI.

terminal

npx vellumup-init

קוד פתוח, רישיון MIT, ומפורסם ב-npm. צפה ב-npm

דרישות

פרויקט Next.js (App Router לבלוג המלא, Pages Router תומך רק ב-webhook route)
Node.js 18.3 ומעלה
מסד נתונים תואם PostgreSQL לאחסון מאמרים (רק במצב בלוג מלא, Supabase כברירת מחדל)

מה זה יוצר

הרצת הפקודה ללא דגלים בונה בלוג מלא:

tree

your-project/
├── app/
│   ├── api/vellumup/route.ts     # webhook receiver
│   └── blog/
│       ├── page.tsx              # paginated blog index
│       └── [slug]/page.tsx       # article page
├── components/
│   ├── BlogPostLayout.tsx
│   ├── BlogSection.tsx
│   ├── BlogCard.tsx
│   ├── BlogKeyTakeaways.tsx
│   └── PillTableOfContents.tsx
├── lib/blog-theme.ts             # theming configuration
├── vellumup/articles.sql         # PostgreSQL schema
└── .env.local                    # environment variables

השתמשו ב-route-only-- כדי ליצור רק את ה-webhook receiver, קובץ ה-SQL, ופלייסהולדר לסוד, בלי עמודי בלוג או רכיבים, לצוותים שבונים ממשק בלוג משלהם.

דגלי CLI

כל הדגלים אופציונליים. הרצת הפקודה בלי אף אחד מהם מתחילה הגדרה אינטראקטיבית.

דגל	אפקט
--yes	מצב לא-אינטראקטיבי, מקבל את ברירות המחדל לכל שאלה
--route-only	יוצר רק את ה-webhook route, קובץ ה-SQL, והסוד, בלי עמודי בלוג או רכיבים
--lang <code>	מגדיר סינון שפה (למשל en, fr) לבלוג שנוצר
--no-install	כותב את הקבצים אבל מדלג על הרצת מנהל החבילות שלכם
--help	מציג עזרת שימוש, או version-- לגרסה המותקנת

איך לחבר

לאחר יצירת הקבצים, חברו את ה-webhook שהוא יצר לחשבון ה-VellumUp שלכם:

1
העתיקו את סוד ה-webhook שלכם
ה-CLI כותב סוד פלייסהולדר לקובץ .env.local. צרו סוד אמיתי מ-אינטגרציות ← Next.js בלוח הבקרה של VellumUp והדביקו אותו.
2
פרסמו את הפרויקט שלכם
ה-webhook route צריך כתובת HTTPS ציבורית כדי לקבל אירועים, פרסמו ל-Vercel או לאירוח הרגיל שלכם לפני רישום ה-endpoint.
3
רשמו את ה-endpoint
ב-VellumUp, עברו אל אינטגרציות ← Next.js ורשמו את כתובת ה-route שפרסמתם (yoursite.com/api/vellumup) כדי להשלים את החיבור.

ה-CLI מתקין באופן אופציונלי את react-markdown ו-remark-gfm במצב בלוג מלא. הוא לעולם לא מתקין עבורכם את @supabase/supabase-js, הוסיפו אותו בעצמכם אם אתם משתמשים ב-Supabase.

חזרה לתיעוד