Přejít na hlavní obsah
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 . Vložte logo do public/ a odkazujte na logoUrl.
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.',
  logoUrl: '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: 'contact@twenty.com',
  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. Přetáhněte několik PNGů do public/gallery/ a odkazujte na ně screenshots — vykreslují se jako galerie na stránce seznamu.
export default defineApplication({
  // ...identity from above
  screenshots: [
    '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 dev --once --dry-run   # preview the metadata diff
Suchý běh vypíše přesně to, co by se změnilo na serveru bez jeho použití – je 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.