The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
---
title: Panoramica
description: "Inserisci la tua app all'interno dell'interfaccia utente di Twenty: voci della barra laterale, viste salvate, schede nella pagina di dettaglio dei record e componenti React isolati."
---
import { PageBanner } from "/snippets/page-banner.mdx"
import { CardTitle } from "/snippets/card-title.mdx"
## Cosa copre il livello di disposizione
Il **livello di layout** di un'app Twenty è tutto ciò che l'utente vede: dove l'app viene visualizzata nella barra laterale, quali viste elenco fornisce, come sono organizzate le sue pagine di dettaglio dei record e quali componenti React personalizzati vengono renderizzati all'interno di quelle pagine.
```text
Sidebar Record list Record detail page
─────── ─────────── ──────────────────
[📋 My View] ────▶ ┌──────────┐ ┌─────────────────────┐
[📋 Drafts ] │ Companies│ │ Tabs: [Overview ] │
[📋 Inbox ] │ ──────── │ │ [Notes ] │
▲ │ Apple │ │ [Hello ]◀──── definePageLayoutTab
│ │ Acme │ │ │ adds a tab...
└ defineNavi- │ … │ │ ┌────────────────┐ │
gationMenu- └────▲─────┘ │ │ │ │
Item points │ │ │ React UI │◀── …with a
to a defineView │ │ │ (sandboxed in │ │ defineFrontComponent
└ defineView │ │ a Worker) │ │ widget inside
picks columns │ └────────────────┘ │
and filters └─────────────────────┘
```
## In questa sezione
<CardGroup cols={2} className="documentation-card-group">
<Card href="/it/developers/extend/apps/layout/views" img="/images/documentation/section-overview-icons-v1/views-pipelines.svg">
<CardTitle>Visualizzazioni</CardTitle>
`defineView` — configurazioni dell'elenco salvato: colonne visibili, filtri, gruppi.
</Card>
<Card href="/it/developers/extend/apps/layout/navigation-menu-items" img="/images/user-guide/halftone/card-page-navigation.svg">
<CardTitle>voci del menu di navigazione</CardTitle>
`defineNavigationMenuItem` — voci della barra laterale che puntano a viste o URL esterni.
</Card>
<Card href="/it/developers/extend/apps/layout/page-layouts" img="/images/user-guide/halftone/card-page-page-layouts.svg">
<CardTitle>Page Layouts</CardTitle>
`definePageLayout`, `definePageLayoutTab` e `definePageLayoutWidget` — schede e widget nella pagina di dettaglio di un record.
</Card>
<Card href="/it/developers/extend/apps/layout/front-components" img="/images/user-guide/halftone/card-page-front-components.svg">
Componenti <CardTitle>Front</CardTitle>
`defineFrontComponent` — componenti React sandboxed che rendono all'interno di Venti.
</Card>
<Card href="/it/developers/extend/apps/layout/command-menu-items" img="/images/user-guide/halftone/card-page-command-menu.svg">
<CardTitle>Elementi del menu dei comandi</CardTitle>
`defineCommandMenuItem` — registra i componenti frontali come voci Cmd+K e azioni rapide.
</Card>
</CardGroup>
## Dove viene visualizzata l'app
| Superficie | Cosa controlla | Entità |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **Barra laterale** | Una voce personalizzata che collega a una vista salvata o a un URL esterno | `defineNavigationMenuItem` |
| **Elenco record** | Una configurazione salvata per un oggetto — colonne visibili, ordine, filtri, gruppi | `defineView` |
| **Pagina di dettaglio del record** | Le schede e i widget nella pagina di un record (del tuo oggetto o di un oggetto standard) | `definePageLayout`, `definePageLayoutTab`, `definePageLayoutWidget` |
| **All'interno di uno qualsiasi dei precedenti** | Un widget React personalizzato: pulsanti, moduli, dashboard, integrazioni | `defineFrontComponent` |
| **Impostazioni dell'app** | Una voce nel menu delle impostazioni dell'app; dichiarane quante ne occorrono | `defineSettingsMenuItem` |
| **Menu comandi (Cmd+K)** | Un'azione rapida fissata o un comando nascosto | `defineCommandMenuItem` |
I componenti front-end vengono eseguiti all'interno di un Web Worker isolato usando Remote DOM: vengono renderizzati in modo nativo nella pagina (non all'interno di un iframe), ma non possono accedere direttamente alla pagina host o al DOM. La comunicazione con Twenty avviene tramite un'API host basata sul passaggio di messaggi.
Sono ancora in fase di sviluppo attivo: la sandbox implementa un DOM parziale, quindi gli usi avanzati possono non funzionare. Vedi [Limitazioni attuali](/it/developers/extend/apps/layout/front-components#current-limitations).
<PageBanner illustration="section-apps-layout" />