Skip to main content
דף זה הוא חלק ממיומנות של סוכן קידוד AI ונכתב לסוכנים, לא לבני אדם. לתיעוד Base44 הקריא לבני אדם, ראה את תיעוד המפתחים.

Base44 CLI

צור ונהל אפליקציות Base44 (פרויקטים) באמצעות כלי Base44 CLI.

⚡ פעולה מיידית נדרשת - קרא זאת תחילה

מיומנות זו מופעלת בכל אזכור של “base44” או כאשר קיימת תיקיית base44/. אל תקרא קבצי תיעוד או תחפש באינטרנט לפני פעולה. הפעולה הראשונה שלך חייבת להיות:
  1. בדוק אם base44/config.jsonc קיים בתיקייה הנוכחית
  2. אם כן (תרחיש פרויקט קיים):
    • העבר למיומנות base44-sdk ליישום
    • מיומנות זו מטפלת רק בפקודות CLI (login, deploy, entities push)
  3. אם לא, החלט בין שני נתיבי אתחול:
    • אפליקציה מוקצית — אפליקציית Base44 כבר קיימת כי הוקצתה זה עתה דרך זרימת Stripe Projects / projects.dev, או BASE44_APP_ID (או BASE44_PROJECTS_BASE44_APP_ID) קיים בסביבה או בקובץ .env/.env.local:
      • הרץ npx base44 scaffold להגדרת קבצים מקומיים לאותה אפליקציה קיימת
      • אל תריץ npx base44 create — זה יוצר אפליקציה שנייה, כפולה. ראה scaffold.md.
    • פרויקט חדש — אין אפליקציה עדיין ואין אחת שהוקצתה:
      • מיומנות זו (base44-cli) מטפלת בבקשה; הנחה את המשתמש דרך npx base44 create
      • אל תפעיל את base44-sdk עדיין

קריטי: התקנה מקומית בלבד

לעולם אל תקרא base44 ישירות. ה-CLI מותקן מקומית כתלות dev וחייב להיות נגיש דרך package manager:
  • npx base44 <command> (npm - מומלץ)
  • yarn base44 <command> (yarn)
  • pnpm base44 <command> (pnpm)
WRONG: base44 login RIGHT: npx base44 login

חובה: בדיקת אימות בתחילת סשן

קריטי: בתחילת כל סשן AI כאשר מיומנות זו מופעלת, אתה חייב:
  1. בדוק סטטוס אימות על ידי הרצת:
  2. אם המשתמש מחובר (הפקודה מצליחה ומציגה אימייל):
    • המשך במשימה המבוקשת
  3. אם המשתמש אינו מחובר (הפקודה נכשלת או מציגה שגיאה):
    • עצור מיד
    • אל תמשיך עם פעולות CLI כלשהן
    • בקש מהמשתמש להתחבר ידנית על ידי הרצת:
בדיקה זו חובה וחייבת לקרות לפני ביצוע כל פקודת Base44 CLI אחרת. מוקצה דרך Stripe Projects / projects.dev? כאשר האפליקציה מוקצית בזרימה זו, ה-CLI זורע אימות ממשתני הסביבה BASE44_ACCESS_TOKEN / BASE44_REFRESH_TOKEN שהוא מזריק (השמות עם קידומת BASE44_PROJECTS_* מנורמלים אוטומטית). במקרה כזה npx base44 whoami כבר מצליח ואינך צריך npx base44 login אינטראקטיבי.

סקירה כללית

Base44 CLI מספק כלים של שורת פקודה לאימות, יצירת פרויקטים, ניהול entities ופריסת אפליקציות Base44. הוא אינו תלוי בפריימוורק ועובד עם פריימוורקים פופולריים של frontend כמו Vite, Next.js, ו-Create React App, Svelte, Vue ועוד.

מתי להשתמש במיומנות זו לעומת base44-sdk

