6. Publikování

Přidejte metadata tržiště a publikujte svou aplikaci.

Vaše aplikace funguje. Posledním krokem je popsat jej pro tržiště a publikovat.

​

Přidat metadata tržiště

application config nese identitu, která se objeví v tržišti: autor, kategorie, logo a podpora . Umístěte logo do public/ a odkažte se na něj pomocí logo.

import { defineApplication } from 'twenty-sdk/define';

export default defineApplication({
  universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,
  displayName: 'Document Generator',
  description:
    'Create reusable document templates and generate personalized documents from your CRM records.',
  logo: 'public/document-generator.svg',
  author: 'Twenty',
  category: 'Productivity',
  websiteUrl: 'https://docs.twenty.com/l/cs/developers/extend/apps',
  termsUrl: 'https://www.twenty.com/terms',
  emailSupport: '[e-mail]',
  issueReportUrl: 'https://github.com/twentyhq/twenty/issues',
});

Výchozí role je deklarována s defineApplicationRole() ve svém vlastním souboru – vy zde již neprojdete defaultRoleUniversalIdentifier.

Přidejte také klíčové slovo dvacet app do package.json tak, aby byla aplikace nalezena:

{ "keywords": ["twenty-app"] }

​

Přidat galerii snímků obrazovky

tržiště se prodává se snímky obrazovky. Vložte několik souborů PNG do public/gallery/ a odkažte se na ně pomocí galleryImages — na stránce s výpisem se zobrazí jako galerie v pořadí, v jakém jsou v poli.

export default defineApplication({
  // ...identity from above
  galleryImages: [
    'public/gallery/01-generated-document.png',
    'public/gallery/02-command-menu.png',
    'public/gallery/03-template-editor.png',
    'public/gallery/04-documents.png',
  ],
});

Lead with the payoff: make the first screenshot the finished result (generated document), then show how it is triggered and authored. (Automatic Copy) Použít křiklavé, vysoké rozlišení snímky — jsou to první věc, kterou uživatel vidí.

Dejte README.md stejné ošetření — je to přední stránka na npm a GitHub. Otevřete pomocí nabídky hodnot a snímku obrazovky, vyberte titulky, ponechte podrobnosti sestavení pod složkou.

​

Zkontrolovat před odesláním

Spustit tytéž brány CI:

yarn lint          # oxlint
yarn typecheck     # tsgo
yarn test:unit     # unit tests
yarn twenty plan   # preview the metadata diff

Plán vypíše přesně to, co by se na serveru změnilo, aniž by změny provedl — dobrá závěrečná kontrola. Viz Testing a Synchronizace a obnovy.

​

Publikovat

# Public app → npm (default)
yarn twenty app:publish

# Or deploy privately to a specific server's registry
yarn twenty app:publish --private -r <remote>

app:publish ve výchozím nastavení sestavuje a publikuje do npm; --private nahraje tarball do privátního registru 20 serverů. Chcete-li zobrazit publikovanou aplikaci v obchodě instance, spustí synchronizaci katalogu:

yarn twenty dev:catalog-sync -r <remote>

Úplné podrobnosti a kontrolní seznam vydání: Publishing.

​

Vytvořili jste aplikaci 🎉

V šesti kapitolách jste použili většinu povrchu SDK:

• Objekty, pole a vztahy modelovat data
• Logická funkce obklopená jako nástroj AI, akce pracovního postupu a cesty HTTP
• Zobrazení, navigace, příkaz a přední složka pro UI
• agent + dovednost pro generování přirozeného jazyka
• Metadata tržiště a tok zveřejnění

Dokončená aplikace je na packages/twenty-apps/examples/document-generator.

​

Kde jít dál

Odkaz na údaje

Každý typ pole, vztah a index.

Logický odkaz

Cron a databázová událost, klíčový obchod, připojení OAuth.

Odkaz na rozložení

Rozvržení stránky, widgety hlavního panelu a další povrchy uživatelského rozhraní.

Operace

CLI, testování, dálkové ovládání a CI.