Vai al contenuto principale
Le app sono attualmente in fase alfa. La funzionalità è funzionante ma ancora in evoluzione.

​
Panoramica

Una volta che la tua app è stata compilata e testata localmente, hai due modalità per distribuirla:
  • Pubblica su npm — elenca la tua app nel marketplace di Twenty affinché qualsiasi spazio di lavoro possa scoprirla e installarla.
  • Esegui il push di un tarball — distribuisci la tua app su un server Twenty specifico per uso interno senza renderla pubblicamente disponibile.

​
Pubblicazione su npm

La pubblicazione su npm rende la tua app scopribile nel marketplace di Twenty. Qualsiasi spazio di lavoro Twenty può sfogliare, installare e aggiornare le app del marketplace direttamente dall’interfaccia utente.

​
Requisiti

  • Un account npm
  • Il nome del tuo pacchetto deve usare il prefisso twenty-app- (es. twenty-app-postcard-sender)

​
Passaggi

  1. Compila la tua app — la CLI compila i tuoi sorgenti TypeScript e genera il manifest dell’applicazione:
yarn twenty app:build
  1. Pubblica su npm — esegui il push del pacchetto compilato al registro npm:
npx twenty app:publish

​
Rilevamento automatico

I pacchetti con il prefisso twenty-app- vengono rilevati automaticamente dal catalogo del marketplace di Twenty. Una volta pubblicata, la tua app compare nel marketplace entro pochi minuti — non è richiesta alcuna registrazione o approvazione manuale.

​
Pubblicazione con CI

Il progetto generato include un workflow di GitHub Actions che pubblica a ogni release. Esegue app:build, quindi npm publish --provenance dall’output di build: 
name: Publish
on:
  release:
    types: [published]

permissions:
  contents: read
  id-token: write

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "24"
          registry-url: https://registry.npmjs.org
      - run: yarn install --immutable
      - run: npx twenty app:build
      - run: npm publish --provenance --access public
        working-directory: .twenty/output
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
Per altri sistemi CI (GitLab CI, CircleCI, ecc.), si applicano gli stessi tre comandi: yarn install, npx twenty app:build, quindi npm publish da .twenty/output.
npm provenance è opzionale ma consigliata. La pubblicazione con --provenance aggiunge un badge di attendibilità alla tua scheda npm, consentendo agli utenti di verificare che il pacchetto sia stato creato a partire da uno specifico commit in una pipeline CI pubblica. Consulta la documentazione su npm provenance per le istruzioni di configurazione.

​
Distribuzione interna

Per le app che non vuoi rendere pubbliche — strumenti proprietari, integrazioni solo per l’azienda o build sperimentali — puoi eseguire il push di un tarball direttamente su un server Twenty.

​
Push di un tarball

Compila la tua app e distribuiscila su un server specifico in un solo passaggio: 
npx twenty app:publish --server <server-url>
Qualsiasi spazio di lavoro su quel server può quindi installare e aggiornare l’app dalla pagina delle impostazioni Applicazioni.

​
Gestione delle versioni

Per rilasciare un aggiornamento:
  1. Incrementa il campo version nel tuo package.json
  2. Esegui il push di un nuovo tarball con npx twenty app:publish --server <server-url>
  3. Gli spazi di lavoro su quel server vedranno l’aggiornamento disponibile nelle proprie impostazioni
Le app interne sono limitate al server su cui vengono caricate. Non compariranno nel marketplace pubblico e non potranno essere installate dagli spazi di lavoro su altri server.

​
Categorie di app

Twenty organizza le app in tre categorie in base a come vengono distribuite:
CategoriaCome funzionaVisibile nel marketplace?
SviluppoApp in modalità di sviluppo locale eseguite tramite yarn twenty app:dev. Usate per la compilazione e i test.No
PubblicataApp pubblicate su npm con il prefisso twenty-app-. Elencate nel marketplace per l’installazione da parte di qualsiasi spazio di lavoro.Sì
InternaApp distribuite tramite tarball su un server specifico. Disponibili solo per gli spazi di lavoro su quel server.No
Inizia in modalità Sviluppo mentre crei la tua app. Quando è pronta, scegli Pubblicata (npm) per un’ampia distribuzione oppure Interna (tarball) per una distribuzione privata.