​

Base44 CLI

​

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

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 עדיין

​

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

• npx base44 <command> (npm - מומלץ)
• yarn base44 <command> (yarn)
• pnpm base44 <command> (pnpm)

​

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

1. בדוק סטטוס אימות על ידי הרצת:
   npx base44 whoami
   
2. אם המשתמש מחובר (הפקודה מצליחה ומציגה אימייל):
   • המשך במשימה המבוקשת
3. אם המשתמש אינו מחובר (הפקודה נכשלת או מציגה שגיאה):
   • עצור מיד
   • אל תמשיך עם פעולות CLI כלשהן
   • בקש מהמשתמש להתחבר ידנית על ידי הרצת:
     npx base44 login
     
   - המתן שהמשתמש יאשר שהתחבר לפני שתמשיך
   

​

סקירה כללית

​

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

• יוצר פרויקט 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 קיים
• 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-cli → npx base44 scaffold (הגדר קבצים מקומיים לאפליקציה הקיימת; אל create)
  • ELSE: → השתמש ב-base44-cli → npx base44 create (נדרש אתחול פרויקט חדש)

​

מבנה פרויקט

my-app/
├── base44/                      # Base44 configuration (created by CLI)
│   ├── config.jsonc             # Project settings, site config
│   ├── .types/                  # Auto-generated TypeScript types (created by `types generate`)
│   │   └── types.d.ts           # Module augmentation for @base44/sdk
│   ├── entities/                # Entity schema definitions
│   │   ├── task.jsonc
│   │   └── board.jsonc
│   ├── functions/               # Backend functions (optional)
│   │   └── my-function/
│   │       └── entry.ts
│   ├── agents/                  # Agent configurations (optional)
│   │   └── support_agent.jsonc
│   └── connectors/              # OAuth connector configurations (optional)
│       └── googlecalendar.jsonc
├── src/                         # Frontend source code
│   ├── api/
│   │   └── base44Client.js      # Base44 SDK client
│   ├── pages/
│   ├── components/
│   └── main.jsx
├── index.html                   # SPA entry point
├── package.json
└── vite.config.js               # Or your framework's config

• 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

{
  "name": "My App",                    // Required: project name
  "description": "App description",    // Optional: project description
  "entitiesDir": "./entities",         // Optional: default "entities"
  "functionsDir": "./functions",       // Optional: default "functions"
  "agentsDir": "./agents",             // Optional: default "agents"
  "connectorsDir": "./connectors",     // Optional: default "connectors"
  "site": {                            // Optional: site deployment config
    "installCommand": "npm install",   // Optional: install dependencies
    "buildCommand": "npm run build",   // Optional: build command
    "serveCommand": "npm run dev",     // Optional: local dev server
    "outputDirectory": "./dist"        // Optional: build output directory
  }
}

​

התקנה

npm install --save-dev base44

npx base44 <command>

​

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

# Run a one-off script against a specific app
cat ./script.ts | npx base44 exec --app-id app_123

# Fetch logs for a deployed app without a local checkout
npx base44 logs --app-id app_123 --level error

• base44 create יוצר אפליקציה חדשה, אז הוא דוחה --app-id
• base44 dev רץ מפרויקט מקומי מקושר, אז הוא דוחה --app-id
• base44 deploy עדיין דורש תיקיית פרויקט מקומית כי הוא קורא משאבים מקומיים

​

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

​

אימות

​

ניהול פרויקט

​

פיתוח

​

פריסה

​

ניהול Entity

​

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

{
  "name": "EntityName",
  "type": "object",
  "properties": {
    "field_name": {
      "type": "string",
      "description": "Field description"
    }
  },
  "required": ["field_name"]
}

​

ניהול Function

​

ניהול Agent

​

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

{
  "name": "agent_name",
  "description": "Brief description of what this agent does",
  "instructions": "Detailed instructions for the agent's behavior",
  "tool_configs": [
    // Entity tool - gives agent access to entity operations
    { "entity_name": "tasks", "allowed_operations": ["read", "create", "update", "delete"] },
    // Backend function tool - gives agent access to a function
    { "function_name": "send_email", "description": "Send an email notification" }
  ],
  "whatsapp_greeting": "Hello! How can I help you today?"
}

• שמות agent חייבים להתאים לתבנית: /^[a-z0-9_]+$/ (אלפאנומרי באותיות קטנות עם קווים תחתונים, 1-100 תווים)
• תקף: support_agent, order_bot
• לא תקף: Support-Agent, OrderBot

• Entity tools: entity_name + allowed_operations (מערך של: read, create, update, delete)
• Backend function tools: function_name + description

​

ניהול Connector

​

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

{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}

​

תצורת Auth

​

ניהול Secrets

​

הרצת סקריפט

​

יצירת סוגים

​

ניהול Site

​

התחלה מהירה

1. התקן את ה-CLI בפרויקט שלך:
   npm install --save-dev base44
   
2. אמת עם Base44:
   npx base44 login
   
3. צור פרויקט חדש (תמיד ספק שם ודגל --path):
   npx base44 create my-app --path .
   
4. הרץ פיתוח מקומי:
   npx base44 dev
   
5. בנה ופרוס הכל:
   npm run build
   npx base44 deploy -y
   

• 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 בלבד

​

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

​

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

• בחירת תבנית - בחר את התבנית הנכונה (backend-and-client לעומת backend-only)
• זרימת עבודה נכונה - תבניות שונות דורשות שלבי הגדרה שונים
• מכשולים נפוצים - הימנע משגיאות יצירת תיקייה שגורמות לכישלונות

​

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

# If you have base44/config.jsonc but no .app.jsonc
npx base44 link --create --name my-app

​

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

# Starts the Base44 backend locally
npx base44 dev

​

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

# Generate types (optional, for TypeScript projects)
npx base44 types generate

# Build your project first
npm run build

# Deploy everything (entities, functions, and site)
npx base44 deploy -y

​

יצירת סוגי TypeScript

# Generate types from entities, functions, agents, and connectors
npx base44 types generate

​

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

# Push only entities
npx base44 entities push

# Deploy only functions (all)
npx base44 functions deploy
# Deploy specific functions
npx base44 functions deploy my-function other-function
# Deploy and prune removed functions
npx base44 functions deploy --force

# Push only agents
npx base44 agents push

# Pull connectors from Base44
npx base44 connectors pull

# Push only connectors
npx base44 connectors push

# Deploy only site
npx base44 site deploy -y

​

פתיחת לוח

# Open app dashboard in browser
npx base44 dashboard

​

אימות

​

פתרון בעיות