Merge branch 'main' into guolau/restore-cli-missing-pages

Author: guolau

api-reference/openapi.json

@@ -1,16 +1,22 @@
 ---
-title: Using Constructs
-description: 'Build monitoring infrastructure with reusable TypeScript classes'
+title: Using Checkly CLI Constructs
+description: 'Build monitoring infrastructure using JavaScript/TypeScript and the Checkly CLI'
 sidebarTitle: 'Overview'
 ---
 
 import JsTsNote from '/snippets/js-ts-note.mdx';
 import ChecklyConfigCodeBlock from '/snippets/checkly-config-example-code-block.mdx';
 
+
 Every resource you create using the [Checkly CLI](/cli/overview/) is represented by a "construct": it's a class you import from `checkly/constructs`,
 for instance an `ApiCheck` or `EmailAlertChannel`. A construct is the "as-code" representation of the eventual resource 
 created / deleted / updated on the Checkly cloud once you run `npx checkly deploy`.
 
+<Tip>
+  You must install the [Checkly CLI](/cli/overview) before you can use constructs.
+</Tip>
+
+Constructs are JavaScript/TypeScript classes that represent your all monitoring resources. Import them from `checkly/constructs` to create checks, alert channels, and other resources in code.
 
 <CodeGroup dropdown>
 

constructs/overview.mdx

@@ -6,12 +6,17 @@ sidebarTitle: 'Custom Dependencies'
 
 Use the [Checkly CLI](/cli/) to turn your Playwright tests into globally distributed monitors. Checkly uses your existing `package.json` dependencies and Playwright configuration.
 
+<Info>
+**Runtime Environment**: Playwright Check Suites run in a Node.js runtime containing your custom dependencies. See the [runtime specification](/platform/runtimes/runtime-specification) for further details.
+</Info>
+
 ## Using JavaScript/Node.js dependencies
 
 Checkly installs dependencies from your `package.json` and lock files. It works with [npm](https://www.npmjs.com/), [yarn](https://yarnpkg.com/), and [pnpm](https://pnpm.io/).
 
 By default, Checkly installs all dependencies (both `dependencies` and `devDependencies`). You can change this setting to install only `devDependencies` in your [account settings](https://app.checklyhq.com/accounts/settings/account/playwright).
 
+
 ```json package.json
 {
   "dependencies": {
@@ -131,6 +136,28 @@ export default defineConfig({
 })
 ```
 
+## Dependency Caching
+
+Checkly caches installed packages between check runs to speed up execution and reduce installation time. Dependencies are installed once and reused for subsequent runs until your lock files (`package-lock.json`, `pnpm-lock.yaml`, or `yarn.lock`) change.
+
+### How caching works
+
+When dependency caching is enabled:
+
+1. On the first run, Checkly installs all packages from your lock file and stores them in cache
+2. On subsequent runs, Checkly checks if your lock file has changed
+3. If unchanged, Checkly uses the cached packages, skipping the installation step
+4. If changed, Checkly installs packages again and updates the cache
+
+This significantly reduces check execution time, especially for projects with many or large dependencies.
+
+### Cache behavior by location type
+
+**Public Locations**: Dependency caching is **Always ON**.
+
+**Private Locations**: Dependency caching is **OFF by default**. To enable caching and speed up check runs, set `DEPENDENCY_CACHE=CHECKLY_S3` in your [agent configuration](/platform/private-locations/agent-configuration).
+
+
 ## Troubleshooting
 
 ### Package not found