Publikování

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.

​

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 build

​

Nasazení na server (tarball)

​

Předpoklady

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

​

Nasazení

yarn twenty deploy
# To deploy to a specific remote:
# yarn twenty deploy --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 deploy (nebo yarn twenty deploy --remote production)
3. Pracovní prostory, které mají aplikaci nainstalovanou, uvidí dostupnou aktualizaci ve svém nastavení

​

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 server 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 deploy.
3. Spustí twentyhq/twenty/.github/actions/install-twenty-app@main, aby se nově nasazená verze nainstalovala do cílového workspace.

​

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 je 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',
  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
  logoUrl: 'public/logo.png',
  screenshots: [
    'public/screenshot-1.png',
    'public/screenshot-2.png',
  ],
});

​

Publikování

yarn twenty publish

yarn twenty publish --tag beta

​

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

yarn twenty catalog-sync
# To target a specific remote:
# yarn twenty 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 build
      - run: npm publish --provenance --access public
        working-directory: .twenty/output

​

Instalace aplikací

yarn twenty install