diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json new file mode 100644 index 000000000000..944c9a4c822f --- /dev/null +++ b/.devcontainer/devcontainer.json @@ -0,0 +1,24 @@ +{ + "name": "Roo Code", + "image": "mcr.microsoft.com/devcontainers/base:ubuntu-24.04", + "features": { + "ghcr.io/devcontainers/features/node:1": { + "version": "20.19.2", + "pnpm": "10.8.1" + } + }, + "initializeCommand": "mkdir -p ${localEnv:HOME}/.pnpm-store", + "mounts": ["source=${localEnv:HOME}/.pnpm-store,target=/home/vscode/.pnpm-store,type=bind"], + "forwardPorts": [5173], + "postCreateCommand": "corepack enable && corepack prepare pnpm@10.8.1 --activate && pnpm install", + "updateContentCommand": "pnpm install", + "customizations": { + "vscode": { + "settings": { + "npm.packageManager": "pnpm" + }, + "extensions": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode", "ms-vscode.vscode-typescript-next"] + } + }, + "remoteUser": "vscode" +} diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 869b59a16da4..a91422b7dbeb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -94,6 +94,8 @@ All contributions start with a GitHub Issue using our skinny templates. ### Development Setup +0. **Open in the Dev Container:** After cloning, use VS Code's **“Reopen in Container”** command to start the workspace inside the repository's `.devcontainer`. This prepares the correct Node.js and pnpm toolchain automatically. + 1. **Fork & Clone:** ``` diff --git a/README.md b/README.md index 646b5b2112e2..ee02f2e14e4b 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,7 @@ - [简体中文](locales/zh-CN/README.md) - [繁體中文](locales/zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Learn more: [Using Modes](https://docs.roocode.com/basic-usage/using-modes) • ## Local Setup & Development +0. **Open in the Dev Container (recommended):** After cloning the repository, open it in VS Code and run **“Reopen in Container”** so development happens inside the provided `.devcontainer` environment. This ensures the correct Node.js and pnpm versions are available without additional manual setup. + 1. **Clone** the repo: ```sh diff --git a/locales/ca/README.md b/locales/ca/README.md index 67d4cb9c3227..1f468d3104fa 100644 --- a/locales/ca/README.md +++ b/locales/ca/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Més informació: [Ús de Modes](https://docs.roocode.com/basic-usage/using-mode ## Configuració i desenvolupament local +0. **Obre'l al Dev Container (recomanat):** Després de clonar el repositori, obre'l a VS Code i executa "Reopen in Container" perquè el desenvolupament es faci dins de l'entorn `.devcontainer` proporcionat. Això garanteix que les versions correctes de Node.js i pnpm estiguin disponibles sense configuració manual addicional. + 1. **Clona** el repositori: ```sh diff --git a/locales/de/README.md b/locales/de/README.md index 39a15aa65cfe..993bf952a388 100644 --- a/locales/de/README.md +++ b/locales/de/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Mehr erfahren: [Modi verwenden](https://docs.roocode.com/basic-usage/using-modes ## Lokales Setup & Entwicklung +0. **Im Dev Container öffnen (empfohlen):** Nachdem du das Repository geklont hast, öffne es in VS Code und führe "Reopen in Container" aus, damit die Entwicklung in der bereitgestellten `.devcontainer`-Umgebung stattfindet. So stehen die richtigen Node.js- und pnpm-Versionen ohne zusätzlichen manuellen Aufwand zur Verfügung. + 1. **Klone** das Repo: ```sh diff --git a/locales/es/README.md b/locales/es/README.md index fe0d4da9f110..55bbb56b9aff 100644 --- a/locales/es/README.md +++ b/locales/es/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Más info: [Usar Modos](https://docs.roocode.com/basic-usage/using-modes) • [M ## Configuración y desarrollo local +0. **Ábrelo en el Dev Container (recomendado):** Después de clonar el repositorio, ábrelo en VS Code y ejecuta "Reopen in Container" para desarrollar dentro del entorno `.devcontainer` proporcionado. Esto garantiza que las versiones correctas de Node.js y pnpm estén disponibles sin configuración manual adicional. + 1. **Clona** el repositorio: ```sh diff --git a/locales/fr/README.md b/locales/fr/README.md index 23b15e990ff4..c71ae21da4a4 100644 --- a/locales/fr/README.md +++ b/locales/fr/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ En savoir plus : [Utiliser les Modes](https://docs.roocode.com/basic-usage/using ## Configuration et développement local +0. **Ouvrez-le dans le Dev Container (recommandé) :** Après avoir cloné le dépôt, ouvrez-le dans VS Code et exécutez "Reopen in Container" afin de développer dans l'environnement `.devcontainer` fourni. Cela garantit que les bonnes versions de Node.js et de pnpm sont disponibles sans configuration manuelle supplémentaire. + 1. **Clonez** le dépôt : ```sh diff --git a/locales/hi/README.md b/locales/hi/README.md index a5e7a21aa1da..a599b63d9a48 100644 --- a/locales/hi/README.md +++ b/locales/hi/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ ## स्थानीय सेटअप और विकास +0. **Dev Container में खोलें (अनुशंसित):** रेपो क्लोन करने के बाद इसे VS Code में खोलें और "Reopen in Container" चलाएँ ताकि आप प्रदत्त `.devcontainer` वातावरण में ही विकास करें। इससे बिना अतिरिक्त मैनुअल सेटअप के सही Node.js और pnpm संस्करण उपलब्ध रहते हैं। + 1. **क्लोन** करें रेपो: ```sh diff --git a/locales/id/README.md b/locales/id/README.md index b80ba1deef95..5fb8a908b2f9 100644 --- a/locales/id/README.md +++ b/locales/id/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Pelajari lebih lanjut: [Menggunakan Mode](https://docs.roocode.com/basic-usage/u ## Pengaturan & Pengembangan Lokal +0. **Buka di Dev Container (disarankan):** Setelah mengkloning repositori, buka di VS Code dan jalankan "Reopen in Container" agar pengembangan berlangsung di dalam lingkungan `.devcontainer` yang disediakan. Dengan begitu versi Node.js dan pnpm yang tepat sudah tersedia tanpa konfigurasi manual tambahan. + 1. **Clone** repo: ```sh diff --git a/locales/it/README.md b/locales/it/README.md index 6d8ff8370960..05ed0b3704db 100644 --- a/locales/it/README.md +++ b/locales/it/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Scopri di più: [Usare le Modalità](https://docs.roocode.com/basic-usage/using- ## Configurazione e sviluppo locale +0. **Aprilo nel Dev Container (consigliato):** Dopo aver clonato il repository, aprilo in VS Code ed esegui "Reopen in Container" per sviluppare all'interno dell'ambiente `.devcontainer` fornito. Questo garantisce la disponibilità delle versioni corrette di Node.js e pnpm senza ulteriore configurazione manuale. + 1. **Clona** il repository: ```sh diff --git a/locales/ja/README.md b/locales/ja/README.md index e6ff2e85463a..21db91947897 100644 --- a/locales/ja/README.md +++ b/locales/ja/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Roo Codeは、あなたの働き方に合わせるように適応します。 ## ローカルセットアップと開発 +0. **Dev Container で開く（推奨）:** リポジトリをクローンしたら、VS Code で開いて「Reopen in Container」を実行し、提供されている `.devcontainer` 環境内で開発してください。これにより、追加の手動設定なしで正しい Node.js と pnpm のバージョンが利用できます。 + 1. **リポジトリをクローンする**: ```sh diff --git a/locales/ko/README.md b/locales/ko/README.md index d2b32f2861e5..aeea5cb6e894 100644 --- a/locales/ko/README.md +++ b/locales/ko/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Roo Code는 당신의 작업 방식에 맞춰 적응합니다. ## 로컬 설정 및 개발 +0. **Dev Container에서 열기(권장):** 저장소를 클론한 후 VS Code에서 열고 "Reopen in Container"를 실행하여 제공된 `.devcontainer` 환경에서 개발하세요. 그러면 추가 수동 설정 없이 올바른 Node.js 및 pnpm 버전을 사용할 수 있습니다. + 1. **리포지토리 복제**: ```sh diff --git a/locales/nl/README.md b/locales/nl/README.md index 330cbcb66cc6..ccd24ced02a2 100644 --- a/locales/nl/README.md +++ b/locales/nl/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Meer info: [Modi gebruiken](https://docs.roocode.com/basic-usage/using-modes) ## Lokale setup & ontwikkeling +0. **Open in de Dev Container (aanbevolen):** Nadat je de repository hebt gekloond, open je deze in VS Code en voer je "Reopen in Container" uit zodat de ontwikkeling plaatsvindt binnen de meegeleverde `.devcontainer`-omgeving. Zo zijn de juiste Node.js- en pnpm-versies beschikbaar zonder extra handmatige configuratie. + 1. **Kloon** de repo: ```sh diff --git a/locales/pl/README.md b/locales/pl/README.md index 5a07eee01343..cf1614bfe3b6 100644 --- a/locales/pl/README.md +++ b/locales/pl/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Więcej: [Korzystanie z trybów](https://docs.roocode.com/basic-usage/using-mode ## Konfiguracja lokalna i programowanie +0. **Otwórz w Dev Containerze (zalecane):** Po sklonowaniu repozytorium otwórz je w VS Code i uruchom "Reopen in Container", aby pracować w dostarczonym środowisku `.devcontainer`. Dzięki temu odpowiednie wersje Node.js i pnpm będą dostępne bez dodatkowej ręcznej konfiguracji. + 1. **Sklonuj** repozytorium: ```sh diff --git a/locales/pt-BR/README.md b/locales/pt-BR/README.md index 75802fa7f7bf..8eb3d6885db6 100644 --- a/locales/pt-BR/README.md +++ b/locales/pt-BR/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Saiba mais: [Usar Modos](https://docs.roocode.com/basic-usage/using-modes) • [ ## Configuração e Desenvolvimento Local +0. **Abra no Dev Container (recomendado):** Depois de clonar o repositório, abra-o no VS Code e execute "Reopen in Container" para desenvolver dentro do ambiente `.devcontainer` fornecido. Isso garante que as versões corretas do Node.js e do pnpm estejam disponíveis sem configuração manual adicional. + 1. **Clone** o repositório: ```sh diff --git a/locales/ru/README.md b/locales/ru/README.md index eb13c8ae6d0a..979b414f346e 100644 --- a/locales/ru/README.md +++ b/locales/ru/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Roo Code адаптируется к вашему стилю работы, а н ## Локальная настройка и разработка +0. **Откройте в Dev Container (рекомендуется):** После клонирования репозитория откройте его в VS Code и выполните «Reopen in Container», чтобы работать в предоставленной среде `.devcontainer`. Так вы получите нужные версии Node.js и pnpm без дополнительной ручной настройки. + 1. **Клонируйте** репозиторий: ```sh diff --git a/locales/tr/README.md b/locales/tr/README.md index 0b4501f3d806..cf1979610386 100644 --- a/locales/tr/README.md +++ b/locales/tr/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Daha fazla: [Modları kullanma](https://docs.roocode.com/basic-usage/using-modes ## Yerel Kurulum ve Geliştirme +0. **Dev Container'da açın (önerilir):** Depoyu klonladıktan sonra VS Code'da açın ve sağlanan `.devcontainer` ortamında çalışmak için "Reopen in Container" komutunu çalıştırın. Böylece ek manuel kurulum gerekmeden doğru Node.js ve pnpm sürümleri hazır olur. + 1. **Depoyu klonlayın**: ```sh diff --git a/locales/vi/README.md b/locales/vi/README.md index a7ad28dc4727..0b73665ceedd 100644 --- a/locales/vi/README.md +++ b/locales/vi/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Xem thêm: [Sử dụng Chế độ](https://docs.roocode.com/basic-usage/using- ## Cài đặt và phát triển cục bộ +0. **Mở trong Dev Container (được khuyến nghị):** Sau khi nhân bản kho, hãy mở nó trong VS Code và chạy "Reopen in Container" để phát triển trong môi trường `.devcontainer` được cung cấp. Điều này đảm bảo các phiên bản Node.js và pnpm phù hợp luôn sẵn sàng mà không cần cấu hình thủ công bổ sung. + 1. **Sao chép** kho lưu trữ: ```sh diff --git a/locales/zh-CN/README.md b/locales/zh-CN/README.md index 9fcd159c0858..9cfc2b355940 100644 --- a/locales/zh-CN/README.md +++ b/locales/zh-CN/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Roo Code 适应您的工作方式，而不是相反： ## 本地设置与开发 +0. **在 Dev Container 中打开（推荐）：** 克隆仓库后，在 VS Code 中打开并运行“Reopen in Container”，在提供的 `.devcontainer` 环境中进行开发。这样无需额外的手动设置即可使用正确的 Node.js 和 pnpm 版本。 + 1. **克隆**仓库： ```sh diff --git a/locales/zh-TW/README.md b/locales/zh-TW/README.md index a808a11494cd..1ed39064df22 100644 --- a/locales/zh-TW/README.md +++ b/locales/zh-TW/README.md @@ -35,7 +35,7 @@ - [简体中文](../zh-CN/README.md) - [繁體中文](../zh-TW/README.md) - ... - + --- @@ -89,6 +89,8 @@ Roo Code 適應您的工作方式，而不是相反： ## 本地設定與開發 +0. **在 Dev Container 中開啟（建議）：** 完成倉庫複製後，請在 VS Code 中開啟並執行「Reopen in Container」，於提供的 `.devcontainer` 環境中開發。如此一來便能在無需額外手動設定的情況下使用正確的 Node.js 與 pnpm 版本。 + 1. **複製**儲存庫： ```sh