Skip to content

Emit bundled Astro assets under the /docs/ prefix - #3271

Merged
enf0rc3 merged 1 commit into
mainfrom
wl/css-path
Jul 30, 2026
Merged

Emit bundled Astro assets under the /docs/ prefix#3271
enf0rc3 merged 1 commit into
mainfrom
wl/css-path

Conversation

@enf0rc3

@enf0rc3 enf0rc3 commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Background

Azure Front Door serves this site at octopus.com/docs and declines anything outside /docs.

See: sources it has is only under docs + octopus-public (this is for the footer actually not deployed by this)

image

Astro emitted its bundled component CSS to /_astro/, so it 404s on the CDN.

Error example:
image

This broke the theme toggle selector and the search styles:

image

This was the first CSS file bundled this way, hence why it didn't exist before.

Result

Sets build.assets: 'docs/_astro' so the bundle lands inside the routed prefix.

AFD only routes /docs/* to the docs origin, so the bundled component CSS
at /_astro/ 404s on octopus.com. Emit it to /docs/_astro/ instead.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@team-marketing-branch-protections

Copy link
Copy Markdown

Pull request environment is available at https://stoctodocspr3271.z22.web.core.windows.net.

You can view the ephemeral environment status in Octopus Deploy.

This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity.

@enf0rc3
enf0rc3 marked this pull request as ready for review July 30, 2026 05:17
@enf0rc3
enf0rc3 requested review from borland and rosslovas July 30, 2026 05:17
@enf0rc3

enf0rc3 commented Jul 30, 2026

Copy link
Copy Markdown
Contributor Author

Tested with dev preview and static site, astro folder now under /docs instead of on root

image

@rosslovas rosslovas left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The ephemeral preview site works. I think we should be good here, nice one 🎉

@enf0rc3
enf0rc3 merged commit b8454b3 into main Jul 30, 2026
7 checks passed
@enf0rc3
enf0rc3 deleted the wl/css-path branch July 30, 2026 05:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants