diff --git a/docs/en-US/platform/locadex/guides/using-in-monorepos.mdx b/docs/en-US/platform/locadex/guides/using-in-monorepos.mdx
index 1ed7394..636a624 100644
--- a/docs/en-US/platform/locadex/guides/using-in-monorepos.mdx
+++ b/docs/en-US/platform/locadex/guides/using-in-monorepos.mdx
@@ -1,7 +1,7 @@
---
title: Using Locadex in a monorepo
-description: "How to use Locadex within a monorepo: this guide covers configuring the app root directory and commands."
+description: "How to configure Locadex for a monorepo: this guide covers setting the app root directory, how file selection is scoped, and running commands from the right package."
related:
links:
- /docs/platform/locadex/guides/configuring-workflows
@@ -11,23 +11,73 @@ related:
---
-If your Project uses a monorepo, tell Locadex which folder contains the app you want to localize. You can set this app directory in the Locadex settings on the Dashboard.
+When your repository holds more than one app or package, point Locadex at the single app you want to localize. You do this in the Dashboard — there is nothing to install or run yourself.
-## Set the app root directory [#set-app-root]
+## Set the app root directory [#app-root]
-Use the app root directory when your GitHub repository contains multiple apps or packages. Configure at Locadex setup or in Settings. Open **Locadex > Configuration > General**.
+The **App Root Directory** tells Locadex which folder holds the app to localize. Set it during Locadex setup, or later in **Locadex > Configuration > General**.
-Set **App Root Directory** to the path from the repository root to your app. Use `.` or leave the field empty only when the app is at the repository root.
+Set it to the path from the repository root to your app, such as `apps/web`. Use `.` or leave the field empty only when the app is at the repository root.
-## Configure commands [#configure-commands]
+For a repository laid out like this, set **App Root Directory** to `apps/web`:
-Workflow commands run from the repository root.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-If a command needs to run inside the app directory, include the directory change in the command or use your package manager workspace command.
+## How file selection is scoped [#file-scope]
-For example:
+Setting the **App Root Directory** does more than point Locadex at a folder: it scopes which files Locadex reads and translates to that directory. With **App Root Directory** set to `apps/web`, Locadex works within `apps/web` and leaves the rest of the repository alone, so a shared `packages/ui` or a sibling `apps/admin` stays untouched.
+
+Within that directory, Locadex scans the source files it can internationalize — `.ts`, `.tsx`, `.js`, and `.jsx`. You do not edit a config file to change this. When you trigger a Codegen run with **Run Agent**, the **Select Files** step lets you narrow that run to specific files from a file tree.
+
+## Configure commands [#commands]
+
+Locadex runs your workflow commands from the repository root, not from the app root directory. Configure your **Package Manager**, **Linter**, and the per-workflow pre-process and post-process commands in the [Locadex configuration](/docs/platform/locadex/reference/config).
+
+To run a command inside your app, change into the directory first:
```bash
-cd locadex-lab && npm run build
+cd apps/web && npm run build
```
+Or use your package manager's workspace filter, where `web` is the app's `name` in its `package.json`:
+
+
+
+ ```bash
+ npm run build --workspace web
+ ```
+
+
+
+ ```bash
+ yarn workspace web build
+ ```
+
+
+
+ ```bash
+ bun run --filter web build
+ ```
+
+
+
+ ```bash
+ pnpm --filter web build
+ ```
+
+
diff --git a/docs/en-US/platform/locadex/reference/config.mdx b/docs/en-US/platform/locadex/reference/config.mdx
index e043adc..fa6f9c3 100644
--- a/docs/en-US/platform/locadex/reference/config.mdx
+++ b/docs/en-US/platform/locadex/reference/config.mdx
@@ -11,7 +11,7 @@ Use **Locadex > Configuration** to control how Locadex runs in your repository.
General settings apply to the Locadex agent for the Project.
-- **App Root Directory** is the path to your app. Use this for monorepos.
+- **App Root Directory** is the path to your app. Use this for monorepos. Setting it also scopes file selection to that directory, so Locadex reads and translates only the source files under it. See [Using Locadex in a monorepo](/docs/platform/locadex/guides/using-in-monorepos).
- **Package Manager** is used to install dependencies in the sandbox.
- **Linter** runs after changes to preserve code style.
- **Email Reminders** sends reminders about open pull requests after a selected delay.