Struttura del progetto

Il comando create della CLI di Base44 crea nuovi progetti con tutti i file e la configurazione necessari. Questo articolo descrive la struttura di un progetto backend Base44 e spiega cosa fa ogni file e directory.

Struttura del progetto backend

Quando crei un progetto Base44 solo backend, la CLI genera questa struttura minima:

<your-project-name>

base44

.app.jsonc

config.jsonc

.gitignore

Man mano che sviluppi il tuo progetto, aggiungi file per le tue risorse come entità, funzioni, agenti, connettori e configurazione auth:

<your-project-name>

base44

.app.jsonc

config.jsonc

.types

types.d.ts

agents

<agent-name>.jsonc

auth

config.jsonc

connectors

<connector-type>.jsonc

entities

<entity-name>.jsonc

functions

<function-name>

entry.ts

function.jsonc

.gitignore

Le funzioni richiedono solo un file entry.ts o entry.js. Puoi opzionalmente aggiungere function.jsonc per configurazioni avanzate come nomi personalizzati o automazioni. Consulta Funzioni backend per i dettagli.

base44/

Contiene tutta la configurazione e le definizioni delle risorse backend di Base44.

config.jsonc

Definisce la configurazione del tuo progetto, inclusi i percorsi verso entità, funzioni, agenti, connettori, configurazione auth e le impostazioni di hosting del sito per progetti full-stack. La CLI lo crea solo con il nome del tuo progetto e puoi aggiungere altra configurazione secondo necessità. Quando visibility è impostato qui, deploy lo applica al server a ogni esecuzione. Il tuo progetto richiede un file config.jsonc (o config.json) nella directory base44/:

// Base44 Project Configuration
{
  "name": "my-project",
  "description": "My Base44 app",
  "visibility": "private",        // optional: public | private | workspace

  // Directory paths (relative to config file)
  "entitiesDir": "./entities",
  "functionsDir": "./functions",
  "agentsDir": "./agents",
  "connectorsDir": "./connectors",
  "authDir": "./auth",

  // Site/hosting configuration (for full-stack projects)
  "site": {
    "outputDirectory": "./dist", // Required - relative to the project root, not to this file
  },
}

Proprietà	Descrizione	Predefinito
`name`	Nome del progetto (richiesto)	—
`description`	Descrizione del progetto	—
`visibility`	Livello di accesso per l’app pubblicata. Usa `public` per un’app che chiunque può aprire senza login, `private` per limitare l’accesso agli utenti invitati, oppure `workspace` per limitare l’accesso ai membri del workspace.	—
`entitiesDir`	Percorso alla directory delle entità	`./entities`
`functionsDir`	Percorso alla directory delle funzioni	`./functions`
`agentsDir`	Percorso alla directory degli agenti	`./agents`
`connectorsDir`	Percorso alla directory dei connettori	`./connectors`
`authDir`	Percorso alla directory della configurazione auth	`./auth`
`site`	Configurazione del frontend. Ometti per i progetti solo backend.	—
`site.outputDirectory`	Dove si trovano i file compilati del tuo sito. Richiesto per `site deploy`. Viene risolto dalla root del progetto (la directory che contiene `base44/`), non dal file di configurazione come i percorsi delle directory sopra. Corrisponde a dove il tuo strumento di build frontend scrive l’output.	—
`site.buildCommand`	Comando eseguito da `build`, `deploy --build`, `site deploy --build` ed `eject` per compilare il sito con `VITE_BASE44_APP_ID` iniettata.	—
`site.installCommand`	Comando eseguito da `create`, `scaffold` ed `eject` per installare le dipendenze prima della build.	—
`site.serveCommand`	Comando usato da `base44 dev` per avviare il tuo dev server frontend insieme al backend locale.	—

.app.jsonc

Collega il tuo progetto locale alla tua app Base44. Questo file viene creato automaticamente dalla CLI quando crei o colleghi un progetto. I singoli comandi CLI possono sovrascrivere questo valore predefinito con il flag --app-id o la variabile d’ambiente BASE44_APP_ID. Consulta Seleziona un’app di destinazione.

// Base44 App Configuration
// This file links your local project to your Base44 app.
// Do not commit this file to version control.
{
  "id": "your-app-id",
}

Il file .app.jsonc non deve essere sottoposto a versionamento. La CLI crea automaticamente un file .gitignore che esclude questo file.

.types/types.d.ts

Definizioni di tipo TypeScript generate per le tue entità, funzioni, agenti e connettori. Create eseguendo base44 types generate. Questo file fornisce autocompletamento e sicurezza dei tipi quando usi l’SDK in progetti TypeScript. Consulta Tipi dinamici per maggiori dettagli.

agents/

Directory che contiene le configurazioni degli agenti IA. Ogni agente è definito in un file .json o .jsonc separato.

auth/

Directory che contiene la configurazione di autenticazione della tua app. Contiene un unico file config.jsonc che definisce quali metodi di login sono disponibili per i tuoi utenti finali. Recupera la configurazione corrente da Base44 con auth pull.

connectors/

Directory che contiene le configurazioni dei connettori OAuth. Ogni connettore è definito in un file .json o .jsonc separato che prende il nome dal tipo di integrazione, ad esempio slack.jsonc o googlecalendar.jsonc.

entities/

Directory che contiene le definizioni di schema delle entità. Ogni entità è definita in un file .json o .jsonc separato. Crea questa directory quando sei pronto a definire la tua prima entità.

functions/

Directory che contiene le funzioni backend serverless. Ogni funzione richiede una propria sottodirectory con un file di codice entry.ts o entry.js. La CLI usa il percorso della directory relativo alla root delle funzioni come nome della funzione. Ad esempio, functions/sendEmail/entry.ts crea una funzione chiamata sendEmail. Puoi opzionalmente aggiungere un file di configurazione function.jsonc per personalizzare il nome della funzione o aggiungere automazioni.

functions

<function-name>

entry.ts

function.jsonc

.gitignore

Impedisce che i file vengano sottoposti a versionamento. Il tuo progetto parte con questo file per evitare che .app.jsonc venga sottoposto a versionamento.

Cartelle delle skill degli agenti IA

Quando crei un progetto con base44 create, le skill degli agenti IA vengono installate automaticamente. Compaiono in cartelle specifiche dell’agente come .claude/skills/, .cursor/skills/ o simili, a seconda dell’assistente IA di programmazione che usi. Queste cartelle aiutano il tuo agente di programmazione a capire come lavorare con Base44 e possono essere sottoposte a versionamento in sicurezza.

Vedi anche

Quickstart - Solo backend: crea il tuo primo progetto solo backend
Quickstart - React: costruisci un’app React full-stack con Base44
Comando types generate: genera i tipi TypeScript dal tuo progetto
Tipi dinamici: ottieni la sicurezza dei tipi per il tuo codice SDK
Entità: scopri la configurazione dello schema del database
Funzioni backend: crea endpoint API serverless
Agenti IA: configura gli agenti IA per la tua app
Connettori: configura connessioni OAuth a servizi di terze parti
Configurazione auth: gestisci i metodi di login della tua app

Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.

Panoramica

Guida rapida

Progetto

Strumenti di sviluppo con IA

Risorse