From 59a67e68ca54e1b55385a9f5d6aefaac77a619b4 Mon Sep 17 00:00:00 2001
From: Aymeric Rabot <aymeric@pascal.app>
Date: Sun, 19 Jul 2026 18:39:19 +0200
Subject: [PATCH] chore: add a verified Bun devcontainer (#520)

* add devcontainer setup and change default port to 3002

* fix(devcontainer): enforce frozen install

---------

Co-authored-by: victor <victor@elalemanyo.de>
---
 .devcontainer/devcontainer-lock.json | 14 ++++++++++++++
 .devcontainer/devcontainer.json      | 11 +++++++++++
 CONTRIBUTING.md                      |  2 +-
 README.md                            |  2 +-
 SETUP.md                             |  4 ++--
 apps/editor/README.md                |  2 +-
 6 files changed, 30 insertions(+), 5 deletions(-)
 create mode 100644 .devcontainer/devcontainer-lock.json
 create mode 100644 .devcontainer/devcontainer.json

diff --git a/.devcontainer/devcontainer-lock.json b/.devcontainer/devcontainer-lock.json
new file mode 100644
index 00000000..56486348
--- /dev/null
+++ b/.devcontainer/devcontainer-lock.json
@@ -0,0 +1,14 @@
+{
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {
+      "version": "1.3.8",
+      "resolved": "ghcr.io/devcontainers/features/git@sha256:fd75977de13a9979000e0e78baf949adb0ca71d2398995fa22e0a36d7e7e7fe2",
+      "integrity": "sha256:fd75977de13a9979000e0e78baf949adb0ca71d2398995fa22e0a36d7e7e7fe2"
+    },
+    "ghcr.io/devcontainers/features/github-cli:1": {
+      "version": "1.1.0",
+      "resolved": "ghcr.io/devcontainers/features/github-cli@sha256:d22f50b70ed75339b4eed1ba9ecde3a1791f90e88d37936517e3bace0bbad671",
+      "integrity": "sha256:d22f50b70ed75339b4eed1ba9ecde3a1791f90e88d37936517e3bace0bbad671"
+    }
+  }
+}
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 00000000..9f25e0e7
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,11 @@
+{
+  "name": "Pascal Editor",
+  "image": "oven/bun:1.3.0",
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {}
+  },
+  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+  "postCreateCommand": "bun install --frozen-lockfile",
+  "forwardPorts": [3002]
+}
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0ea1545c..e8dae89a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -17,7 +17,7 @@ bun install
 bun dev
 ```
 
-The editor will be running at **http://localhost:3000**. That's it!
+The editor will be running at **http://localhost:3002**. That's it!
 
 ### Optional
 
diff --git a/README.md b/README.md
index b3dd1ec6..dfe5b502 100644
--- a/README.md
+++ b/README.md
@@ -375,7 +375,7 @@ bun dev
 # 1. Build @pascal-app/core and @pascal-app/viewer
 # 2. Start watching both packages for changes
 # 3. Start the Next.js editor dev server
-# Open http://localhost:3000
+# Open http://localhost:3002
 ```
 
 **Important:** Always run `bun dev` from the root directory to ensure the package watchers are running. This enables hot reload when you edit files in `packages/core/src/` or `packages/viewer/src/`.
diff --git a/SETUP.md b/SETUP.md
index 3dfef51f..9ff9aaca 100644
--- a/SETUP.md
+++ b/SETUP.md
@@ -11,7 +11,7 @@ bun install
 bun dev
 ```
 
-The editor will be running at **http://localhost:3000**.
+The editor will be running at **http://localhost:3002**.
 
 ## Environment Variables (optional)
 
@@ -24,7 +24,7 @@ cp .env.example .env
 | Variable | Required | Description |
 |----------|----------|-------------|
 | `NEXT_PUBLIC_GOOGLE_MAPS_API_KEY` | No | Enables address search in the editor |
-| `PORT` | No | Dev server port (default: 3000) |
+| `PORT` | No | Dev server port (default: 3002) |
 
 The editor works fully without any environment variables.
 
diff --git a/apps/editor/README.md b/apps/editor/README.md
index ae7e0f62..ea6e6066 100644
--- a/apps/editor/README.md
+++ b/apps/editor/README.md
@@ -345,7 +345,7 @@ pnpm install
 # Run development server
 pnpm dev
 
-# Open http://localhost:3000
+# Open http://localhost:3002
 ```
 
 ---