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

# Estrutura do Projeto

> Entenda a organização e os arquivos principais do seu projeto de app Base44

Os apps Base44 são apps React padrão construídos com Vite. Seu projeto inclui ferramentas modernas de desenvolvimento web e integração perfeita com o backend da Base44.

## Estrutura do projeto

No [Code Tab](../editor/code-tab) e quando você [conecta ao GitHub](../local-development/github), você verá a estrutura completa do projeto React/Vite:

<Tree>
  <Tree.Folder name="src" defaultOpen>
    <Tree.Folder name="pages" />

    <Tree.Folder name="components">
      <Tree.Folder name="ui" />
    </Tree.Folder>

    <Tree.Folder name="api" />

    <Tree.Folder name="hooks" />

    <Tree.Folder name="lib" />

    <Tree.Folder name="utils" />
  </Tree.Folder>

  <Tree.Folder name="entities" />

  <Tree.Folder name="functions" />

  <Tree.File name="package.json" />

  <Tree.File name="vite.config.js" />

  <Tree.File name="tailwind.config.js" />

  <Tree.File name="index.html" />
</Tree>

### Diretórios do projeto

Seu projeto contém os seguintes diretórios:

* **`src/`** - Código do frontend do app organizado nos seguintes diretórios:
  * `pages` - As páginas do seu app. Cada arquivo é uma rota. `Home.jsx` se torna `/`, `Settings.jsx` se torna `/settings`.
  * `components` - Elementos de UI reutilizáveis. A subpasta `ui/` contém componentes de UI pré-construídos.
  * `api` - Configuração do cliente SDK da Base44 para comunicação com seu backend.
  * `hooks` - Hooks React customizados para UI e gerenciamento de estado.
  * `lib` - Código de integração com a Base44 e configuração do app.
  * `utils` - Funções utilitárias e métodos auxiliares.

* **`entities/`** - Suas definições de modelo de dados. Cada entidade tem um arquivo de schema JSON que define seus campos.

* **`functions/`** - Funções de backend para lógica de servidor. Cada arquivo TypeScript neste diretório é uma função separada.

<Note>
  **Entidades:** Ao usar a integração bidirecional com GitHub, as entidades são gerenciadas na Base44 e não são incluídas no seu repositório local.
</Note>

### Arquivos de configuração

O diretório raiz inclui toda a configuração necessária para rodar de forma independente:

* `package.json` - Dependências e scripts (inclui @base44/sdk)
* `vite.config.js` - Configuração de build com o plugin Base44
* `tailwind.config.js` - Configuração de estilização
* `index.html` - Ponto de entrada HTML principal

## Rodar localmente

Para rodar o projeto exportado localmente: `npm install` e depois `npm run dev`.

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>