> ## 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.

# React gyors kezdés

> Base44-backend hozzáadása React-projekthez

Kövesse ezt a gyors kezdési útmutatót a Base44 React-projekthez való hozzáadásához. Létrehoz egy Base44-backendet, entitásokat definiál, és integrálja az SDK-t a frontendbe.

> [!NOTE]
>
> A CLI-hez Node.js 20.19.0 vagy újabb verzió szükséges.

## Beállítás

**1. A Base44 CLI telepítése**

Telepítse globálisan a Base44 CLI-t:

```bash theme={null}
npm install -g base44@latest
```

**2. Base44-backend létrehozása**

Lépjen a React-projekt könyvtárába, majd futtassa:

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

Ha még nincs bejelentkezve, a parancs hitelesítést kér.

Amikor a rendszer kéri, válassza a **Create a basic project** lehetőséget. Ez létrehozza a backend-fájlokat a React-projekt könyvtárában. Ezután kövesse az utasításokat a projekt konfigurálásához.

Projekt létrehozásakor a [Base44 skillek](https://docs.base44.com/hu/developers/backend/overview/skills.md) automatikusan bekerülnek, így MI-ügynöke utasításokat és kontextust kap a Base44-feladatokhoz.

**3. A webhely konfigurálása**

Frissítse a [config.jsonc](https://docs.base44.com/hu/developers/backend/overview/project-structure.md#config-jsonc) fájlt, hogy a React build kimenetére mutasson, és állítsa be a buildelési és kiszolgálási parancsokat. Adja hozzá a `site.outputDirectory`, a `site.buildCommand` és a `site.serveCommand` mezőt:

```json theme={null}
{
  "site": {
    "outputDirectory": "dist",
    "buildCommand": "npm run build",
    "serveCommand": "npm run dev"
  }
}
```

Ha a `serveCommand` be van állítva, a [`base44 dev`](https://docs.base44.com/developers/references/cli/commands/dev) egyetlen terminálból együtt indítja a backendet és a frontendet. Ha a `buildCommand` be van állítva, a [`base44 build`](https://docs.base44.com/developers/references/cli/commands/build) az alkalmazásazonosító beillesztésével fordítja le a frontendet.

**4. Entitások definiálása**

Hozzon létre [entitássémákat](https://docs.base44.com/hu/developers/backend/resources/entities/overview.md) az adatszerkezetek definiálásához. Az entitásfájlokat a `base44/entities/` könyvtárban kell elhelyezni.

Hozza létre például a `base44/entities/task.jsonc` fájlt:

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

**5. Az entitások feltöltése a Base44-be**

Töltse fel az entitássémákat a Base44-be:

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

Ez a parancs szinkronizálja a helyi entitásdefiníciókat a Base44-backenddel, így használhatók lesznek az alkalmazásban. További információ: [`entities push`](https://docs.base44.com/developers/references/cli/commands/entities-push).

**6. A Base44 SDK telepítése**

Telepítse a Base44 JavaScript SDK-t:

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

**7. Base44-kliens létrehozása**

Hozzon létre egy Base44 SDK-[klienst](https://docs.base44.com/developers/references/sdk/getting-started/client.md) a projektben. Az alkalmazásazonosítót a `VITE_BASE44_APP_ID` változóból olvassa ki, amelyet a [`base44 build`](https://docs.base44.com/developers/references/cli/commands/build) és a [`base44 dev`](https://docs.base44.com/developers/references/cli/commands/dev) automatikusan beállít.

Hozza létre például az `src/api/base44Client.js` fájlt:

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

export const base44 = createClient({
  appId: import.meta.env.VITE_BASE44_APP_ID,
});
```

A `VITE_BASE44_APP_ID` a kapcsolt alkalmazás azonosítóját tartalmazza, amelyet a CLI a `base44/.app.jsonc` fájlból olvas ki.

**8. Az SDK használata a frontendben**

Hozzon létre egy egyszerű komponenst a feladatok listázásához és hozzáadásához. Hozza létre például az `src/components/TaskList.jsx` fájlt:

```jsx theme={null}
import { useState, useEffect } from 'react';
import { base44 } from '../api/base44Client';

export default function TaskList() {
  const [tasks, setTasks] = useState([]);
  const [newTaskTitle, setNewTaskTitle] = useState('');
  const [isLoading, setIsLoading] = useState(false);

  useEffect(() => {
    loadTasks();
  }, []);

  const loadTasks = async () => {
    setIsLoading(true);
    try {
      // Get records
      const taskList = await base44.entities.Task.list();
      setTasks(taskList);
    } catch (error) {
      console.error('Error loading tasks:', error);
    }
    setIsLoading(false);
  };

  const addTask = async (e) => {
    e.preventDefault();
    if (!newTaskTitle.trim()) return;

    setIsLoading(true);
    try {
      // Create a record
      const newTask = await base44.entities.Task.create({
        title: newTaskTitle,
        completed: false
      });
      setTasks([...tasks, newTask]);
      setNewTaskTitle('');
    } catch (error) {
      console.error('Error creating task:', error);
    }
    setIsLoading(false);
  };

  return (
    <div>
      <h1>Tasks</h1>

      {isLoading && <p>Loading...</p>}

      <ul>
        {tasks.map((task) => (
          <li key={task.id}>{task.title}</li>
        ))}
      </ul>

      <form onSubmit={addTask}>
        <input
          type="text"
          value={newTaskTitle}
          onChange={(e) => setNewTaskTitle(e.target.value)}
          placeholder="New task"
          disabled={isLoading}
        />
        <button type="submit" disabled={isLoading || !newTaskTitle.trim()}>
          Add Task
        </button>
      </form>
    </div>
  );
}
```

> [!NOTE]
>
> Az SDK hívásakor pontosan a sémában szereplő entitásnevet használja, a kis- és nagybetűkkel együtt. Az entitásnevek megállapodás szerint nagybetűvel kezdődnek. Ha például a sémában `"name": "Task"` szerepel, így érheti el: `base44.entities.Task.list()`.

**9. Az alkalmazás helyi futtatása**

Az integráció teszteléséhez indítsa el a Vite fejlesztői szervert. A projekt gyökérkönyvtárából futtassa:

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

A React-projekt az SDK-kliensen keresztül csatlakozik a Base44-backendhez, így valós időben dolgozhat a telepített entitásokkal.

**10. A frontend buildelése és telepítése**

Buildelje a React-projektet éles használatra az alkalmazásazonosító beillesztésével, majd telepítse:

```bash theme={null}
base44 build
base44 deploy
```

A `base44 build` a `buildCommand` parancsot futtatja úgy, hogy a `VITE_BASE44_APP_ID` a kapcsolt alkalmazás azonosítójára van állítva. A `base44 deploy` feltölti a lefordított fájlokat és az entitássémák frissítéseit. Ha elkészült, látja a Base44 irányítópultjára mutató hivatkozást és az élő alkalmazás URL-jét.

## Következő lépések

Most, hogy a Base44-backend integrálva van a projektbe, a következőket teheti:

* Az [SDK](https://docs.base44.com/developers/references/sdk/getting-started/overview.md) segítségével további funkciókat adhat a frontendhez.
* Adjon hozzá [entitásokat](https://docs.base44.com/hu/developers/backend/resources/entities/overview.md), [backend-függvényeket](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md) és [ügynököket](https://docs.base44.com/hu/developers/backend/resources/agents/overview.md). TypeScript használata esetén [generáljon típusokat](https://docs.base44.com/developers/references/sdk/getting-started/dynamic-types.md) az automatikus kiegészítéshez és a típusbiztonsághoz.
* Teszteljen helyben a [`base44 dev`](https://docs.base44.com/developers/references/cli/commands/dev) paranccsal. A beállítási útmutatót a [Helyi fejlesztés](https://docs.base44.com/hu/developers/backend/overview/local-dev/local-development-overview.md) oldalon találja.
* Építse tovább a frontendet, és telepítse a frissítéseket a [`base44 deploy`](https://docs.base44.com/developers/references/cli/commands/deploy) paranccsal.
* Nyissa meg a telepített webhelyet a [`base44 site open`](https://docs.base44.com/developers/references/cli/commands/site-open) paranccsal.

## Lásd még

* [CLI-parancsreferencia](https://docs.base44.com/developers/references/cli/commands/introduction.md): Az összes elérhető CLI-parancs
* [Projektstruktúra](https://docs.base44.com/hu/developers/backend/overview/project-structure.md): A projektfájlok felépítése
* [JavaScript SDK dokumentáció](https://docs.base44.com/developers/references/sdk/getting-started/overview.md): Az alkalmazás csatlakoztatása a backendhez
* [Base44 skillek](https://docs.base44.com/hu/developers/backend/overview/skills.md): Az MI-asszisztensek megtanítása a Base44-gyel való munkára

> [!NOTE]
>
> Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az [angol nyelvű változatot](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.