[automated commit] Bump docs to versions 2.39.0, 1.53.4

docs/cli.md

@@ -400,6 +400,7 @@ Options:
 * `--types-only` - Generate only the type file.
 * `--types-comment` - Add a comment at the beginning of the auto generated `.d.ts` type definition.
 * `--with-credentials` - Adds "credentials: 'include'" to all fetch requests (only for frontend clients).
+* `--skip-config-update` - If `true`, it will not update the `platformatic|watt` config found in your repo.
 
 
 ### composer

docs/guides/use-watt-multiple-repository.md

@@ -0,0 +1,200 @@
+# Using Watt for Multi-Repository Service 
+
+This guide explains how to use [Watt](https://platformatic.dev/watt) to resolve and manage services from different `git` repositories, build and start your application. You'll learn how to set up, configure, and run a Watt application with multi-repository service resolution.
+
+## Prerequisites
+
+Before beginning, ensure you have installed:
+
+- [Node.js](https://nodejs.org/en) (v20.16.0+ or v22.3.0+)
+- [npm](https://www.npmjs.com/package/npm) (v10 or higher)
+- A code editor (e.g., [Visual Studio Code](https://code.visualstudio.com))
+
+## Project Setup
+
+### Creating Your Watt Application
+
+To create a new Watt application, please refer to our [Watt setup guide](https://www.notion.so/Using-Watt-for-Multi-Repository-Service-Resolution-17b60f428d7e800cbcc3efd396732732?pvs=21).
+
+### Adding Service Resolution
+
+By default, the `wattpm resolve` command isn't included in your Watt application's package.json. You have two options to use it:
+
+1. Run directly via CLI:
+
+```sh
+npx wattpm resolve {repository name and directory path}
+```
+
+2. Add it to your `package.json`:
+
+```json
+{
+  "name": "with-resolve",
+  "private": true,
+  "scripts": {
+    "dev": "wattpm dev",
+    "resolve": "wattpm resolve",
+    "build": "wattpm build",
+    "start": "wattpm start"
+  },
+  "dependencies": {
+    "@platformatic/runtime": "2.21.0",
+    "@platformatic/next": "2.21.0",
+    "@platformatic/node": "2.21.0",
+    "wattpm": "2.21.0"
+  },
+  "devDependencies": {
+    "platformatic": "2.21.0"
+  },
+  "workspaces": [
+    "web/*",
+    "external/*"
+  ]
+}
+```
+
+## Multi-Repository Structure Setup
+
+### Repository Organization
+When working with multiple repositories in Watt, you'll typically have:
+1. A main application repository containing your Watt configuration
+2. One or more service repositories containing individual services
+
+### Setting Up the Main Repository
+
+1. Create your main application repository:
+
+```sh
+mkdir my-watt-app
+cd my-watt-app
+git init
+```
+
+2. Initialize your Watt application:
+
+```sh
+npx wattpm@latest init
+```
+
+
+3. Create the directory structure for external services:
+
+```sh
+mkdir -p web/
+mkdir -p external/
+```
+### Adding Service Repositories
+
+1. Update your root `watt.json` file to define your service repositories:
+
+```sh
+ "web": [
+    {
+      "id": "composer",
+      "path": "web/composer"
+    },
+    {
+      "id": "app",
+      "path": "web/app"
+    },
+    {
+      "id": "node",
+      "path": "{PLT_NODE_PATH}",
+      "url": "YOUR_SERVICE_GITHUB_URL"
+    },
+    {
+      "id": "next",
+      "path": "{PLT_NEXT_PATH}",
+      "url": "YOUR_SERVICE_GITHUB_URL"
+    }
+  ],
+```
+
+### Version Control Configuration
+
+1. Update your main repository's `.gitignore`:
+
+```sh
+# Ignore resolved services
+web/*
+external/*
+!web/.gitkeep
+!external/.gitkeep
+
+# Node modules
+node_modules/
+
+# Environment variables
+.env
+```
+
+2. Update your `package.json` 
+
+In your root `package.json` file and update your workspace to include service workspaces: 
+
+```sh
+{
+  "workspaces": [
+    "web/services/*",
+    "external/services/*"
+  ]
+}
+```
+
+## Working with Services
+
+### Resolving Services
+
+To resolve services located in the web folder of your Watt application, run the below command:
+
+```sh
+npm run resolve
+```
+
+This command fetches and unifies all required services.
+
+### Building the Application
+
+```sh
+npm run build
+```
+
+This command builds the application with all resolved services.
+
+### Starting the Application
+
+Run the command below to start your application in development mode:
+
+```sh
+npm run dev
+```
+
+To run your application in production mode, run the command below:
+
+```sh
+npm start 
+```
+
+## Local Development Configuration
+
+Watt provides flexible options for service resolution during local development. You can configure services to resolve from local directories instead of Git repositories.
+
+### Environment Variables
+
+Configure local development using these environment variables:
+
+- `PLT_NODE_PATH`: Specifies local Node.js service directories
+- `PLT_NEXT_PATH`: Specifies local Next.js service directories
+
+Example configuration:
+
+```sh
+export PLT_NODE_PATH=/path/to/local/service
+export PLT_NEXT_PATH=/path/to/local/nextjs/service
+```
+
+## Additional Resources
+
+- [wattpm-resolve sample application](https://github.com/platformatic/wattpm-resolve)
+- [Watt Setup Guide](https://docs.platformatic.dev/docs/getting-started/quick-start-watt)