The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
docs: Introduce third-party marketplace vetting criteria (#28457)
martmull18da1eb626db
diff --git a/packages/twenty-docs/developers/extend/apps/operations/marketplace-vetting.mdx b/packages/twenty-docs/developers/extend/apps/operations/marketplace-vetting.mdxnew file mode 100644index 00000000000..623c0a4f2f6--- /dev/null+++ b/packages/twenty-docs/developers/extend/apps/operations/marketplace-vetting.mdx@@ -0,0 +1,57 @@+---+title: Marketplace vetting (WIP)+description: Proposed requirements for third-party apps to receive a Vetted badge.+icon: 'shield-halved'+---++<Warning>+ **Work in progress.** This page and its requirements may evolve. Third-party+ vetting is not available yet. See+ [Publishing](/developers/extend/apps/operations/publishing#marketplace-visibility-and-vetting)+ for current marketplace behavior.+</Warning>++Vetting applies to an exact app version and package. Each update needs review and+approval from Twenty. Vetted apps may be reassessed as dependencies or services+evolve.++## Vetting checklist++All applicable items must pass. We recommend using an agent to self-evaluate+each criterion with evidence and required fixes before submitting.++- [ ] **Publisher.** [Claim your app](/developers/extend/apps/operations/publishing#claiming-your-app)+ and [publish with provenance](/developers/extend/apps/operations/publishing#ci-publishing).+- [ ] **Security.** Pass Twenty's internal security review and resolve blocking+ findings.+- [ ] **Permissions.** Request only the+ [permissions](/developers/extend/apps/config/roles) needed for the app's features.+- [ ] **Functionality.** Setup and core workflows are easy to follow and work as+ advertised, without crashes, lost work, or duplicate records. No placeholder+ features or broken controls.+- [ ] **Performance.** Respect shared API/job rate limits, handle throttling, and+ follow the+ [app development good practices](/developers/extend/apps/getting-started/good-practices).+- [ ] **Usefulness.** Complete a meaningful CRM task for a broader audience than+ one customer's setup. Small connectors and headless automations qualify.+- [ ] **Native experience.** Reuse native objects, views, and workflows where appropriate.+ If the app has a UI, use+ [`twenty-ui`](/developers/extend/apps/layout/front-components#using-twenty-ui-components)+ and match Twenty's layouts, interactions, and accessibility conventions.+- [ ] **Privacy.** Explain what data leaves the workspace, where it goes and why,+ including AI providers, how long it is kept, and how it can be deleted.+- [ ] **Maintenance and compatibility.** Declare supported Twenty versions, keep+ entity identifiers stable, and fix critical bugs and broken integrations over+ time.+- [ ] **Logo and gallery.** Provide an original, recognizable logo and polished+ images of the actual app. Follow the+ [image guidelines](/developers/extend/apps/operations/publishing#marketplace-metadata).+- [ ] **Listing and README.** Accurately describe features and affiliations in+ the name, description, and screenshots. Keep the README short, well-formatted,+ and focused on the app's value.+- [ ] **Pricing.** Clearly state whether the app is free or paid, plan prices,+ billing frequency, and any required paid third-party services.+- [ ] **Documentation and support.** Provide setup instructions, a working example,+ and a support contact. If using shared routes, complete+ [setup](/developers/extend/apps/operations/publishing#setting-up-server-routes)+ and verify events reach the correct workspace.diff --git a/packages/twenty-docs/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/developers/extend/apps/operations/overview.mdxindex 7d7d9340e80..98c2058220c 100644--- a/packages/twenty-docs/developers/extend/apps/operations/overview.mdx+++ b/packages/twenty-docs/developers/extend/apps/operations/overview.mdx@@ -53,6 +53,9 @@ The **operations layer** is everything you do _to_ your app rather than _with_ i>Build, deploy a tarball, publish to npm, install.</Card>+ <Card title="Marketplace vetting (WIP)" icon="shield-halved" href="/developers/extend/apps/operations/marketplace-vetting">+ Proposed security, quality, and operational checks for third-party app versions.+ </Card><Card title="Monitoring" icon="chart-line" href="/developers/extend/apps/operations/monitoring">Errors, rate limits, credits and function performance across installs.</Card>diff --git a/packages/twenty-docs/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/developers/extend/apps/operations/publishing.mdxindex a725400bea3..2d47636dce3 100644--- a/packages/twenty-docs/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/developers/extend/apps/operations/publishing.mdx@@ -378,6 +378,10 @@ Claiming establishes ownership; it does not grant a **Vetted** badge. The marketThe Vetted label currently applies to apps maintained by Twenty, for which the team can vouch for security and quality. Third-party apps can be published and installed without this label.+The proposed [third-party marketplace vetting checklist](/developers/extend/apps/operations/marketplace-vetting)+is a work in progress. It describes version-specific review criteria and evidence,+not an available certification program.+If your app is still missing with **Vetted only** turned off, confirm catalog sync has completed, all required server variables are filled in, and any server-route setup is complete.## Installing appsdiff --git a/packages/twenty-docs/docs.json b/packages/twenty-docs/docs.jsonindex 0aa518eadef..5b857a3ff66 100644--- a/packages/twenty-docs/docs.json+++ b/packages/twenty-docs/docs.json@@ -487,6 +487,7 @@"developers/extend/apps/operations/testing","developers/extend/apps/operations/translations","developers/extend/apps/operations/publishing",+ "developers/extend/apps/operations/marketplace-vetting","developers/extend/apps/operations/monitoring"]}diff --git a/packages/twenty-docs/navigation/base-structure.json b/packages/twenty-docs/navigation/base-structure.jsonindex 9789de85c46..0128257db51 100644--- a/packages/twenty-docs/navigation/base-structure.json+++ b/packages/twenty-docs/navigation/base-structure.json@@ -492,6 +492,7 @@"developers/extend/apps/operations/testing","developers/extend/apps/operations/translations","developers/extend/apps/operations/publishing",+ "developers/extend/apps/operations/marketplace-vetting","developers/extend/apps/operations/monitoring"]}diff --git a/packages/twenty-shared/src/constants/DocumentationPaths.ts b/packages/twenty-shared/src/constants/DocumentationPaths.tsindex 1d69fdfe062..1bf48712ffe 100644--- a/packages/twenty-shared/src/constants/DocumentationPaths.ts+++ b/packages/twenty-shared/src/constants/DocumentationPaths.ts@@ -80,6 +80,8 @@ export const DOCUMENTATION_PATHS = {'/developers/extend/apps/logic/workflows',DEVELOPERS_EXTEND_APPS_OPERATIONS_CLI:'/developers/extend/apps/operations/cli',+ DEVELOPERS_EXTEND_APPS_OPERATIONS_MARKETPLACE_VETTING:+ '/developers/extend/apps/operations/marketplace-vetting',DEVELOPERS_EXTEND_APPS_OPERATIONS_MONITORING:'/developers/extend/apps/operations/monitoring',DEVELOPERS_EXTEND_APPS_OPERATIONS_OVERVIEW: