docs: clarify that proxy/middleware matches static assets by default#92441
Merged
Conversation
…fault Add a 'Good to know' callout in the Execution order section explaining that without a configured matcher, Proxy runs on every request including _next/static, _next/image, and public/ files. This helps users avoid silently breaking CSS/JS loading when implementing auth logic in Proxy. Fixes #92435 Co-authored-by: Joseph <icyJoseph@users.noreply.github.com>
…lity The previous callout was in the Execution order section, which is far down the page. Users setting up Proxy will read the Matcher section first, so add the static asset warning there too — right at the top of the section where it explains what matcher does. Co-authored-by: Joseph <icyJoseph@users.noreply.github.com>
Contributor
|
Allow CI Workflow Run
Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer |
Contributor
|
Allow CI Workflow Run
Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer |
Keep the warning only in the Matcher section where it belongs. Co-authored-by: Joseph <icyJoseph@users.noreply.github.com>
Co-authored-by: Joseph <icyJoseph@users.noreply.github.com>
Co-authored-by: Joseph <icyJoseph@users.noreply.github.com>
aurorascharff
approved these changes
Apr 7, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What?
Adds an explicit note about Proxy's default matching behavior at the top of the Matcher section in the Proxy API reference — the first place users look when configuring which paths Proxy runs on.
Why?
Users have reported issues where Tailwind styles and other static assets fail to load because their Proxy auth logic intercepts
_next/staticrequests and redirects them (see #92435). The existing docs mention that Proxy runs on "every route" but don't explicitly call out static assets, image optimizations, or public folder files — making this a common pitfall that gets misdiagnosed as a CSS/PostCSS problem.How?
Added an inline paragraph at the top of the Matcher subsection explaining that without a
matcher, Proxy matches every request — including_next/static,_next/image, andpublic/files — and that this can break asset loading. Links to the existing Negative matching section.Fixes #92435
Slack Thread