השתמש ב-base44-cli כאשר:
  • יוצר פרויקט Base44 חדש מאפס
  • מאתחל פרויקט בתיקייה ריקה
  • מגדיר קבצים מקומיים לאפליקציה קיימת שהוקצתה חיצונית (למשל, דרך זרימת Stripe Projects / projects.dev) → השתמש ב-scaffold
  • תיקייה חסרה base44/config.jsonc
  • המשתמש מזכיר: “create a new project”, “initialize project”, “setup a project”, “start a new Base44 app”
  • פורס, דוחף entities, או מזדהה דרך CLI
  • עובד עם פקודות CLI (npx base44 ...)
השתמש ב-base44-sdk כאשר:
  • בונה תכונות בפרויקט Base44 קיים
  • base44/config.jsonc כבר קיים
  • כותב קוד JavaScript/TypeScript באמצעות Base44 SDK
  • מיישם פונקציונליות, רכיבים או תכונות
  • המשתמש מזכיר: “implement”, “build a feature”, “add functionality”, “write code”
תלויות מיומנות:
  • base44-cli הוא תנאי מקדים ל-base44-sdk בפרויקטים חדשים
  • אם המשתמש רוצה “create an app” ואין פרויקט Base44, השתמש תחילה ב-base44-cli
  • base44-sdk מניח שפרויקט Base44 כבר מאותחל
לוגיקת בדיקת מצב: לפני בחירת מיומנות, בדוק:
  • IF (המשתמש מזכיר “create/build app” OR “make a project”):
    • IF (base44/config.jsonc קיים): → השתמש ב-base44-sdk (הפרויקט קיים, בנה תכונות)
    • ELSE IF (האפליקציה הוקצתה חיצונית — BASE44_APP_ID/BASE44_PROJECTS_BASE44_APP_ID מוגדר, או זרימת Stripe Projects / projects.dev רצה זה עתה): → השתמש ב-base44-clinpx base44 scaffold (הגדר קבצים מקומיים לאפליקציה הקיימת; אל create)
    • ELSE: → השתמש ב-base44-clinpx base44 create (נדרש אתחול פרויקט חדש)

מבנה פרויקט

