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 e29d460f42..b74445603b 100644 --- a/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx @@ -21,19 +21,51 @@ description: أنشئ وأدِر تخصيصات Twenty على هيئة كود. ## المتطلبات الأساسية * Node.js 24+ وYarn 4 -* مساحة عمل Twenty ومفتاح واجهة برمجة التطبيقات (أنشئ واحدًا على https://app.twenty.com/settings/api-webhooks) +* Docker (لخادم تطوير Twenty المحلي) ## البدء -أنشئ تطبيقًا جديدًا باستخدام المُهيئ الرسمي، ثم قم بالمصادقة وابدأ التطوير: +أنشئ تطبيقًا جديدًا باستخدام المولّد الرسمي. يمكنه بدء مثيل محلي من Twenty تلقائيًا لك: ```bash filename="Terminal" -# إنشاء تطبيق جديد (يتضمن جميع الأمثلة افتراضيًا) +# إنشاء تطبيق جديد — ستعرض واجهة سطر الأوامر خيار بدء خادم Twenty محلي npx create-twenty-app@latest my-twenty-app cd my-twenty-app # ابدأ وضع التطوير: يُزامن التغييرات المحلية تلقائيًا مع مساحة العمل الخاصة بك -yarn twenty app:dev +yarn twenty dev +``` + +### إدارة الخادم المحلي + +يتضمن SDK أوامر لإدارة خادم تطوير Twenty محلي (صورة Docker متكاملة تتضمن PostgreSQL وRedis والخادم والعامل): + +```bash filename="Terminal" +# ابدأ الخادم المحلي (يسحب الصورة إذا لزم الأمر) +yarn twenty server start + +# تحقّق من حالة الخادم +yarn twenty server status + +# بثّ سجلات الخادم +yarn twenty server logs + +# أوقف الخادم +yarn twenty server stop + +# أعد ضبط جميع البيانات وابدأ من جديد +yarn twenty server reset +``` + +يأتي الخادم المحلي مهيأً مسبقًا بمساحة عمل ومستخدم (`tim@apple.dev` / `tim@apple.dev`)، بحيث يمكنك البدء في التطوير فورًا دون أي إعداد يدوي. + +### المصادقة + +وصّل تطبيقك بالخادم المحلي باستخدام OAuth: + +```bash filename="Terminal" +# المصادقة عبر OAuth (يفتح المتصفح) +yarn twenty remote add --local ``` يدعم المُنشئ وضعين للتحكم في ملفات الأمثلة التي سيتم تضمينها: 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 2e691808b1..969f87aed1 100644 --- a/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/de/developers/extend/capabilities/apps.mdx @@ -21,19 +21,51 @@ Mit Apps können Sie Twenty-Anpassungen **als Code** erstellen und verwalten. An ## Voraussetzungen * Node.js 24+ und Yarn 4 -* Ein Twenty-Workspace und ein API-Schlüssel (unter https://app.twenty.com/settings/api-webhooks erstellen) +* Docker (für den lokalen Twenty-Dev-Server) ## Erste Schritte -Erstellen Sie mit dem offiziellen Scaffolder eine neue App, authentifizieren Sie sich und beginnen Sie mit der Entwicklung: +Erstelle eine neue App mit dem offiziellen Scaffolder. Der Scaffolder kann für dich automatisch eine lokale Twenty-Instanz starten: ```bash filename="Terminal" -# Eine neue App erstellen (enthält standardmäßig alle Beispiele) +# Eine neue App erstellen — die CLI bietet an, einen lokalen Twenty-Server zu starten npx create-twenty-app@latest my-twenty-app cd my-twenty-app # Dev-Modus starten: synchronisiert lokale Änderungen automatisch mit deinem Arbeitsbereich -yarn twenty app:dev +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): + +```bash filename="Terminal" +# Den lokalen Server starten (lädt das Image bei Bedarf herunter) +yarn twenty server start + +# Serverstatus prüfen +yarn twenty server status + +# Serverprotokolle streamen +yarn twenty server logs + +# Server stoppen +yarn twenty server stop + +# Alle Daten zurücksetzen und neu starten +yarn twenty server reset +``` + +Der lokale Server ist bereits mit einem Arbeitsbereich und einem Benutzer (`tim@apple.dev` / `tim@apple.dev`) vorbefüllt, sodass Sie ohne manuelle Einrichtung sofort mit der Entwicklung beginnen können. + +### Authentifizierung + +Verbinden Sie Ihre App mithilfe von OAuth mit dem lokalen Server: + +```bash filename="Terminal" +# Authenticate via OAuth (opens browser) +yarn twenty remote add --local ``` Das Scaffolding-Tool unterstützt zwei Modi, um zu steuern, welche Beispieldateien enthalten sind: 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 dbf57a7b23..b651a556a5 100644 --- a/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/it/developers/extend/capabilities/apps.mdx @@ -21,19 +21,51 @@ Le app ti consentono di creare e gestire le personalizzazioni di Twenty **come c ## Prerequisiti * Node.js 24+ e Yarn 4 -* Uno spazio di lavoro Twenty e una chiave API (creane una su https://app.twenty.com/settings/api-webhooks) +* Docker (per il server di sviluppo locale di Twenty) ## Per iniziare -Crea una nuova app utilizzando lo scaffolder ufficiale, quindi autenticati e inizia a sviluppare: +Crea una nuova app utilizzando lo scaffolder ufficiale. Può avviare automaticamente un'istanza locale di Twenty per te: ```bash filename="Terminal" -# Crea lo scaffold di una nuova app (include tutti gli esempi per impostazione predefinita) +# Crea lo scaffold di una nuova app — la CLI offrirà di avviare un server locale di Twenty npx create-twenty-app@latest my-twenty-app cd my-twenty-app # Avvia la modalità di sviluppo: sincronizza automaticamente le modifiche locali con il tuo workspace -yarn twenty app:dev +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): + +```bash filename="Terminal" +# Avvia il server locale (scarica l'immagine se necessario) +yarn twenty server start + +# Verifica lo stato del server +yarn twenty server status + +# Segui i log del server +yarn twenty server logs + +# Arresta il server +yarn twenty server stop + +# Reimposta tutti i dati e riparti da zero +yarn twenty server reset +``` + +Il server locale è preconfigurato con uno spazio di lavoro e un utente (`tim@apple.dev` / `tim@apple.dev`), così puoi iniziare a sviluppare immediatamente senza alcuna configurazione manuale. + +### Autenticazione + +Collega la tua app al server locale tramite OAuth: + +```bash filename="Terminal" +# Autenticati tramite OAuth (apre il browser) +yarn twenty remote add --local ``` Lo strumento di scaffolding supporta due modalità per controllare quali file di esempio vengono inclusi: diff --git a/packages/twenty-docs/l/pt/developers/extend/capabilities/apps.mdx b/packages/twenty-docs/l/pt/developers/extend/capabilities/apps.mdx index 55ec20e5a1..1424624a2b 100644 --- a/packages/twenty-docs/l/pt/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/pt/developers/extend/capabilities/apps.mdx @@ -21,19 +21,51 @@ Os aplicativos permitem criar e gerenciar personalizações do Twenty **como có ## Pré-requisitos * Node.js 24+ e Yarn 4 -* Um espaço de trabalho do Twenty e uma chave de API (crie uma em https://app.twenty.com/settings/api-webhooks) +* Docker (para o servidor de desenvolvimento local do Twenty) ## Primeiros passos -Crie um novo aplicativo usando o gerador oficial, depois autentique-se e comece a desenvolver: +Crie um novo app usando o gerador oficial de estrutura. Ele pode iniciar automaticamente uma instância local do Twenty para você: ```bash filename="Terminal" -# Criar a estrutura de um novo app (inclui todos os exemplos por padrão) +# Criar a estrutura de um novo app — a CLI oferecerá iniciar um servidor local do Twenty npx create-twenty-app@latest my-twenty-app cd my-twenty-app # Iniciar modo de desenvolvimento: sincroniza automaticamente as alterações locais com seu workspace -yarn twenty app:dev +yarn twenty dev +``` + +### Gerenciamento do Servidor Local + +O SDK inclui comandos para gerenciar um servidor de desenvolvimento local do Twenty (imagem Docker all-in-one com PostgreSQL, Redis, servidor e worker): + +```bash filename="Terminal" +# Iniciar o servidor local (faz pull da imagem se necessário) +yarn twenty server start + +# Verificar o status do servidor +yarn twenty server status + +# Transmitir os logs do servidor +yarn twenty server logs + +# Parar o servidor +yarn twenty server stop + +# Redefinir todos os dados e começar do zero +yarn twenty server reset +``` + +O servidor local já vem pré-configurado com um espaço de trabalho e um usuário (`tim@apple.dev` / `tim@apple.dev`), para que você possa começar a desenvolver imediatamente, sem qualquer configuração manual. + +### Autenticação + +Conecte seu aplicativo ao servidor local usando OAuth: + +```bash filename="Terminal" +# Authenticate via OAuth (opens browser) +yarn twenty remote add --local ``` O gerador de estrutura oferece suporte a dois modos para controlar quais arquivos de exemplo são incluídos: 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 93f9fb1d1e..8f8daee6cb 100644 --- a/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/capabilities/apps.mdx @@ -21,19 +21,51 @@ Aplicațiile vă permit să construiți și să gestionați personalizările Twe ## Cerințe * Node.js 24+ și Yarn 4 -* Un spațiu de lucru Twenty și o cheie API (creați una la https://app.twenty.com/settings/api-webhooks) +* Docker (pentru serverul local de dezvoltare Twenty) ## Începeți -Creați o aplicație nouă folosind generatorul oficial, apoi autentificați-vă și începeți să dezvoltați: +Creează o aplicație nouă folosind generatorul oficial. Poate porni automat o instanță Twenty locală pentru tine: ```bash filename="Terminal" -# Creează scheletul unei aplicații noi (include toate exemplele în mod implicit) +# Creează scheletul unei aplicații noi — CLI-ul îți va oferi opțiunea de a porni un server Twenty local npx create-twenty-app@latest my-twenty-app cd my-twenty-app # Pornește modul de dezvoltare: sincronizează automat modificările locale cu spațiul tău de lucru -yarn twenty app:dev +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): + +```bash filename="Terminal" +# Pornește serverul local (descarcă imaginea dacă este necesar) +yarn twenty server start + +# Verifică starea serverului +yarn twenty server status + +# Afișează în timp real jurnalele serverului +yarn twenty server logs + +# Oprește serverul +yarn twenty server stop + +# Resetează toate datele și pornește de la zero +yarn twenty server reset +``` + +Serverul local vine preconfigurat cu un spațiu de lucru și un utilizator (`tim@apple.dev` / `tim@apple.dev`), astfel încât să poți începe să dezvolți imediat, fără nicio configurare manuală. + +### Autentificare + +Conectează-ți aplicația la serverul local folosind OAuth: + +```bash filename="Terminal" +# Autentifică-te prin OAuth (se deschide browserul) +yarn twenty remote add --local ``` Generatorul de schelet acceptă două moduri pentru a controla ce fișiere de exemplu sunt incluse: 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 2aa5f1ad32..f203c0326e 100644 --- a/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/ru/developers/extend/capabilities/apps.mdx @@ -21,19 +21,51 @@ description: Создавайте и управляйте настройками ## Требования * Node.js 24+ и Yarn 4 -* Рабочее пространство Twenty и ключ API (создайте его на https://app.twenty.com/settings/api-webhooks) +* Docker (для локального сервера разработки Twenty) ## Начало работы -Создайте новое приложение с помощью официального генератора, затем выполните аутентификацию и начните разработку: +Создайте новое приложение с помощью официального генератора каркаса. Он может автоматически запустить локальный экземпляр Twenty: ```bash filename="Terminal" -# Создать каркас нового приложения (по умолчанию включает все примеры) +# Создать каркас нового приложения — CLI предложит запустить локальный сервер Twenty npx create-twenty-app@latest my-twenty-app cd my-twenty-app # Запустить режим разработки: автоматически синхронизирует локальные изменения с вашим рабочим пространством -yarn twenty app:dev +yarn twenty dev +``` + +### Управление локальным сервером + +SDK включает команды для управления локальным сервером разработки Twenty (универсальный образ Docker с PostgreSQL, Redis, сервером и воркером): + +```bash filename="Terminal" +# Запустить локальный сервер (при необходимости будет загружен образ) +yarn twenty server start + +# Проверить статус сервера +yarn twenty server status + +# Просмотр логов сервера в реальном времени +yarn twenty server logs + +# Остановить сервер +yarn twenty server stop + +# Сбросить все данные и начать с нуля +yarn twenty server reset +``` + +Локальный сервер уже содержит рабочее пространство и пользователя (`tim@apple.dev` / `tim@apple.dev`), так что вы можете сразу начать разработку без какой-либо ручной настройки. + +### Аутентификация + +Подключите своё приложение к локальному серверу с помощью OAuth: + +```bash filename="Terminal" +# Authenticate via OAuth (opens browser) +yarn twenty remote add --local ``` Генератор каркаса поддерживает два режима для управления тем, какие файлы-примеры включаются: 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 b41b21e55a..861b58a9ac 100644 --- a/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/capabilities/apps.mdx @@ -21,19 +21,51 @@ Uygulamalar, Twenty özelleştirmelerini **kod olarak** oluşturup yönetmenizi ## Ön Gereksinimler * Node.js 24+ ve Yarn 4 -* Bir Twenty çalışma alanı ve bir API anahtarı (https://app.twenty.com/settings/api-webhooks adresinde oluşturun) +* Docker (yerel Twenty geliştirme sunucusu için) ## Başlarken -Resmi scaffolder aracını kullanarak yeni bir uygulama oluşturun, ardından kimlik doğrulaması yapıp geliştirmeye başlayın: +Resmi iskelet oluşturucusunu kullanarak yeni bir uygulama oluşturun. Sizin için otomatik olarak yerel bir Twenty örneğini başlatabilir: ```bash filename="Terminal" -# Yeni bir uygulamanın iskeletini oluşturun (varsayılan olarak tüm örnekleri içerir) +# Yeni bir uygulamanın iskeletini oluşturun — CLI yerel bir Twenty sunucusunu başlatmayı önerecektir npx create-twenty-app@latest my-twenty-app cd my-twenty-app -# Geliştirme modunu başlatın: yerel değişiklikleri otomatik olarak çalışma alanınızla senkronize eder -yarn twenty app:dev +# Geliştirme modunu başlatın: yerel değişiklikleri çalışma alanınızla otomatik olarak senkronize eder +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ı): + +```bash filename="Terminal" +# Yerel sunucuyu başlatın (gerekirse imajı indirir) +yarn twenty server start + +# Sunucu durumunu kontrol edin +yarn twenty server status + +# Sunucu günlüklerini akış olarak görüntüleyin +yarn twenty server logs + +# Sunucuyu durdurun +yarn twenty server stop + +# Tüm verileri sıfırlayın ve temiz bir başlangıç yapın +yarn twenty server reset +``` + +Yerel sunucu, bir çalışma alanı ve kullanıcıyla (`tim@apple.dev` / `tim@apple.dev`) önceden yapılandırılmış olarak gelir; böylece herhangi bir manuel kurulum gerektirmeden hemen geliştirmeye başlayabilirsiniz. + +### Kimlik Doğrulama + +Uygulamanızı OAuth kullanarak yerel sunucuya bağlayın: + +```bash filename="Terminal" +# Authenticate via OAuth (opens browser) +yarn twenty remote add --local ``` İskelet oluşturucu, hangi örnek dosyaların dahil edileceğini kontrol etmek için iki modu destekler: 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 caface1e87..0f863bf599 100644 --- a/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/capabilities/apps.mdx @@ -21,19 +21,51 @@ description: 以代码的形式构建并管理 Twenty 自定义项。 ## 先决条件 * Node.js 24+ 和 Yarn 4 -* 一个 Twenty 工作空间和一个 API 密钥（在 https://app.twenty.com/settings/api-webhooks 创建） +* Docker (用于本地 Twenty 开发服务器) ## 开始使用 -使用官方脚手架创建一个新应用，然后进行身份验证并开始开发： +使用官方脚手架创建一个新应用。 它可以为你自动启动一个本地 Twenty 实例： ```bash filename="Terminal" -# 创建一个新应用脚手架（默认包含所有示例） +# Scaffold a new app — the CLI will offer to start a local Twenty server npx create-twenty-app@latest my-twenty-app cd my-twenty-app -# 启动开发模式：会将本地更改自动同步到你的工作区 -yarn twenty app:dev +# Start dev mode: automatically syncs local changes to your workspace +yarn twenty dev +``` + +### 本地服务器管理 + +该 SDK 包含用于管理本地 Twenty 开发服务器的命令（该服务器是一体化 Docker 镜像，内含 PostgreSQL、Redis、服务器和工作进程）： + +```bash filename="Terminal" +# Start the local server (pulls the image if needed) +yarn twenty server start + +# Check server status +yarn twenty server status + +# Stream server logs +yarn twenty server logs + +# Stop the server +yarn twenty server stop + +# Reset all data and start fresh +yarn twenty server reset +``` + +本地服务器预置了一个工作区和用户 (`tim@apple.dev` / `tim@apple.dev`)，因此你可以无需任何手动设置即可立即开始开发。 + +### 身份验证 + +使用 OAuth 将你的应用连接到本地服务器： + +```bash filename="Terminal" +# 通过 OAuth 进行身份验证 (将打开浏览器) +yarn twenty remote add --local ``` 脚手架工具支持两种模式，用于控制包含哪些示例文件：