diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/building.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/building.mdx
index 1a39f4fe14..cd2b078ea9 100644
--- a/packages/twenty-docs/l/ar/developers/extend/apps/building.mdx
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/building.mdx
@@ -358,17 +358,17 @@ export default defineApplication({
إذا كنت تخطط لـ [نشر تطبيقك](/l/ar/developers/extend/apps/publishing)، فإن هذه الحقول الاختيارية تتحكّم في كيفية ظهور تطبيقك في السوق:
-| الحقل | الوصف |
-| ------------------ | ---------------------------------------------------- |
-| `author` | اسم المؤلف أو الشركة |
-| `category` | فئة التطبيق لتصفية سوق التطبيقات |
-| `logoUrl` | المسار إلى شعار تطبيقك (نسبيًا إلى `./assets/`) |
-| `screenshots` | مصفوفة لمسارات لقطات الشاشة (نسبيًا إلى `./assets/`) |
-| `aboutDescription` | وصف ماركداون أطول لعلامة التبويب "حول" |
-| `websiteUrl` | رابط إلى موقعك الإلكتروني |
-| `termsUrl` | رابط إلى شروط الخدمة |
-| `emailSupport` | عنوان البريد الإلكتروني للدعم |
-| `issueReportUrl` | رابط إلى متتبّع المشاكل |
+| الحقل | الوصف |
+| ------------------ | ------------------------------------------------------------------------------------------------------------ |
+| `author` | اسم المؤلف أو الشركة |
+| `category` | فئة التطبيق لتصفية سوق التطبيقات |
+| `logoUrl` | المسار إلى شعار تطبيقك (نسبيًا إلى `./assets/`) |
+| `screenshots` | مصفوفة لمسارات لقطات الشاشة (نسبيًا إلى `./assets/`) |
+| `aboutDescription` | وصف ماركداون أطول لعلامة التبويب "حول". إذا لم يتم تضمينه، يستخدم السوق ملف `README.md` الخاص بالحزمة من npm |
+| `websiteUrl` | رابط إلى موقعك الإلكتروني |
+| `termsUrl` | رابط إلى شروط الخدمة |
+| `emailSupport` | عنوان البريد الإلكتروني للدعم |
+| `issueReportUrl` | رابط إلى متتبّع المشاكل |
#### الأدوار والصلاحيات
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started.mdx
index d20e576458..e132e6defa 100644
--- a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started.mdx
@@ -9,18 +9,19 @@ description: أنشئ أول تطبيق Twenty خلال دقائق.
تتيح لك التطبيقات توسيع Twenty باستخدام كائنات وحقول ووظائف منطقية ومهارات ذكاء اصطناعي ومكونات واجهة مستخدم مخصصة — جميعها تُدار ككود.
-**ما الذي يمكنك فعله اليوم:**
+**What you can build:**
-* عرِّف كائنات وحقولًا مخصصة على شكل كود (نموذج بيانات مُدار)
-* أنشئ وظائف منطقية مع مشغلات مخصصة (مسارات HTTP، cron، أحداث قاعدة البيانات)
-* حدد المهارات لوكلاء الذكاء الاصطناعي
-* أنشئ مكونات واجهية تُعرَض داخل واجهة مستخدم Twenty
-* انشر التطبيق نفسه عبر مساحات عمل متعددة
+* Custom objects, fields, views, and navigation items to shape your data model
+* Logic functions triggered by HTTP routes, cron schedules, or database events
+* Front components that render directly inside Twenty's UI
+* Skills that extend Twenty's AI agents
+* Deploy an app across multiple workspaces
## المتطلبات الأساسية
-* Node.js 24+ وYarn 4
-* Docker (لخادم تطوير Twenty المحلي)
+* Node.js 24+
+* Yarn 4
+* Docker (or a running local Twenty instance)
## البدء
@@ -29,21 +30,9 @@ description: أنشئ أول تطبيق Twenty خلال دقائق.
```bash filename="Terminal"
# Scaffold a new app (includes all examples by default)
npx create-twenty-app@latest my-twenty-app
-cd my-twenty-app
-
-# Start dev mode: automatically syncs local changes to your workspace
-yarn twenty dev
```
-يدعم المُهيئ وضعين للتحكم في ملفات الأمثلة التي سيتم تضمينها:
-
-```bash filename="Terminal"
-# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent)
-npx create-twenty-app@latest my-app
-
-# Minimal: only core files (application-config.ts and default-role.ts)
-npx create-twenty-app@latest my-app --minimal
-```
+> Use `--minimal` option to scaffold a minimal installation
من هنا يمكنك:
diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/publishing.mdx
index aac2aa8cab..e57357210a 100644
--- a/packages/twenty-docs/l/ar/developers/extend/apps/publishing.mdx
+++ b/packages/twenty-docs/l/ar/developers/extend/apps/publishing.mdx
@@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production
تأتي بيانات التعريف المعروضة في السوق من استدعائك لـ `defineApplication()` في الشيفرة المصدرية لتطبيقك — حقول مثل `displayName` و`description` و`author` و`category` و`logoUrl` و`screenshots` و`aboutDescription` و`websiteUrl` و`termsUrl`.
+
+إذا لم يحدد تطبيقك `aboutDescription` في `defineApplication()`، فسيستخدم السوق تلقائيًا ملف `README.md` الخاص بحزمتك من npm كمحتوى لصفحة حول. هذا يعني أنه يمكنك الاحتفاظ بملف README واحد لكل من npm وسوق Twenty. إذا كنت تريد وصفًا مختلفًا في السوق، فقم بتعيين `aboutDescription` بشكل صريح.
+
+
### النشر عبر CI
يتضمن المشروع المُولَّد سير عمل GitHub Actions يقوم بالنشر عند كل إصدار:
diff --git a/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx
index 2fb9d9d726..06b3fea41c 100644
--- a/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx
+++ b/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx
@@ -38,7 +38,7 @@ yarn twenty dev
### إدارة الخادم المحلي
-يتضمن SDK أوامر لإدارة خادم تطوير Twenty محلي (صورة Docker متكاملة تتضمن PostgreSQL وRedis والخادم والعامل):
+The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000):
```bash filename="Terminal"
# ابدأ الخادم المحلي (يسحب الصورة إذا لزم الأمر)
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/building.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/building.mdx
index 154aecf0e3..a54e74d088 100644
--- a/packages/twenty-docs/l/cs/developers/extend/apps/building.mdx
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/building.mdx
@@ -358,17 +358,17 @@ Poznámky:
Pokud plánujete [zveřejnit svou aplikaci](/l/cs/developers/extend/apps/publishing), tato volitelná pole určují, jak se vaše aplikace zobrazuje na Marketplace:
-| Pole | Popis |
-| ------------------ | -------------------------------------------------------- |
-| `author` | Jméno autora nebo název společnosti |
-| `category` | Kategorie aplikace pro filtrování na Marketplace |
-| `logoUrl` | Cesta k logu vaší aplikace (relativně k `./assets/`) |
-| `screenshots` | Pole cest ke snímkům obrazovky (relativně k `./assets/`) |
-| `aboutDescription` | Delší popis v Markdownu pro kartu "O aplikaci" |
-| `websiteUrl` | Odkaz na váš web |
-| `termsUrl` | Odkaz na Podmínky služby |
-| `emailSupport` | E-mailová adresa podpory |
-| `issueReportUrl` | Odkaz na nástroj pro sledování problémů |
+| Pole | Popis |
+| ------------------ | ------------------------------------------------------------------------------------------------------------- |
+| `author` | Jméno autora nebo název společnosti |
+| `category` | Kategorie aplikace pro filtrování na Marketplace |
+| `logoUrl` | Cesta k logu vaší aplikace (relativně k `./assets/`) |
+| `screenshots` | Pole cest ke snímkům obrazovky (relativně k `./assets/`) |
+| `aboutDescription` | Delší popis v Markdownu pro kartu "O aplikaci". Pokud je vynecháno, tržiště použije `README.md` balíčku z npm |
+| `websiteUrl` | Odkaz na váš web |
+| `termsUrl` | Odkaz na Podmínky služby |
+| `emailSupport` | E-mailová adresa podpory |
+| `issueReportUrl` | Odkaz na nástroj pro sledování problémů |
#### Role a oprávnění
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started.mdx
index 5931e2b147..04bc040fac 100644
--- a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started.mdx
@@ -9,18 +9,19 @@ Aplikace jsou aktuálně v alfa testování. Tato funkce je funkční, ale stál
Aplikace vám umožňují rozšířit Twenty o vlastní objekty, pole, logické funkce, AI schopnosti a komponenty uživatelského rozhraní — vše je spravováno jako kód.
-**Co můžete dělat už dnes:**
+**What you can build:**
-* Definujte vlastní objekty a pole jako kód (spravovaný datový model)
-* Vytvářejte logické funkce s vlastními spouštěči (HTTP routy, cron, databázové události)
-* Definujte dovednosti agentů AI
-* Vytvářejte frontendové komponenty, které se vykreslují uvnitř uživatelského rozhraní Twenty
-* Nasazujte stejnou aplikaci do více pracovních prostorů
+* Custom objects, fields, views, and navigation items to shape your data model
+* Logic functions triggered by HTTP routes, cron schedules, or database events
+* Front components that render directly inside Twenty's UI
+* Skills that extend Twenty's AI agents
+* Deploy an app across multiple workspaces
## Předpoklady
-* Node.js 24+ a Yarn 4
-* Docker (pro místní vývojový server Twenty)
+* Node.js 24+
+* Yarn 4
+* Docker (or a running local Twenty instance)
## Začínáme
@@ -29,21 +30,9 @@ Vytvořte novou aplikaci pomocí oficiálního scaffolderu, poté se ověřte a
```bash filename="Terminal"
# Scaffold a new app (includes all examples by default)
npx create-twenty-app@latest my-twenty-app
-cd my-twenty-app
-
-# Start dev mode: automatically syncs local changes to your workspace
-yarn twenty dev
```
-Nástroj pro generování kostry podporuje dva režimy pro řízení toho, které ukázkové soubory jsou zahrnuty:
-
-```bash filename="Terminal"
-# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent)
-npx create-twenty-app@latest my-app
-
-# Minimal: only core files (application-config.ts and default-role.ts)
-npx create-twenty-app@latest my-app --minimal
-```
+> Use `--minimal` option to scaffold a minimal installation
Odtud můžete:
diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/publishing.mdx
index 95abcb4e72..2977f9eade 100644
--- a/packages/twenty-docs/l/cs/developers/extend/apps/publishing.mdx
+++ b/packages/twenty-docs/l/cs/developers/extend/apps/publishing.mdx
@@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production
Metadata zobrazená v tržišti pocházejí z volání `defineApplication()` ve zdrojovém kódu vaší aplikace — z polí jako `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` a `termsUrl`.
+
+Pokud vaše aplikace nedefinuje `aboutDescription` v `defineApplication()`, tržiště automaticky použije soubor `README.md` vašeho balíčku z npm jako obsah stránky O aplikaci. To znamená, že můžete spravovat jediný soubor README jak pro npm, tak pro tržiště Twenty. Pokud chcete v tržišti jiný popis, explicitně nastavte `aboutDescription`.
+
+
### Publikování pomocí CI
Vygenerovaný projekt obsahuje pracovní postup GitHub Actions, který publikuje při každém vydání:
@@ -238,8 +242,8 @@ Začněte v režimu **Development** při sestavování své aplikace. Až bude p
| --------------------------- | ----------------------------------------------------- | --------------------------------------------------- |
| `yarn twenty build` | Sestaví aplikaci a vygeneruje manifest | `--tarball` — také vytvoří balíček `.tgz` |
| `yarn twenty publish` | Sestaví a publikuje na npm | `--tag ` — npm dist-tag (např. `beta`, `next`) |
-| `yarn twenty deploy` | Sestaví a nahraje tarball na server | `-r, --remote ` — cílový vzdálený server |
-| `yarn twenty catalog-sync` | Spustí synchronizaci katalogu tržiště na serveru | `-r, --remote ` — cílový vzdálený server |
+| `yarn twenty deploy` | Sestaví a nahraje tarball na server | `-r, --remote ` — cílový vzdálený repozitář |
+| `yarn twenty catalog-sync` | Spustí synchronizaci katalogu tržiště na serveru | `-r, --remote ` — cílový vzdálený repozitář |
| `yarn twenty install` | Nainstaluje nasazenou aplikaci do pracovního prostoru | `-r, --remote ` — cílový vzdálený server |
| `yarn twenty dev` | Sleduje a synchronizuje lokální změny | Používá výchozí vzdálený server |
| `yarn twenty remote add` | Přidá připojení k serveru | `--url`, `--token`, `--as`, `--local`, `--port` |
diff --git a/packages/twenty-docs/l/cs/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/cs/developers/extend/capabilities/apps.mdx
index 10c8704bb2..43a204ad97 100644
--- a/packages/twenty-docs/l/cs/developers/extend/capabilities/apps.mdx
+++ b/packages/twenty-docs/l/cs/developers/extend/capabilities/apps.mdx
@@ -38,7 +38,7 @@ yarn twenty dev
### Správa místního serveru
-SDK obsahuje příkazy ke správě místního vývojového serveru Twenty (all-in-one obraz Dockeru s PostgreSQL, Redisem, serverem a workerem):
+The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000):
```bash filename="Terminal"
# Spusťte místní server (v případě potřeby stáhne obraz)
diff --git a/packages/twenty-docs/l/de/developers/extend/apps/building.mdx b/packages/twenty-docs/l/de/developers/extend/apps/building.mdx
index 0a491b5ee2..3e75f03a6c 100644
--- a/packages/twenty-docs/l/de/developers/extend/apps/building.mdx
+++ b/packages/twenty-docs/l/de/developers/extend/apps/building.mdx
@@ -358,17 +358,17 @@ Notizen:
Wenn Sie planen, [Ihre App zu veröffentlichen](/l/de/developers/extend/apps/publishing), steuern diese optionalen Felder, wie Ihre App im Marktplatz erscheint:
-| Feld | Beschreibung |
-| ------------------ | ---------------------------------------------------- |
-| `author` | Name des Autors oder des Unternehmens |
-| `category` | App-Kategorie für die Filterung im Marktplatz |
-| `logoUrl` | Pfad zu Ihrem App-Logo (relativ zu `./assets/`) |
-| `screenshots` | Array von Screenshot-Pfaden (relativ zu `./assets/`) |
-| `aboutDescription` | Längere Markdown-Beschreibung für den Tab "Info" |
-| `websiteUrl` | Link zu Ihrer Website |
-| `termsUrl` | Link zu den Nutzungsbedingungen |
-| `emailSupport` | Support-E-Mail-Adresse |
-| `issueReportUrl` | Link zum Issue-Tracker |
+| Feld | Beschreibung |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
+| `author` | Name des Autors oder des Unternehmens |
+| `category` | App-Kategorie für die Filterung im Marktplatz |
+| `logoUrl` | Pfad zu Ihrem App-Logo (relativ zu `./assets/`) |
+| `screenshots` | Array von Screenshot-Pfaden (relativ zu `./assets/`) |
+| `aboutDescription` | Längere Markdown-Beschreibung für den Tab "Info". Wenn weggelassen, verwendet der Marketplace die `README.md` des Pakets von npm |
+| `websiteUrl` | Link zu Ihrer Website |
+| `termsUrl` | Link zu den Nutzungsbedingungen |
+| `emailSupport` | Support-E-Mail-Adresse |
+| `issueReportUrl` | Link zum Issue-Tracker |
#### Rollen und Berechtigungen
diff --git a/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx
index b7c59afab9..cdb2f89bba 100644
--- a/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/de/developers/extend/apps/getting-started.mdx
@@ -9,18 +9,19 @@ Apps befinden sich derzeit in der Alpha-Testphase. Die Funktion ist funktionsfä
Apps ermöglichen es Ihnen, Twenty mit benutzerdefinierten Objekten, Feldern, Logikfunktionen, KI-Fähigkeiten und UI-Komponenten zu erweitern — alles als Code verwaltet.
-**Was Sie heute tun können:**
+**What you can build:**
-* Benutzerdefinierte Objekte und Felder als Code definieren (verwaltetes Datenmodell)
-* Erstellen Sie Logikfunktionen mit benutzerdefinierten Triggern (HTTP-Routen, cron, Datenbankereignisse)
-* Fähigkeiten für KI-Agenten definieren
-* Erstellen Sie Frontend-Komponenten, die in der Twenty-UI gerendert werden
-* Dieselbe App in mehreren Workspaces bereitstellen
+* Custom objects, fields, views, and navigation items to shape your data model
+* Logic functions triggered by HTTP routes, cron schedules, or database events
+* Front components that render directly inside Twenty's UI
+* Skills that extend Twenty's AI agents
+* Deploy an app across multiple workspaces
## Voraussetzungen
-* Node.js 24+ und Yarn 4
-* Docker (für den lokalen Twenty-Dev-Server)
+* Node.js 24+
+* Yarn 4
+* Docker (or a running local Twenty instance)
## Erste Schritte
@@ -29,21 +30,9 @@ Erstellen Sie mit dem offiziellen Scaffolder eine neue App, authentifizieren Sie
```bash filename="Terminal"
# Scaffold a new app (includes all examples by default)
npx create-twenty-app@latest my-twenty-app
-cd my-twenty-app
-
-# Start dev mode: automatically syncs local changes to your workspace
-yarn twenty dev
```
-Das Scaffolding-Tool unterstützt zwei Modi, um zu steuern, welche Beispieldateien enthalten sind:
-
-```bash filename="Terminal"
-# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent)
-npx create-twenty-app@latest my-app
-
-# Minimal: only core files (application-config.ts and default-role.ts)
-npx create-twenty-app@latest my-app --minimal
-```
+> Use `--minimal` option to scaffold a minimal installation
Von hier aus können Sie:
diff --git a/packages/twenty-docs/l/de/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/de/developers/extend/apps/publishing.mdx
index 42f88d117d..a1d586ffa1 100644
--- a/packages/twenty-docs/l/de/developers/extend/apps/publishing.mdx
+++ b/packages/twenty-docs/l/de/developers/extend/apps/publishing.mdx
@@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production
Die im Marktplatz angezeigten Metadaten stammen aus Ihrem `defineApplication()`-Aufruf im Quellcode Ihrer App — Felder wie `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` und `termsUrl`.
+
+Wenn deine App keine `aboutDescription` in `defineApplication()` definiert, verwendet der Marktplatz automatisch die `README.md` deines Pakets von npm als Inhalt der Über-uns-Seite. Das bedeutet, dass du eine einzige README sowohl für npm als auch für den Twenty-Marktplatz pflegen kannst. Wenn du im Marktplatz eine andere Beschreibung möchtest, setze `aboutDescription` explizit.
+
+
### CI-Veröffentlichung
Das vorgefertigte Projekt enthält einen GitHub-Actions-Workflow, der bei jedem Release eine Veröffentlichung durchführt:
diff --git a/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx
index 797de37bdc..27f06eff0d 100644
--- a/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx
+++ b/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx
@@ -38,7 +38,7 @@ yarn twenty dev
### Lokale Serververwaltung
-Das SDK enthält Befehle zur Verwaltung eines lokalen Twenty-Dev-Servers (All-in-One-Docker-Image mit PostgreSQL, Redis, Server und Worker):
+The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000):
```bash filename="Terminal"
# Den lokalen Server starten (lädt das Image bei Bedarf herunter)
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/building.mdx b/packages/twenty-docs/l/it/developers/extend/apps/building.mdx
index 3559d86e80..f154053e50 100644
--- a/packages/twenty-docs/l/it/developers/extend/apps/building.mdx
+++ b/packages/twenty-docs/l/it/developers/extend/apps/building.mdx
@@ -358,17 +358,17 @@ Note:
Se prevedi di [pubblicare la tua app](/l/it/developers/extend/apps/publishing), questi campi opzionali controllano come la tua app appare nel marketplace:
-| Campo | Descrizione |
-| ------------------ | ----------------------------------------------------------- |
-| `autore` | Nome dell'autore o dell'azienda |
-| `categoria` | Categoria dell'app per il filtraggio nel marketplace |
-| `logoUrl` | Percorso del logo della tua app (relativo a `./assets/`) |
-| `screenshots` | Array di percorsi degli screenshot (relativi a `./assets/`) |
-| `aboutDescription` | Descrizione markdown più lunga per la scheda "Informazioni" |
-| `websiteUrl` | Link al tuo sito web |
-| `termsUrl` | Link ai Termini di servizio |
-| `emailSupport` | Indirizzo email di supporto |
-| `issueReportUrl` | Link al sistema di tracciamento dei problemi |
+| Campo | Descrizione |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `autore` | Nome dell'autore o dell'azienda |
+| `categoria` | Categoria dell'app per il filtraggio nel marketplace |
+| `logoUrl` | Percorso del logo della tua app (relativo a `./assets/`) |
+| `screenshots` | Array di percorsi degli screenshot (relativi a `./assets/`) |
+| `aboutDescription` | Descrizione markdown più lunga per la scheda "Informazioni". Se omesso, il marketplace utilizza il `README.md` del pacchetto da npm |
+| `websiteUrl` | Link al tuo sito web |
+| `termsUrl` | Link ai Termini di servizio |
+| `emailSupport` | Indirizzo email di supporto |
+| `issueReportUrl` | Link al sistema di tracciamento dei problemi |
#### Ruoli e permessi
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/it/developers/extend/apps/getting-started.mdx
index 67c8f4581e..b1e46a9f32 100644
--- a/packages/twenty-docs/l/it/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/it/developers/extend/apps/getting-started.mdx
@@ -9,18 +9,19 @@ Le app sono attualmente in fase alfa. La funzionalità è funzionante ma ancora
Le app ti permettono di estendere Twenty con oggetti, campi, funzioni logiche, competenze IA e componenti UI personalizzati — il tutto gestito come codice.
-**Cosa puoi fare oggi:**
+**What you can build:**
-* Definisci oggetti e campi personalizzati come codice (modello dati gestito)
-* Crea funzioni logiche con trigger personalizzati (route HTTP, cron, eventi del database)
-* Definisci le abilità per gli agenti IA
-* Crea componenti front-end che vengono renderizzati all'interno della UI di Twenty
-* Distribuisci la stessa app su più spazi di lavoro
+* Custom objects, fields, views, and navigation items to shape your data model
+* Logic functions triggered by HTTP routes, cron schedules, or database events
+* Front components that render directly inside Twenty's UI
+* Skills that extend Twenty's AI agents
+* Deploy an app across multiple workspaces
## Prerequisiti
-* Node.js 24+ e Yarn 4
-* Docker (per il server di sviluppo locale di Twenty)
+* Node.js 24+
+* Yarn 4
+* Docker (or a running local Twenty instance)
## Per iniziare
@@ -29,21 +30,9 @@ Crea una nuova app utilizzando lo scaffolder ufficiale, quindi autenticati e ini
```bash filename="Terminal"
# Scaffold a new app (includes all examples by default)
npx create-twenty-app@latest my-twenty-app
-cd my-twenty-app
-
-# Start dev mode: automatically syncs local changes to your workspace
-yarn twenty dev
```
-Lo strumento di scaffolding supporta due modalità per controllare quali file di esempio vengono inclusi:
-
-```bash filename="Terminal"
-# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent)
-npx create-twenty-app@latest my-app
-
-# Minimal: only core files (application-config.ts and default-role.ts)
-npx create-twenty-app@latest my-app --minimal
-```
+> Use `--minimal` option to scaffold a minimal installation
Da qui puoi:
diff --git a/packages/twenty-docs/l/it/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/it/developers/extend/apps/publishing.mdx
index bc02c0a195..7bfff4baee 100644
--- a/packages/twenty-docs/l/it/developers/extend/apps/publishing.mdx
+++ b/packages/twenty-docs/l/it/developers/extend/apps/publishing.mdx
@@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production
I metadati mostrati nel marketplace provengono dalla chiamata a `defineApplication()` nel codice sorgente della tua app — campi come `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` e `termsUrl`.
+
+If your app does not define an `aboutDescription` in `defineApplication()`, the marketplace will automatically use your package's `README.md` from npm as the about page content. This means you can maintain a single README for both npm and the Twenty marketplace. If you want a different description in the marketplace, explicitly set `aboutDescription`.
+
+
### Pubblicazione con CI
Il progetto generato include un workflow di GitHub Actions che pubblica a ogni release:
diff --git a/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx
index 1926f97f0b..0ce8bdc4a8 100644
--- a/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx
+++ b/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx
@@ -38,7 +38,7 @@ yarn twenty dev
### Gestione del server locale
-L'SDK include comandi per gestire un server di sviluppo locale di Twenty (immagine Docker all-in-one con PostgreSQL, Redis, server e worker):
+The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000):
```bash filename="Terminal"
# Avvia il server locale (scarica l'immagine se necessario)
diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/building.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/building.mdx
index c7d1e97022..020ff28d64 100644
--- a/packages/twenty-docs/l/ro/developers/extend/apps/building.mdx
+++ b/packages/twenty-docs/l/ro/developers/extend/apps/building.mdx
@@ -358,17 +358,17 @@ Notițe:
Dacă intenționați să [publicați aplicația](/l/ro/developers/extend/apps/publishing), aceste câmpuri opționale controlează modul în care aplicația apare în marketplace:
-| Câmp | Descriere |
-| ------------------ | ------------------------------------------------------------- |
-| `autor` | Numele autorului sau al companiei |
-| `categorie` | Categoria aplicației pentru filtrarea în marketplace |
-| `logoUrl` | Calea către logo-ul aplicației (relativă la `./assets/`) |
-| `screenshots` | Listă de căi către capturi de ecran (relative la `./assets/`) |
-| `aboutDescription` | Descriere markdown mai lungă pentru fila "About" |
-| `websiteUrl` | Link către site-ul dvs. |
-| `termsUrl` | Link către termenii de serviciu |
-| `emailSupport` | Adresă de e-mail pentru suport |
-| `issueReportUrl` | Link către sistemul de urmărire a problemelor |
+| Câmp | Descriere |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
+| `autor` | Numele autorului sau al companiei |
+| `categorie` | Categoria aplicației pentru filtrarea în marketplace |
+| `logoUrl` | Calea către logo-ul aplicației (relativă la `./assets/`) |
+| `screenshots` | Listă de căi către capturi de ecran (relative la `./assets/`) |
+| `aboutDescription` | Descriere markdown mai lungă pentru fila "About". Dacă este omis, marketplace-ul folosește `README.md` al pachetului de pe npm |
+| `websiteUrl` | Link către site-ul dvs. |
+| `termsUrl` | Link către termenii de serviciu |
+| `emailSupport` | Adresă de e-mail pentru suport |
+| `issueReportUrl` | Link către sistemul de urmărire a problemelor |
#### Roluri și permisiuni
diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/getting-started.mdx
index 56eb8c8976..94c70a20a2 100644
--- a/packages/twenty-docs/l/ro/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/ro/developers/extend/apps/getting-started.mdx
@@ -9,18 +9,19 @@ Aplicațiile sunt în prezent în testare alfa. Caracteristica funcționează, d
Aplicațiile vă permit să extindeți Twenty cu obiecte personalizate, câmpuri, funcții logice, abilități IA și componente UI — toate gestionate ca cod.
-**Ce puteți face astăzi:**
+**What you can build:**
-* Definiți obiecte și câmpuri personalizate sub formă de cod (model de date gestionat)
-* Construiți funcții logice cu declanșatoare personalizate (rute HTTP, cron, evenimente ale bazei de date)
-* Definiți abilități pentru agenți de IA
-* Construiți componente front-end care se afișează în interfața Twenty
-* Implementați aceeași aplicație în mai multe spații de lucru
+* Custom objects, fields, views, and navigation items to shape your data model
+* Logic functions triggered by HTTP routes, cron schedules, or database events
+* Front components that render directly inside Twenty's UI
+* Skills that extend Twenty's AI agents
+* Deploy an app across multiple workspaces
## Cerințe
-* Node.js 24+ și Yarn 4
-* Docker (pentru serverul local de dezvoltare Twenty)
+* Node.js 24+
+* Yarn 4
+* Docker (or a running local Twenty instance)
## Începeți
@@ -29,21 +30,9 @@ Creați o aplicație nouă folosind generatorul oficial, apoi autentificați-vă
```bash filename="Terminal"
# Scaffold a new app (includes all examples by default)
npx create-twenty-app@latest my-twenty-app
-cd my-twenty-app
-
-# Start dev mode: automatically syncs local changes to your workspace
-yarn twenty dev
```
-Generatorul de schelet acceptă două moduri pentru a controla ce fișiere de exemplu sunt incluse:
-
-```bash filename="Terminal"
-# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent)
-npx create-twenty-app@latest my-app
-
-# Minimal: only core files (application-config.ts and default-role.ts)
-npx create-twenty-app@latest my-app --minimal
-```
+> Use `--minimal` option to scaffold a minimal installation
De aici puteți:
diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/publishing.mdx
index f68adbb3e7..30283e8cf6 100644
--- a/packages/twenty-docs/l/ro/developers/extend/apps/publishing.mdx
+++ b/packages/twenty-docs/l/ro/developers/extend/apps/publishing.mdx
@@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production
Metadatele afișate în marketplace provin din apelul tău `defineApplication()` din codul sursă al aplicației — câmpuri precum `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` și `termsUrl`.
+
+If your app does not define an `aboutDescription` in `defineApplication()`, the marketplace will automatically use your package's `README.md` from npm as the about page content. This means you can maintain a single README for both npm and the Twenty marketplace. If you want a different description in the marketplace, explicitly set `aboutDescription`.
+
+
### Publicare CI
Proiectul generat include un workflow GitHub Actions care publică la fiecare lansare:
diff --git a/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx
index b34c111303..0c808d3991 100644
--- a/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx
+++ b/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx
@@ -38,7 +38,7 @@ yarn twenty dev
### Gestionarea serverului local
-SDK-ul include comenzi pentru a gestiona un server local de dezvoltare Twenty (imagine Docker all-in-one cu PostgreSQL, Redis, server și worker):
+The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000):
```bash filename="Terminal"
# Pornește serverul local (descarcă imaginea dacă este necesar)
diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/building.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/building.mdx
index 99de2053b8..43ad4112a8 100644
--- a/packages/twenty-docs/l/ru/developers/extend/apps/building.mdx
+++ b/packages/twenty-docs/l/ru/developers/extend/apps/building.mdx
@@ -358,17 +358,17 @@ export default defineApplication({
Если вы планируете [опубликовать приложение](/l/ru/developers/extend/apps/publishing), эти необязательные поля определяют, как ваше приложение отображается в маркетплейсе:
-| Поле | Описание |
-| ------------------ | ------------------------------------------------------------ |
-| `author` | Имя автора или название компании |
-| `category` | Категория приложения для фильтрации в маркетплейсе |
-| `logoUrl` | Путь к логотипу вашего приложения (относительно `./assets/`) |
-| `screenshots` | Массив путей к скриншотам (относительно `./assets/`) |
-| `aboutDescription` | Расширенное описание в Markdown для вкладки "About" |
-| `websiteUrl` | Ссылка на ваш сайт |
-| `termsUrl` | Ссылка на условия предоставления услуг |
-| `emailSupport` | Адрес электронной почты поддержки |
-| `issueReportUrl` | Ссылка на систему отслеживания проблем |
+| Поле | Описание |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------- |
+| `author` | Имя автора или название компании |
+| `category` | Категория приложения для фильтрации в маркетплейсе |
+| `logoUrl` | Путь к логотипу вашего приложения (относительно `./assets/`) |
+| `screenshots` | Массив путей к скриншотам (относительно `./assets/`) |
+| `aboutDescription` | Расширенное описание в Markdown для вкладки "About". Если опущено, маркетплейс использует `README.md` пакета из npm |
+| `websiteUrl` | Ссылка на ваш сайт |
+| `termsUrl` | Ссылка на условия предоставления услуг |
+| `emailSupport` | Адрес электронной почты поддержки |
+| `issueReportUrl` | Ссылка на систему отслеживания проблем |
#### Роли и разрешения
diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx
index 0c96527a5b..5a17cf2376 100644
--- a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started.mdx
@@ -9,18 +9,19 @@ description: Создайте своё первое приложение Twenty
Приложения позволяют расширять Twenty с помощью пользовательских объектов, полей, логических функций, навыков ИИ и UI-компонентов — всё это управляется как код.
-**Что вы можете делать уже сегодня:**
+**What you can build:**
-* Определяйте пользовательские объекты и поля в виде кода (управляемая модель данных)
-* Создавайте логические функции с пользовательскими триггерами (HTTP-маршруты, cron, события базы данных)
-* Определяйте навыки для ИИ-агентов
-* Создавайте фронтенд-компоненты, которые отображаются внутри интерфейса Twenty
-* Развёртывайте одно и то же приложение в нескольких рабочих пространствах
+* Custom objects, fields, views, and navigation items to shape your data model
+* Logic functions triggered by HTTP routes, cron schedules, or database events
+* Front components that render directly inside Twenty's UI
+* Skills that extend Twenty's AI agents
+* Deploy an app across multiple workspaces
## Требования
-* Node.js 24+ и Yarn 4
-* Docker (для локального сервера разработки Twenty)
+* Node.js 24+
+* Yarn 4
+* Docker (or a running local Twenty instance)
## Начало работы
@@ -29,21 +30,9 @@ description: Создайте своё первое приложение Twenty
```bash filename="Terminal"
# Scaffold a new app (includes all examples by default)
npx create-twenty-app@latest my-twenty-app
-cd my-twenty-app
-
-# Start dev mode: automatically syncs local changes to your workspace
-yarn twenty dev
```
-Генератор каркаса поддерживает два режима для управления тем, какие файлы-примеры включаются:
-
-```bash filename="Terminal"
-# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent)
-npx create-twenty-app@latest my-app
-
-# Minimal: only core files (application-config.ts and default-role.ts)
-npx create-twenty-app@latest my-app --minimal
-```
+> Use `--minimal` option to scaffold a minimal installation
Отсюда вы можете:
diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/publishing.mdx
index 34b7bb4b8c..ef19bda214 100644
--- a/packages/twenty-docs/l/ru/developers/extend/apps/publishing.mdx
+++ b/packages/twenty-docs/l/ru/developers/extend/apps/publishing.mdx
@@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production
Метаданные, отображаемые в маркетплейсе, берутся из вызова `defineApplication()` в исходном коде вашего приложения — из таких полей, как `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` и `termsUrl`.
+
+If your app does not define an `aboutDescription` in `defineApplication()`, the marketplace will automatically use your package's `README.md` from npm as the about page content. This means you can maintain a single README for both npm and the Twenty marketplace. If you want a different description in the marketplace, explicitly set `aboutDescription`.
+
+
### Публикация через CI
Сгенерированный шаблоном проект включает рабочий процесс GitHub Actions, который выполняет публикацию при каждом релизе:
@@ -238,8 +242,8 @@ Twenty группирует приложения в три категории в
| --------------------------- | -------------------------------------------------------- | ------------------------------------------------------- |
| `yarn twenty build` | Скомпилировать приложение и сгенерировать манифест | `--tarball` — также создать пакет `.tgz` |
| `yarn twenty publish` | Собрать и опубликовать в npm | `--tag ` — dist-tag npm (например, `beta`, `next`) |
-| `yarn twenty deploy` | Собрать и загрузить tarball на сервер | `-r, --remote ` — целевой remote |
-| `yarn twenty catalog-sync` | Запустить на сервере синхронизацию каталога маркетплейса | `-r, --remote ` — целевой remote |
+| `yarn twenty deploy` | Собрать и загрузить tarball на сервер | `-r, --remote ` — целевой удалённый репозиторий |
+| `yarn twenty catalog-sync` | Запустить на сервере синхронизацию каталога маркетплейса | `-r, --remote ` — целевой удалённый репозиторий |
| `yarn twenty install` | Установить развернутое приложение в рабочем пространстве | `-r, --remote ` — целевой remote |
| `yarn twenty dev` | Отслеживать и синхронизировать локальные изменения | Использует remote по умолчанию |
| `yarn twenty remote add` | Добавить подключение к серверу | `--url`, `--token`, `--as`, `--local`, `--port` |
diff --git a/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx
index 23da2142a5..1050035ec1 100644
--- a/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx
+++ b/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx
@@ -38,7 +38,7 @@ yarn twenty dev
### Управление локальным сервером
-SDK включает команды для управления локальным сервером разработки Twenty (универсальный образ Docker с PostgreSQL, Redis, сервером и воркером):
+The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000):
```bash filename="Terminal"
# Запустить локальный сервер (при необходимости будет загружен образ)
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/building.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/building.mdx
index 576b063822..d5a6126368 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/building.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/building.mdx
@@ -358,17 +358,17 @@ Notlar:
Eğer [uygulamanızı yayımlamayı](/l/tr/developers/extend/apps/publishing) planlıyorsanız, bu isteğe bağlı alanlar uygulamanızın pazaryerinde nasıl görüneceğini kontrol eder:
-| Alan | Açıklama |
-| ------------------ | ------------------------------------------------------------- |
-| `author` | Yazar veya şirket adı |
-| `category` | Pazaryerinde filtreleme için uygulama kategorisi |
-| `logoUrl` | Uygulama logonuzun yolu (`./assets/` dizinine göre) |
-| `screenshots` | Ekran görüntüsü yollarının dizisi (`./assets/` dizinine göre) |
-| `aboutDescription` | "Hakkında" sekmesi için daha uzun bir markdown açıklaması |
-| `websiteUrl` | Web sitenize bağlantı |
-| `termsUrl` | Hizmet Koşulları'na bağlantı |
-| `emailSupport` | Destek e-posta adresi |
-| `issueReportUrl` | Sorun izleyicisine bağlantı |
+| Alan | Açıklama |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `author` | Yazar veya şirket adı |
+| `category` | Pazaryerinde filtreleme için uygulama kategorisi |
+| `logoUrl` | Uygulama logonuzun yolu (`./assets/` dizinine göre) |
+| `screenshots` | Ekran görüntüsü yollarının dizisi (`./assets/` dizinine göre) |
+| `aboutDescription` | "Hakkında" sekmesi için daha uzun bir markdown açıklaması. Belirtilmezse, pazaryeri npm'deki paketin `README.md` dosyasını kullanır |
+| `websiteUrl` | Web sitenize bağlantı |
+| `termsUrl` | Hizmet Koşulları'na bağlantı |
+| `emailSupport` | Destek e-posta adresi |
+| `issueReportUrl` | Sorun izleyicisine bağlantı |
#### Roller ve izinler
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx
index 8526ddf96e..54dab5ca15 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started.mdx
@@ -9,18 +9,19 @@ Uygulamalar şu anda alfa testinde. Özellik işlevsel ancak hâlâ gelişmekte.
Uygulamalar, Twenty'yi özel nesneler, alanlar, mantık işlevleri, Yapay Zeka yetenekleri ve UI bileşenleriyle genişletmenizi sağlar — tümü kod olarak yönetilir.
-**Bugün Yapabilecekleriniz:**
+**What you can build:**
-* Özel nesneleri ve alanları kod olarak tanımlayın (yönetilen veri modeli)
-* Özel tetikleyicilerle mantık işlevleri oluşturun (HTTP routes, cron, database events)
-* Yapay zekâ ajanları için becerileri tanımlayın
-* Twenty'nin UI'si içinde görüntülenen ön bileşenler oluşturun
-* Aynı uygulamayı birden çok çalışma alanına dağıtın
+* Custom objects, fields, views, and navigation items to shape your data model
+* Logic functions triggered by HTTP routes, cron schedules, or database events
+* Front components that render directly inside Twenty's UI
+* Skills that extend Twenty's AI agents
+* Deploy an app across multiple workspaces
## Ön Gereksinimler
-* Node.js 24+ ve Yarn 4
-* Docker (yerel Twenty geliştirme sunucusu için)
+* Node.js 24+
+* Yarn 4
+* Docker (or a running local Twenty instance)
## Başlarken
@@ -29,21 +30,9 @@ Resmi iskelet oluşturucu aracını kullanarak yeni bir uygulama oluşturun, ard
```bash filename="Terminal"
# Scaffold a new app (includes all examples by default)
npx create-twenty-app@latest my-twenty-app
-cd my-twenty-app
-
-# Start dev mode: automatically syncs local changes to your workspace
-yarn twenty dev
```
-İskelet oluşturucu, hangi örnek dosyaların dahil edileceğini kontrol etmek için iki modu destekler:
-
-```bash filename="Terminal"
-# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent)
-npx create-twenty-app@latest my-app
-
-# Minimal: only core files (application-config.ts and default-role.ts)
-npx create-twenty-app@latest my-app --minimal
-```
+> Use `--minimal` option to scaffold a minimal installation
Buradan şunları yapabilirsiniz:
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/publishing.mdx
index 0b8dea60e3..6291fa2015 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/publishing.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/publishing.mdx
@@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production
Pazar yerinde gösterilen meta veriler, uygulamanızın kaynak kodundaki `defineApplication()` çağrısından gelir — `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` ve `termsUrl` gibi alanlar.
+
+If your app does not define an `aboutDescription` in `defineApplication()`, the marketplace will automatically use your package's `README.md` from npm as the about page content. This means you can maintain a single README for both npm and the Twenty marketplace. If you want a different description in the marketplace, explicitly set `aboutDescription`.
+
+
### CI üzerinden yayımlama
İskelet proje, her sürümde yayımlayan bir GitHub Actions iş akışını içerir:
diff --git a/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx
index 4478213a1a..2ca0e9b73b 100644
--- a/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx
@@ -38,7 +38,7 @@ yarn twenty dev
### Yerel Sunucu Yönetimi
-SDK, yerel bir Twenty geliştirme sunucusunu yönetmek için komutlar içerir (PostgreSQL, Redis, sunucu ve worker içeren hepsi bir arada Docker imajı):
+The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000):
```bash filename="Terminal"
# Yerel sunucuyu başlatın (gerekirse imajı indirir)
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/building.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/building.mdx
index 9bab23b73c..ee9f2e0fad 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/building.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/building.mdx
@@ -358,17 +358,17 @@ export default defineApplication({
如果你计划[发布你的应用](/l/zh/developers/extend/apps/publishing)，这些可选字段将控制你的应用在应用市场中的展示：
-| 字段 | 描述 |
-| ------------------ | -------------------------- |
-| `作者` | 作者或公司名称 |
-| `类别` | 用于应用市场筛选的应用类别 |
-| `logoUrl` | 你的应用徽标的路径（相对于 `./assets/`） |
-| `screenshots` | 屏幕截图路径数组（相对于 `./assets/`） |
-| `aboutDescription` | 用于“关于”选项卡的更长 Markdown 描述 |
-| `websiteUrl` | 你的网站链接 |
-| `termsUrl` | 服务条款链接 |
-| `emailSupport` | 支持电子邮件地址 |
-| `issueReportUrl` | 问题跟踪器链接 |
+| 字段 | 描述 |
+| ------------------ | -------------------------------------------------------------- |
+| `作者` | 作者或公司名称 |
+| `类别` | 用于应用市场筛选的应用类别 |
+| `logoUrl` | 你的应用徽标的路径（相对于 `./assets/`） |
+| `screenshots` | 屏幕截图路径数组（相对于 `./assets/`） |
+| `aboutDescription` | 用于“关于”选项卡的更长的 Markdown 描述。 如果省略，市场将使用该软件包在 npm 上的 `README.md`。 |
+| `websiteUrl` | 你的网站链接 |
+| `termsUrl` | 服务条款链接 |
+| `emailSupport` | 支持电子邮件地址 |
+| `issueReportUrl` | 问题跟踪器链接 |
#### 角色和权限
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx
index b42700dd93..13985033a4 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started.mdx
@@ -9,18 +9,19 @@ description: 几分钟内创建你的第一个 Twenty 应用。
应用可通过自定义对象、字段、逻辑函数、AI 技能和 UI 组件来扩展 Twenty——全部以代码进行管理。
-**你现在可以做什么:**
+**What you can build:**
-* 以代码定义自定义对象和字段（受管理的数据模型）
-* 使用自定义触发器（HTTP 路由、cron、数据库事件）构建逻辑函数
-* 为 AI 智能体定义技能
-* 构建在 Twenty 的 UI 中渲染的前端组件
-* 将同一个应用部署到多个工作空间
+* Custom objects, fields, views, and navigation items to shape your data model
+* Logic functions triggered by HTTP routes, cron schedules, or database events
+* Front components that render directly inside Twenty's UI
+* Skills that extend Twenty's AI agents
+* Deploy an app across multiple workspaces
## 先决条件
-* Node.js 24+ 和 Yarn 4
-* Docker (用于本地 Twenty 开发服务器)
+* Node.js 24+
+* Yarn 4
+* Docker (or a running local Twenty instance)
## 开始使用
@@ -29,21 +30,9 @@ description: 几分钟内创建你的第一个 Twenty 应用。
```bash filename="Terminal"
# Scaffold a new app (includes all examples by default)
npx create-twenty-app@latest my-twenty-app
-cd my-twenty-app
-
-# Start dev mode: automatically syncs local changes to your workspace
-yarn twenty dev
```
-脚手架工具支持两种模式，用于控制包含哪些示例文件：
-
-```bash filename="Terminal"
-# Default (exhaustive): all examples (object, field, logic function, front component, view, navigation menu item, skill, agent)
-npx create-twenty-app@latest my-app
-
-# Minimal: only core files (application-config.ts and default-role.ts)
-npx create-twenty-app@latest my-app --minimal
-```
+> Use `--minimal` option to scaffold a minimal installation
从这里您可以：
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/publishing.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/publishing.mdx
index f016e8f6c8..6a50b2f845 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/publishing.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/publishing.mdx
@@ -102,6 +102,10 @@ yarn twenty catalog-sync -r production
市场中显示的元数据来自你在应用源代码中调用的 `defineApplication()` —— 诸如 `displayName`、`description`、`author`、`category`、`logoUrl`、`screenshots`、`aboutDescription`、`websiteUrl` 和 `termsUrl` 等字段。
+
+如果您的应用未在 `defineApplication()` 中定义 `aboutDescription`，市场将自动使用 npm 上您的软件包的 `README.md` 作为关于页面内容。 这意味着您可以为 npm 和 Twenty 市场维护同一个 README。 如果您希望在市场中使用不同的描述，请显式设置 `aboutDescription`。
+
+
### CI 发布
脚手架项目包含一个 GitHub Actions 工作流，会在每次发版时自动发布：
diff --git a/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx
index f7d941a0e1..42d51a45b4 100644
--- a/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx
@@ -38,7 +38,7 @@ yarn twenty dev
### 本地服务器管理
-该 SDK 包含用于管理本地 Twenty 开发服务器的命令（该服务器是一体化 Docker 镜像，内含 PostgreSQL、Redis、服务器和工作进程）：
+The SDK includes commands to manage a local Twenty dev server (all-in-one Docker image with PostgreSQL, Redis, server, and worker on port 2020). These commands only apply to the Docker-based dev server — they do not manage a Twenty instance started from source (e.g. `npx nx start twenty-server` on port 3000):
```bash filename="Terminal"
# Start the local server (pulls the image if needed)