Publikování

​

Přehled

• Nasaďte tarball — nahrajte svou aplikaci přímo na konkrétní server Twenty pro interní nebo soukromé použití.
• Publish to npm — uveďte svou aplikaci v Marketplace Twenty, aby ji mohl kterýkoli pracovní prostor objevit a nainstalovat.

​

Sestavení vaší aplikace

yarn twenty dev:build

​

Nasazení na server (tarball)

​

Předpoklady

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

​

Nasazení

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

​

Sdílení nasazené aplikace

1. Přejděte do Nastavení > Aplikace > Registrace a otevřete svou aplikaci
2. Na kartě Distribuce klikněte na Zkopírovat odkaz ke sdílení
3. Sdílejte tento odkaz s uživateli v jiných pracovních prostorech — zavede je přímo na instalační stránku aplikace

​

Správa verzí

1. Zvyšte hodnotu pole version v souboru package.json (např. 1.2.3 → 1.2.4, 1.3.0 nebo 2.0.0)
2. Spusťte yarn twenty app:publish --private (nebo yarn twenty app:publish --private --remote production)
3. Pracovní prostory, které mají aplikaci nainstalovanou, uvidí dostupnou aktualizaci ve svém nastavení

​

Kompatibilita verze serveru

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

• Pokud je engines.twenty nastaveno a verze cílového serveru nevyhovuje rozsahu, nasazení (nahrání tarballu) nebo instalace je odmítnuto chybou SERVER_VERSION_INCOMPATIBLE a zprávou, která uvádí jak požadovaný rozsah, tak skutečnou verzi serveru.
• Pokud engines.twenty není nastaveno, aplikace je přijata na jakékoli verzi serveru (zpětně kompatibilní se stávajícími aplikacemi).
• Pokud server nemá nakonfigurované APP_VERSION, kontrola se přeskočí.

​

Automatizované CI/CD (předpřipravené workflowy)

​

CI — ci.yml

1. Provede checkout zdrojového kódu vaší aplikace.
2. Spustí izolovanou testovací instanci Twenty pomocí složené akce twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main (ekvivalent v CI k yarn twenty docker:start --test).
3. Povolí Corepack, nastaví Node.js podle vašeho .nvmrc a nainstaluje závislosti pomocí yarn install --immutable.
4. Spustí yarn test a předá TWENTY_API_URL a TWENTY_API_KEY ze spuštěné instance, aby vaše testy mohly komunikovat se skutečným serverem.

• TWENTY_VERSION (env, výchozí hodnota latest) — uzamkněte v CI používanou verzi serveru Twenty úpravou této hodnoty v ci.yml.
• Souběžné běhy jsou seskupeny podle github.ref a při nových pushích ruší právě probíhající běhy.

​

CD — cd.yml

1. Provede checkout headu PR (u označených PR) nebo pushnutého commitu.
2. Spustí twentyhq/twenty/.github/actions/deploy-twenty-app@main — ekvivalent v CI k yarn twenty app:publish --private.
3. Spustí twentyhq/twenty/.github/actions/install-twenty-app@main, aby se nově nasazená verze nainstalovala do cílového pracovního prostoru.

​

Připnutí verzí znovupoužitelných akcí

​

Publikování na npm

​

Požadavky

• Účet na npm
• Klíčové slovo twenty-app ve vašem poli keywords v souboru package.json (přidejte ho ručně — ve výchozím nastavení není zahrnuto v šabloně create-twenty-app)

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

​

Metadata tržiště

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

​

Doporučené rozměry snímků obrazovky

​

Publikování

yarn twenty app:publish

yarn twenty app:publish --tag beta

​

Jak funguje objevování v tržišti

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

​

Publikování pomocí 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

​

Instalace aplikací

yarn twenty app:install