Publicare

Documentation Index

Fetch the complete documentation index at: https://docs.twenty.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Prezentare generală

• Implementează un tarball — încarcă aplicația direct pe un server Twenty anume pentru uz intern sau privat.
• Publică pe npm — listează aplicația ta în marketplace-ul Twenty pentru ca orice spațiu de lucru să o poată descoperi și instala.

​

Construirea aplicației

yarn twenty build

​

Implementare pe un server (tarball)

​

Cerințe

yarn twenty remote add --api-url https://your-twenty-server.com --as production

​

Implementare

yarn twenty deploy
# To deploy to a specific remote:
# yarn twenty deploy --remote production

​

Partajarea unei aplicații implementate

1. Mergi la Setări > Aplicații > Înregistrări și deschide aplicația ta
2. În fila Distribuție, fă clic pe Copiază linkul de partajare
3. Partajează acest link cu utilizatori din alte spații de lucru — îi duce direct la pagina de instalare a aplicației

​

Gestionarea versiunilor

1. Incrementează câmpul version din package.json (de ex. 1.2.3 → 1.2.4, 1.3.0 sau 2.0.0)
2. Rulează yarn twenty deploy (sau yarn twenty deploy --remote production)
3. Spațiile de lucru care au aplicația instalată vor vedea actualizarea disponibilă în setările lor

​

Compatibilitatea versiunii serverului

{
  "name": "twenty-my-app",
  "version": "1.0.0",
  "engines": {
    "node": "^24.5.0",
    "twenty": ">=2.3.0"
  }
}

• Dacă engines.twenty este setat și versiunea serverului țintă nu respectă intervalul, implementarea (încărcarea arhivei tarball) sau instalarea este respinsă cu eroarea SERVER_VERSION_INCOMPATIBLE și cu un mesaj care indică atât intervalul necesar, cât și versiunea efectivă a serverului.
• Dacă engines.twenty nu este setat, aplicația este acceptată pe orice versiune de server (retrocompatibilă cu aplicațiile existente).
• Dacă serverul nu are nicio APP_VERSION configurată, verificarea este omisă.

​

CI/CD automatizat (fluxuri de lucru preconfigurate)

​

CI — ci.yml

1. Preia codul sursă al aplicației.
2. Pornește o instanță de test Twenty izolată folosind acțiunea compozită twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main (echivalentul din CI al yarn twenty server start --test).
3. Activează Corepack, configurează Node.js pe baza fișierului .nvmrc și instalează dependențele cu yarn install --immutable.
4. Rulează yarn test, transmitând TWENTY_API_URL și TWENTY_API_KEY din instanța pornită, astfel încât testele să poată comunica cu un server real.

• TWENTY_VERSION (variabilă de mediu, implicit latest) — fixează versiunea serverului Twenty folosită în CI editând acest parametru în ci.yml.
• Concurența este grupată după github.ref și anulează execuțiile în desfășurare la noile push-uri.

​

CD — cd.yml

1. Preia head-ul PR-ului (pentru PR-urile etichetate) sau commitul împins.
2. Rulează twentyhq/twenty/.github/actions/deploy-twenty-app@main — echivalentul din CI al yarn twenty deploy.
3. Rulează twentyhq/twenty/.github/actions/install-twenty-app@main astfel încât versiunea nou implementată să fie instalată în spațiul de lucru țintă.

​

Fixarea acțiunilor reutilizabile

​

Publicarea pe npm

​

Cerințe

• Un cont npm
• Cuvântul cheie twenty-app din array-ul keywords al fișierului package.json (adaugă-l manual — nu este inclus în mod implicit în șablonul create-twenty-app)

{
  "name": "twenty-app-postcard-sender",
  "version": "1.0.0",
  "keywords": ["twenty-app"]
}

​

Metadate pentru marketplace

export default defineApplication({
  universalIdentifier: '...',
  displayName: 'My App',
  description: 'A great app',
  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
  logoUrl: 'public/logo.png',
  screenshots: [
    'public/screenshot-1.png',
    'public/screenshot-2.png',
  ],
});

​

Dimensiuni recomandate pentru capturi de ecran

​

Publicare

yarn twenty publish

yarn twenty publish --tag beta

​

Cum funcționează descoperirea în marketplace

yarn twenty server catalog-sync
# To target a specific remote:
# yarn twenty server catalog-sync --remote production

​

Publicare CI

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 build
      - run: npm publish --provenance --access public
        working-directory: .twenty/output

​

Instalarea aplicațiilor

yarn twenty install