docs: enrich documentation with architectural foundations, component descriptions, and external library links across the codebase.

apps/docs-dev/src/setup.md

@@ -1,13 +1,17 @@
 # Local Development Setup
 
+> **Architectural Foundation:** [Node.js](https://nodejs.org/) · [pnpm](https://pnpm.io/) · [Turborepo](https://turbo.build/repo)
+>
+> **Description:** Local development setup guide covering prerequisites (Node.js v20+, pnpm v8), workspace installation, and Turborepo-orchestrated development and build scripts.
+
 ## 🚀 Getting Started
 
 ### Prerequisites
 
 Ensure your local environment matches the following versions to avoid compatibility issues:
 
-* **Node.js**: `v20+` (tested with `v24.11.1`) — required for the `--import tsx` flag used by the desktop prebuild script
-* **pnpm**: `v8.15.6`
+* **[Node.js](https://nodejs.org/)**: `v20+` (tested with `v24.11.1`) — required for the `--import tsx` flag used by the desktop prebuild script
+* **[pnpm](https://pnpm.io/)**: `v8.15.6`
   (Enforced via the `packageManager` field in `package.json`)
 
 ### Installation
@@ -20,7 +24,7 @@ pnpm install
 
 ## 🛠 Usage & Scripts
 
-This repository uses **Turborepo** to orchestrate tasks efficiently. All commands are executed from the root.
+This repository uses **[Turborepo](https://turbo.build/repo)** to orchestrate tasks efficiently. All commands are executed from the root.
 
 ### Development
 
@@ -29,7 +33,7 @@ This repository uses **Turborepo** to orchestrate tasks efficiently. All command
 | `pnpm dev`           | Start **all applications** (`web` and `docs-dev`) in parallel                      |
 | `pnpm dev:web`       | Start only the **Main Web App** (strictly at `http://localhost:5173`)               |
 | `pnpm dev:landing`   | Start the **Public Landing App** (strictly at `http://localhost:3000`)              |
-| `pnpm dev:docs-dev`  | Start **VitePress** for documentation development (strictly at `http://localhost:6060`) |
+| `pnpm dev:docs-dev`  | Start **[VitePress](https://vitepress.dev/)** for documentation development (strictly at `http://localhost:6060`) |
 | `pnpm dev:desktop`   | Start the **Web App + Electron** in parallel for desktop development               |
 
 > [!NOTE]
@@ -44,9 +48,9 @@ This repository uses **Turborepo** to orchestrate tasks efficiently. All command
 | `pnpm build:landing`  | Build only the landing page                             |
 | `pnpm build:docs-dev` | Build only the docs-dev application                     |
 | `pnpm build:desktop`  | Build the web app, then compile the Electron app        |
-| `pnpm test`           | Run unit tests (Vitest) across all packages             |
-| `pnpm lint`           | Run ESLint across the workspace                         |
-| `pnpm format`         | Format code using Prettier                              |
+| `pnpm test`           | Run unit tests ([Vitest](https://vitest.dev/)) across all packages             |
+| `pnpm lint`           | Run [ESLint](https://eslint.org/) across the workspace                         |
+| `pnpm format`         | Format code using [Prettier](https://prettier.io/)                              |
 
 ### 🚀 Desktop Packaging & Distribution
 
@@ -64,7 +68,7 @@ To package the application into a production-ready installer, use the following
 >
 > 1. **`turbo run build --filter=web`** — Compiles the React SPA into `apps/web/dist/`.
 > 2. **`prebuild` hook** — Runs `node --import tsx scripts/copy-web-dist.ts`, which copies `apps/web/dist/` → `apps/desktop/web-dist/`.
-> 3. **`electron-builder`** — Bundles `web-dist/` into the packaged app via the `files` and `extraResources` blocks in `electron-builder.yml`.
+> 3. **[`electron-builder`](https://www.electron.build/)** — Bundles `web-dist/` into the packaged app via the `files` and `extraResources` blocks in `electron-builder.yml`.
 >
 > You do not need to run these steps manually — they are chained via npm scripts.