Publication

​

Vue d’ensemble

• Déployer une archive tar — téléversez votre application directement sur un serveur Twenty spécifique pour un usage interne ou privé.
• Publier sur npm — répertoriez votre application dans la marketplace Twenty pour que tout espace de travail puisse la découvrir et l’installer.

​

Compilation de votre application

yarn twenty dev:build

​

Déploiement sur un serveur (archive tar)

​

Prérequis

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

​

Déploiement

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

​

Partage d’une application déployée

1. Allez dans Paramètres > Applications > Inscriptions et ouvrez votre application
2. Dans l’onglet Distribution, cliquez sur Copier le lien de partage
3. Partagez ce lien avec des utilisateurs sur d’autres espaces de travail — il les amène directement à la page d’installation de l’application

​

Gestion des versions

1. Incrémentez le champ version dans votre package.json (par ex. 1.2.3 → 1.2.4, 1.3.0 ou 2.0.0)
2. Exécutez yarn twenty app:publish --private (ou yarn twenty app:publish --private --remote production)
3. Les espaces de travail qui ont l’application installée verront la mise à niveau disponible dans leurs paramètres

​

Compatibilité des versions du serveur

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

• Si engines.twenty est défini et que la version du serveur cible ne satisfait pas la plage, le déploiement (chargement du tarball) ou l’installation est refusé avec une erreur SERVER_VERSION_INCOMPATIBLE et un message indiquant à la fois la plage requise et la version réelle du serveur.
• Si engines.twenty est non défini, l’application est acceptée sur n’importe quelle version du serveur (rétrocompatible avec les applications existantes).
• Si le serveur n’a pas de APP_VERSION configuré, la vérification est ignorée.

​

CI/CD automatisés (workflows préconfigurés)

​

CI — ci.yml

1. Récupère le code source de votre application.
2. Lance une instance de test Twenty isolée à l’aide de l’action composite twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main (l’équivalent CI de yarn twenty docker:start --test).
3. Active Corepack, configure Node.js à partir de votre .nvmrc et installe les dépendances avec yarn install --immutable.
4. Exécute yarn test, en passant TWENTY_API_URL et TWENTY_API_KEY depuis l’instance lancée pour que vos tests puissent communiquer avec un serveur réel.

• TWENTY_VERSION (variable d’environnement, par défaut latest) — figez la version du serveur Twenty utilisée en CI en la modifiant dans ci.yml.
• La concurrence est regroupée par github.ref et annule les exécutions en cours lors de nouveaux push.

​

CD — cd.yml

1. Récupère la tête de la PR (pour les PR étiquetées) ou le commit poussé.
2. Exécute twentyhq/twenty/.github/actions/deploy-twenty-app@main — l’équivalent CI de yarn twenty app:publish --private.
3. Exécute twentyhq/twenty/.github/actions/install-twenty-app@main afin que la version nouvellement déployée soit installée dans l’espace de travail cible.

​

Épingler les actions réutilisables

​

Publication sur npm

​

Prérequis

• Un compte npm
• Le mot-clé twenty-app dans le tableau keywords de votre package.json (à ajouter manuellement — il n’est pas inclus par défaut dans le modèle create-twenty-app)

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

​

Métadonnées de la marketplace

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

​

Dimensions recommandées pour les captures d’écran

​

Publier

yarn twenty app:publish

yarn twenty app:publish --tag beta

​

Comment fonctionne la découverte de la place de marché

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

​

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

​

Installation des applications

yarn twenty app:install