פרויקט Base44 משלב פרויקט frontend סטנדרטי עם תיקיית תצורת base44/:
קבצי מפתח:
  • base44/config.jsonc - שם פרויקט, תיאור, הגדרות site build
  • base44/entities/*.jsonc - סכמות מודל נתונים (ראה סעיף Entity Schema)
  • base44/functions/*/entry.ts - נקודת כניסה של פונקציית backend
  • base44/agents/*.jsonc - תצורות סוכן (אופציונלי)
  • base44/.types/types.d.ts - סוגי TypeScript שנוצרים אוטומטית עבור entities, functions, ו-agents (נוצר על ידי npx base44 types generate)
  • base44/connectors/*.jsonc - תצורות OAuth connector (אופציונלי)
  • src/api/base44Client.js - SDK client מוגדר מראש לשימוש ב-frontend
דוגמת config.jsonc:
מאפייני תצורה:

התקנה

התקן את Base44 CLI כתלות dev בפרויקט שלך:
חשוב: לעולם אל תניח או תקבע את גרסת חבילת base44. תמיד התקן בלי מציין גרסה כדי לקבל את הגרסה האחרונה. ואז הרץ פקודות באמצעות npx:
הערה: כל הפקודות בתיעוד זה משתמשות ב-npx base44. ניתן גם להשתמש ב-yarn base44, או pnpm base44 אם מועדף.

אפשרות --app-id גלובלית

ל-CLI יש אפשרות גלובלית --app-id <id> עבור פקודות שצריכות רק הקשר של אפליקציה, לא קבצי פרויקט מקומיים. סדר פתרון: דגל --app-id → משתנה סביבה BASE44_APP_IDbase44/.app.jsonc מקומי זה שימושי כשאתה רוצה לבדוק או לפעול על אפליקציה מבלי לעבור לתיקיית פרויקט מקושרת. דוגמאות נפוצות:
השתמש ב---app-id לפקודות ברמת אפליקציה כמו exec ו-logs. אל תשתמש ב---app-id לפקודות שצריכות קבצי פרויקט מקומיים:
  • base44 create יוצר אפליקציה חדשה, אז הוא דוחה --app-id
  • base44 dev רץ מפרויקט מקומי מקושר, אז הוא דוחה --app-id
  • base44 deploy עדיין דורש תיקיית פרויקט מקומית כי הוא קורא משאבים מקומיים

פקודות זמינות

אימות

ניהול פרויקט

פיתוח

פריסה

ניהול Entity

סכמת Entity (הפניה מהירה)

תמיד עקוב אחר המבנה המדויק הזה בעת יצירת קבצי entity: מתן שם לקבצים: base44/entities/{kebab-case-name}.jsonc (למשל, team-member.jsonc עבור TeamMember) תבנית סכמה:
סוגי שדה: string, number, integer, boolean, array, object, binary פורמטי string: date, date-time, time, email, uri, hostname, ipv4, ipv6, uuid, file, regex, richtext עבור enums: הוסף "enum": ["value1", "value2"] ואופציונלית "default": "value1" שמות entity: חייבים להיות אלפאנומריים בלבד (תבנית: /^[a-zA-Z0-9]+$/) לתיעוד מלא, ראה entities-create.md.

ניהול Function

ניהול Agent

Agents הם עוזרי AI שיחתיים שיכולים לתקשר עם משתמשים, לגשת ל-entities של האפליקציה שלך, ולקרוא לפונקציות backend. השתמש בפקודות אלה לניהול תצורות agent. הערה: פקודות agent מבצעות סנכרון מלא - דחיפה מחליפה את כל ה-agents המרוחקים במקומיים, ומשיכה מחליפה את כל ה-agents המקומיים במרוחקים.

סכמת Agent (הפניה מהירה)

מתן שם לקבצים: base44/agents/{agent_name}.jsonc (למשל, support_agent.jsonc) תבנית סכמה:
כללי מתן שמות:
  • שמות agent חייבים להתאים לתבנית: /^[a-z0-9_]+$/ (אלפאנומרי באותיות קטנות עם קווים תחתונים, 1-100 תווים)
  • תקף: support_agent, order_bot
  • לא תקף: Support-Agent, OrderBot
שדות נדרשים: name, description, instructions שדות אופציונליים: tool_configs (ברירת מחדל []), whatsapp_greeting סוגי tool config:
  • Entity tools: entity_name + allowed_operations (מערך של: read, create, update, delete)
  • Backend function tools: function_name + description

ניהול Connector

Connectors מאפשרים לאפליקציה שלך להתחבר לשירותים חיצוניים (Google Calendar, Slack, Stripe וכו’). רוב ה-connectors משתמשים ב-OAuth כדי לספק access tokens לפונקציות backend לקרוא ל-APIs חיצוניים. Stripe הוא החריג — הוא מוקצה אוטומטית בצד השרת ללא זרימת OAuth בדפדפן. הערה: פקודות connector מבצעות סנכרון מלא - דחיפה מחליפה את כל ה-connectors המרוחקים במקומיים (ומפעילה OAuth עבור connectors חדשים של OAuth), ומשיכה מחליפה את כל ה-connectors המקומיים במרוחקים.

סכמת Connector (הפניה מהירה)

מתן שם לקבצים: base44/connectors/{type}.jsonc (למשל, googlecalendar.jsonc, slack.jsonc) תבנית סכמה:
שדות נדרשים: type שדות אופציונליים: scopes (ברירת מחדל []) סוגי connector זמינים: הרץ npx base44 connectors list-available כדי לראות את כל סוגי האינטגרציה הנתמכים. הערה: stripe הוא גם סוג connector תקף אך לא מוחזר על ידי list-available. התייחס אליו כסוג נתמך — הוא מוקצה אוטומטית על ידי Base44 ללא זרימת OAuth בדפדפן. ראה connectors-create.md לפרטים. לתיעוד מלא, ראה connectors-create.md.

תצורת Auth

נהל את הגדרות האימות של האפליקציה שלך (למשל, כניסה עם שם משתמש וסיסמה). תצורת Auth מאוחסנת ב-base44/auth/ ומסונכרנת עם Base44 דרך auth push/auth pull. הערה: תצורת Auth נפרסת גם כחלק מ-base44 deploy.

ניהול Secrets

נהל סודות פרויקט (משתני סביבה מאוחסנים בבטחה ב-Base44). פקודות אלה מוסתרות מפלט --help אך מלאות פונקציונליות.

הרצת סקריפט

הרץ סקריפטים חד-פעמיים מול האפליקציה שלך עם Base44 SDK מאומת מראש. השתמש בו לביצוע פעולות CRUD על entities (base44.entities.MyEntity.list/create/update/delete), לקרוא לפונקציות backend (base44.functions.invoke("myFunction", args)), להפעיל agents, או לגשת לכל משאב אחר שנחשף על ידי ה-SDK — מבלי לפרוס פונקציה מלאה. שימושי להעברת נתונים, פעולות בכמות, ניפוי באגים וזרימות עבודה מסוגלות סקריפט.

יצירת סוגים

פלט: base44/.types/types.d.ts — מרחיב את מודול @base44/sdk עם רישומים מוקלדים (EntityTypeRegistry, FunctionNameRegistry, AgentNameRegistry, ConnectorTypeRegistry). לא נדרש אימות. רץ כולו מקומית. מעדכן אוטומטית את tsconfig.json לכלול את הסוגים שנוצרו.

ניהול Site

SPA בלבד: אירוח Base44 תומך ב-Single Page Applications עם נקודת כניסה יחידה index.html. כל הנתיבים מוגשים מ-index.html (client-side routing).

התחלה מהירה

  1. התקן את ה-CLI בפרויקט שלך:
  2. אמת עם Base44:
  3. צור פרויקט חדש (תמיד ספק שם ודגל --path):
  4. הרץ פיתוח מקומי:
  5. בנה ופרוס הכל:
או פרוס משאבים בודדים:
  • npx base44 entities push - דחוף entities בלבד
  • npx base44 functions deploy - פרוס functions בלבד
  • npx base44 functions delete <name> - מחק פונקציה שנפרסה
  • npx base44 functions list - פרט את כל הפונקציות שנפרסו
  • npx base44 functions pull - משוך פונקציות שנפרסו לקבצים מקומיים
  • npx base44 agents push - דחוף agents בלבד
  • npx base44 connectors pull - משוך connectors מ-Base44
  • npx base44 connectors push - דחוף connectors בלבד
  • npx base44 auth pull - משוך תצורת auth מ-Base44
  • npx base44 auth push - דחוף תצורת auth בלבד
  • npx base44 site deploy -y - פרוס site בלבד

זרימות עבודה נפוצות

יצירת פרויקט חדש

⚠️ חובה: לפני הרצת base44 create, אתה חייב לקרוא את create.md עבור:
  • בחירת תבנית - בחר את התבנית הנכונה (backend-and-client לעומת backend-only)
  • זרימת עבודה נכונה - תבניות שונות דורשות שלבי הגדרה שונים
  • מכשולים נפוצים - הימנע משגיאות יצירת תיקייה שגורמות לכישלונות
כישלון בעקיבה אחר הוראות create.md יביא ל-scaffolding פרויקט שבור.

קישור פרויקט קיים

הרצת פיתוח מקומי

אם ברצונך ש-base44 dev יריץ גם את ה-frontend שלך, אמת ש-base44/config.jsonc כולל site.serveCommand מוגדר נכון (לדוגמה, "serveCommand": "npm run dev"). כאשר שדה זה קיים, base44 dev מריץ הן את ה-backend והן את ה-frontend יחד.

פריסת כל השינויים

יצירת סוגי TypeScript

זה יוצר base44/.types/types.d.ts עם רישומים מוקלדים עבור מודול @base44/sdk. הרץ זאת לאחר שינוי entities, functions, agents, או connectors כדי לשמור את הסוגים שלך מסונכרנים. אין צורך באימות.

פריסת משאבים בודדים

פתיחת לוח

אימות

רוב הפקודות דורשות אימות. אם אינך מחובר, ה-CLI יבקש ממך אוטומטית להתחבר. הסשן שלך נשמר מקומית ונמשך בין סשני CLI.

פתרון בעיות

דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.