💡Renamed dev:forward script to dev

closes https://linear.app/ghost/issue/BER-3231/promote-devforward-to-dev

The existing dev script has been renamed to dev:legacy and should be removed 
in the future. Similarly, there is an alias left in place for the dev:forward
command that we can remove in the near future as well. 

The old dev command does not correctly start the new admin shell and should not
be used other than as a temporary escape hatch.

Author: jonatansberg

AGENTS.md

@@ -44,9 +44,9 @@ Two categories of apps:
 ```bash
 yarn                           # Install dependencies
 yarn setup                     # First-time setup (installs deps + submodules)
-yarn dev                       # Local dev (no Docker)
-yarn dev:debug                 # yarn dev with DEBUG=@tryghost*,ghost:* enabled
-yarn dev:forward               # Run Ghost backend with deps in Docker + frontend dev servers
+yarn dev                       # Start development (Docker backend + host frontend dev servers)
+yarn dev:legacy                # Local dev with legacy admin and without Docker (deprecated)
+yarn dev:legacy:debug          # yarn dev:legacy with DEBUG=@tryghost*,ghost:* enabled
 ```
 
 ### Building
@@ -100,9 +100,9 @@ yarn docker:test:unit          # Run unit tests in Docker
 yarn docker:reset              # Reset all Docker volumes (including database) and restart
 ```
 
-### Local development in Docker
+### How yarn dev works
 
-The `yarn dev:forward` command uses a **hybrid Docker + host development** setup:
+The `yarn dev` command uses a **hybrid Docker + host development** setup:
 
 **What runs in Docker:**
 - Ghost Core backend (with hot-reload via mounted source)
@@ -116,7 +116,7 @@ The `yarn dev:forward` command uses a **hybrid Docker + host development** setup
 **Setup:**
 ```bash
 # Start everything (Docker + frontend dev servers)
-yarn dev:forward
+yarn dev
 
 # With optional services (uses Docker Compose file composition)
 yarn dev:analytics             # Include Tinybird analytics

apps/admin-x-settings/README.md

@@ -10,11 +10,11 @@ Ghost Admin Settings micro-frontend.
 
 ### Running the development version
 
-Run `yarn dev` to start the development server to test/develop the settings standalone. This will generate a demo site from the `index.html` file which renders the app and makes it available on http://localhost:5173
+Run `yarn dev` (in this package folder) to start the development server to test/develop the settings standalone. This will generate a demo site from the `index.html` file which renders the app and makes it available on http://localhost:5173
 
 ### Running inside Admin
 
-Run `yarn dev` (like you would run Ghost dev normally) from the top-level repo. AdminX will automatically rebuild when you make changes.
+Run `yarn dev` from the top-level repo. This starts all frontend apps via Docker backend + host dev servers, and AdminX will automatically rebuild when you make changes.
 
 ## Develop
 

apps/admin/README.md

@@ -12,7 +12,7 @@ Uses an **Ember Bridge** system for smooth migration:
 ## Development
 
 ```bash
-# Start development server
+# Start development server (from monorepo root)
 yarn dev
 ```
 

apps/announcement-bar/README.md

@@ -9,7 +9,12 @@
 
 ### Running via Ghost `yarn dev` in root folder
 
-You can automatically start the announcement-bar dev server when developing Ghost by running Ghost (in root folder) via `yarn dev --announcementbar`.
+Announcement Bar runs automatically when using Ghost's development command from the monorepo root:
+```bash
+yarn dev
+```
+
+This starts all frontend apps (including Announcement Bar.)
 
 ## Release
 

apps/comments-ui/README.md

@@ -10,7 +10,10 @@ Comments widget that is embedded at the bottom of posts in Ghost.
 
 ### Running via Ghost `yarn dev` in root folder
 
-You can automatically start the comments dev server when developing Ghost by running Ghost (in root folder) via `yarn dev --all` or `yarn dev --comments`. This will host the comments JavaScript files, and makes sure that Ghost uses these locally hosted assets instead of the ones from the CDN.
+Comments UI runs automatically when using Ghost's development command from the monorepo root:
+```bash
+yarn dev
+```
 
 ## Release
 

apps/portal/README.md

@@ -28,13 +28,12 @@ Refer the [docs](https://ghost.org/help/setup-members/#customize-portal-settings
 
 ## Develop
 
-Run Portal within the Ghost monorepo with:
+Portal runs automatically when using Ghost's development command from the monorepo root:
 ```
-yarn dev --portal
+yarn dev
 ```
 
-Alternatively, use  `yarn dev --all` to load Portal and other supported apps/services, see [dev.js](https://github.com/TryGhost/Ghost/blob/main/.github/scripts/dev.js) for more information.
-
+This starts all frontend apps (including Portal.)
 ---
 
 To run Portal in a standalone fashion, use `yarn start` and open [http://localhost:3000](http://localhost:3000).

apps/signup-form/README.md

@@ -11,9 +11,12 @@ Embed a Ghost signup form on any site.
 
 ### Running via Ghost `yarn dev` in root folder
 
-You can automatically start the signup-form dev server when developing Ghost by running Ghost (in root folder) via `yarn dev --all`. This will only build the production build, without the demo site.
+Signup Form runs automatically when using Ghost's development command from the monorepo root:
+```bash
+yarn dev
+```
 
-Running via `yarn dev --all --signup` or `yarn dev --signup` will also serve the demo site on `http://localhost:6173`.
+This starts all frontend apps (including Signup Form.)
 
 ### Running the development version only
 

apps/sodo-search/README.md

@@ -9,7 +9,12 @@
 
 ### Running via Ghost `yarn dev` in root folder
 
-You can automatically start the Sodo-Search dev server when developing Ghost by running Ghost (in root folder) via `yarn dev --all` or `yarn dev --search`.
+Sodo Search runs automatically when using Ghost's development command from the monorepo root:
+```bash
+yarn dev
+```
+
+This starts all frontend apps (including Sodo Search.)
 
 ## Release
 

docker/ghost-dev/README.md

@@ -28,6 +28,8 @@ This lightweight image:
 This image is used automatically when running:
 
 ```bash
-yarn dev              # Starts Docker + frontend dev servers
-yarn dev:ghost        # Starts only Docker services
+yarn dev              # Starts Docker backend + frontend dev servers on host
+yarn dev:analytics    # Include Tinybird analytics
+yarn dev:storage      # Include MinIO S3-compatible object storage
+yarn dev:all          # Include all optional services
 ```

docs/README.md

@@ -38,7 +38,7 @@ yarn setup
 #### 3. Start Ghost
 
 ```bash
-# Start development server
+# Start development server (uses Docker for backend services)
 yarn dev
 ```