> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hono Quickstart

> הוסף את Base44 לפרויקט Hono שלך

עקוב אחר ה-quickstart הזה כדי להוסיף את Base44 לפרויקט Hono שלך. תיצור בקאנד Base44, תגדיר entities, ותשלב את ה-SDK ב-API routes שלך.

<Note>ה-CLI דורש Node.js 20.19.0 ומעלה.</Note>

## הגדרה

<Steps>
  <Step title="התקן את Base44 CLI">
    התקן את Base44 CLI גלובלית:

    ```bash theme={null}
    npm install -g base44@latest
    ```
  </Step>

  <Step title="צור בקאנד Base44">
    נווט לתיקיית פרויקט Hono שלך, ולאחר מכן הרץ:

    ```bash theme={null}
    base44 create
    ```

    אם אתה לא מחובר כבר, הפקודה תבקש ממך לבצע אימות.

    בחר **Create a basic project** כשתתבקש. פעולה זו יוצרת את קבצי הבקאנד בתוך תיקיית פרויקט Hono שלך. לאחר מכן עקוב אחר ההוראות להגדיר את הפרויקט שלך.

    כאשר אתה יוצר פרויקט, [Base44 skills](/developers/backend/overview/base44-skills) נכללים אוטומטית, ומספקים לסוכן ה-AI שלך הוראות והקשר עבור משימות Base44.
  </Step>

  <Step title="הגדר את ספריית הפלט (אופציונלי)">
    אם אתה מגיש קבצים סטטיים עם Hono, עדכן את [config.jsonc](/developers/backend/overview/project-structure) כדי להצביע על ה-build output שלך. הוסף או שנה את שדה `site.outputDirectory`:

    ```json theme={null}
    {
      "site": {
        "outputDirectory": "dist"
      }
    }
    ```

    <Note>
      אם אתה בונה API נקי עם Hono ולא מגיש frontend, ניתן לדלג על תצורת `outputDirectory` או להשמיט שלב זה.
    </Note>
  </Step>

  <Step title="הגדר entities">
    צור [entity schemas](/developers/references/entities/introduction) כדי להגדיר את מבני הנתונים שלך. קבצי entity חייבים להיות ממוקמים בתיקיית `base44/entities/`.

    לדוגמה, צור את `base44/entities/task.jsonc`:

    ```json theme={null}
    {
      "name": "Task",
      "type": "object",
      "properties": {
        "title": {
          "type": "string"
        },
        "completed": {
          "type": "boolean",
          "default": false
        }
      },
      "required": ["title"]
    }
    ```
  </Step>

  <Step title="דחוף entities ל-Base44">
    דחוף את ה-entity schemas שלך ל-Base44:

    ```bash theme={null}
    base44 entities push
    ```

    פקודה זו מסנכרנת את הגדרות ה-entity המקומיות שלך עם הבקאנד Base44 שלך, ומאפשרת אותן לשימוש באפליקציה שלך. ראה [`entities push`](/developers/references/cli/commands/entities-push) למידע נוסף.
  </Step>

  <Step title="התקן את Base44 SDK">
    התקן את Base44 JavaScript SDK:

    ```bash theme={null}
    npm install @base44/sdk
    ```
  </Step>

  <Step title="צור לקוח Base44">
    צור [client](/developers/references/sdk/getting-started/client) של Base44 SDK בפרויקט שלך. ה-`appId` ניתן למצוא בקובץ `base44/.app.jsonc` שלך.

    לדוגמה, צור את `lib/base44.js`:

    ```javascript theme={null}
    import { createClient } from '@base44/sdk';

    export const base44 = createClient({
      appId: 'your-app-id-from-app.jsonc'
    });
    ```
  </Step>

  <Step title="השתמש ב-SDK ב-API routes שלך">
    השתמש ב-Base44 SDK כדי לתקשר עם [entities](/developers/references/sdk/docs/type-aliases/entities) שלך ב-route handlers של Hono. לדוגמה:

    ```javascript theme={null}
    import { Hono } from 'hono';
    import { base44 } from './lib/base44Client';

    const app = new Hono();

    // Get all tasks
    app.get('/api/tasks', async (c) => {
      const tasks = await base44.entities.Task.list();
      return c.json(tasks);
    });

    // Create a new task
    app.post('/api/tasks', async (c) => {
      const body = await c.req.json();
      const newTask = await base44.entities.Task.create({
        title: body.title,
        completed: false
      });
      return c.json(newTask, 201);
    });

    export default app;
    ```

    <Note>
      השתמש בשם ה-entity המדויק מה-schema שלך בעת קריאה ל-SDK, כולל אותיות גדולות. לפי המוסכמה, שמות entities מתחילים באות גדולה. לדוגמה, אם ל-schema שלך יש `"name": "Task"`, אתה ניגש אליו כ-`base44.entities.Task.list()`.
    </Note>
  </Step>

  <Step title="הרץ את ה-API שלך מקומית">
    התחל את שרת הפיתוח של Hono כדי לבדוק את האינטגרציה שלך. משורש הפרויקט שלך, הרץ:

    ```bash theme={null}
    npm run dev
    ```

    ה-API של Hono שלך יתחבר לבקאנד Base44 דרך לקוח SDK, ויאפשר לך לעבוד עם ה-entities המופצות שלך בזמן אמת.
  </Step>
</Steps>

## השלבים הבאים

עכשיו שהבקאנד Base44 שלך משולב בפרויקט שלך, אתה יכול:

* להשתמש ב-[SDK](/developers/references/sdk/getting-started/overview) כדי להוסיף עוד פונקציונליות ל-API שלך.
* להוסיף [entities](/developers/backend/resources/entities/overview), [backend functions](/developers/backend/resources/functions), ו-[agents](/developers/backend/resources/agents-config). אם אתה עובד ב-TypeScript, [ייצר types](/developers/references/sdk/getting-started/dynamic-types) כדי לקבל autocomplete ובטיחות סוגים.
* לבדוק באופן מקומי על ידי הרצת [`base44 dev`](/developers/references/cli/commands/dev) עבור הבקאנד Base44 לצד שרת הפיתוח של Hono שלך. ראה [Local development](/developers/backend/overview/local-dev/local-development-overview) להוראות הגדרה.
* להמשיך לבנות את ה-API שלך ולפרוס אותו בהתאם ל-runtime שבחרת.

## ראה גם

* [CLI Command Reference](/developers/references/cli/commands/introduction): כל פקודות ה-CLI הזמינות
* [Project Structure](/developers/backend/overview/project-structure): כיצד קבצי הפרויקט מאורגנים
* [JavaScript SDK Documentation](/developers/references/sdk/getting-started/overview): חבר את האפליקציה שלך לבקאנד
* [Base44 Skills](/developers/backend/overview/base44-skills): למד עוזרי AI לעבוד עם Base44

<Note>דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](/). </Note>
