Greg Brimble

This commit **enhances the Workers configuration documentation** by integrating a direct link to the **Wrangler configuration** section. It also provides a concise explanation of Wrangler's role, improving the overall clarity and navigability of the `src/content/docs/workers/configuration/index.mdx` file. This **documentation update** ensures users can more easily find and understand how to configure their Workers projects using Wrangler.

This commit improves the user experience for `wrangler secret put` users by providing a clearer error message when interacting with Worker versions. It's an isolated fix that enhances usability without changing core functionality.

This commit provides a **documentation update** by adding a new entry to the **Cloudflare Workers changelog**. It announces a **new capability** for **Workers**, specifically that they now support **reusable Cloudflare Access policies**. This enhancement allows users to define and apply security policies more efficiently across their Workers, simplifying management and improving consistency. The update is located in `src/content/changelog/workers/2025-12-03-reusable-access-policies.mdx`, ensuring users are informed about this significant product improvement.

This commit **updates and expands documentation** for **Cloudflare Workers**, focusing on the new **one-click Cloudflare Access integration** for `workers.dev` and **preview URLs**. It adds a changelog entry announcing this feature, provides updated instructions for enabling Access, and includes details about environment variables and a hero image. The changes enhance user understanding of simplified access management and JWT validation for their Workers.

This commit updates the build process and configuration for the `@cloudflare/pages-shared` package. It's an isolated change primarily affecting the development and release workflow of this shared library.

This commit introduces a **new capability** to improve navigation from **404 pages** by allowing users to open the **global search modal** with a keyboard shortcut (`Cmd+K` or `Ctrl+K`), pre-filling the search input with the current URL path. This functionality is powered by a new **`openGlobalSearch` utility function** added to `src/util/search.ts`, which centralizes the logic for interacting with the DocSearch modal. Concurrently, the **`Sidebar` search functionality** in `src/components/overrides/Sidebar.astro` has been **refactored** to utilize this new utility, eliminating duplicated DocSearch interaction code and enhancing maintainability across the **search subsystem**.

This commit introduces **new keyboard shortcuts** to significantly enhance search accessibility and user experience. A `/` shortcut is added to **focus the sidebar search input** within `Sidebar.astro`, while the `docsearch` plugin is configured to enable `Ctrl/Cmd+K` for the **DocSearch client**, disabling its default `/` to prevent conflicts. The `StarlightDocSearch` component and associated styling are updated to support these new interactions. This **feature enhancement** streamlines how users initiate searches, providing quicker access to both local and global search functionalities.

This change removes the `workers.new` package entirely, representing a significant refactor or deprecation of a worker implementation. Any systems or modules directly depending on `workers.new` will experience a breaking change.

This commit **updates the documentation** for **Workers static assets migration guides** to clarify a key difference in local development environments. Specifically, it adds a note to `src/content/docs/workers/static-assets/migration-guides/migrate-from-pages.mdx` explaining the **default port used by `wrangler dev`** compared to `wrangler pages dev`. This **documentation enhancement** helps users migrating from Pages understand and anticipate port configurations when developing locally with `wrangler dev`.

This commit performs a **refactoring** of the **build environment configuration** by reclassifying **Bun** from a "tool" to a "language". This **maintenance** task updates both the `src/content/pages-build-environment/v2.yaml` and `src/content/pages-build-environment/v3.yaml` files. The change ensures that Bun is accurately categorized as a programming language within the platform's build definitions, improving the logical structure and clarity of available technologies for users. This reclassification impacts how Bun is presented and potentially interpreted by the build system.

This change primarily affects the `create-cloudflare` and `wrangler` template generation systems by removing deprecated templates and standardizing environment variable file handling. Users attempting to create projects with previously available deprecated templates will find them removed, while new projects will benefit from improved consistency in environment variable setup.

This commit introduces a **new capability** for the **Deploy to Cloudflare buttons**, enabling users to pre-configure **Worker environment variables, secrets, and Secrets Store secrets** directly during deployment. The work primarily involves **documentation updates** to `src/content/docs/workers/platform/deploy-buttons.mdx`, detailing how to specify these bindings and providing guidance on binding descriptions. A new changelog entry in `src/content/changelog/workers/` also announces this feature. This enhancement streamlines the deployment of Cloudflare Workers by allowing for more comprehensive and secure initial configurations.

This change graduates an experimental iterative binary search to 100% for the `asset-worker` module, significantly improving performance for asset manifest lookups by replacing the previous recursive approach. All services relying on asset manifest lookups will now benefit from this performance enhancement.

This change affects the `asset-worker`'s performance experimentation, increasing the sample rate for a binary search optimization from 5% to 50%. It's an isolated change to an experiment's configuration, designed to gather more data, and does not directly alter production behavior or introduce new capabilities.

Adds a new observability header to Cloudflare Pages' asset serving, indicating when Web Analytics injection is attempted for HTML responses. This provides a new capability for debugging and monitoring analytics integration.

This commit **updates the Secrets Store documentation page** to utilize a **Beta badge** in the sidebar, removing "Beta" from the main title for improved clarity. To support this, the `handleLink` utility function in `src/util/sidebar.ts` was **refactored** to correctly preserve and pass through existing link badges, preventing their unintended removal. This ensures that **beta features** are consistently and accurately marked within the **Workers Runtime APIs documentation**, enhancing the user experience and improving the presentation of feature statuses.

This commit primarily **enhances the Workers documentation** by adding a new section demonstrating how to configure **custom browser cache behavior for fingerprinted assets**. It introduces a **caching example** within `src/content/partials/workers/custom_headers.mdx` to guide users on optimizing static asset delivery. Additionally, a minor **documentation cleanup** was performed in `src/content/docs/workers/static-assets/direct-upload.mdx` by removing a redundant `IconComponent={Icon}` prop from a `TabItem` component. This update improves the clarity and utility of the **Workers static assets documentation** for developers.

This commit **removes Bun** from the list of package managers displayed by the `PackageManagersComponent`. This **maintenance** task updates the UI in `src/components/PackageManagers.astro` to no longer present Bun as an available option. The change ensures that the user interface accurately reflects the currently supported or relevant package managers, streamlining the choices presented to users.

This commit introduces a **new `PackageManagers` Astro component** (`src/components/PackageManagers.astro`) to **standardize the display of package manager commands** across the documentation. It performs extensive **refactoring** across numerous **documentation pages** (`src/content/docs/**/*.mdx`), replacing direct shell command blocks or existing display components with this new, centralized component. This change improves the **consistency and maintainability** of code examples for various **Cloudflare products and features**, including Workers, D1, R2, Pages, and more, while also removing the dependency on an external `starlight-package-managers` component. The broad scope of this update ensures a uniform and easily updatable presentation of installation and usage commands throughout the entire documentation site.

This commit **fixes** an issue within the **Next.js framework guide documentation** by removing the `type="install"` attribute from `PackageManager` components. This **documentation maintenance** ensures that package manager installation commands are displayed correctly within the `src/content/docs/workers/frameworks/framework-guides/nextjs.mdx` file. The change prevents potential rendering or functionality issues with the install instructions, thereby improving the accuracy and user experience for developers following the Next.js setup guide.