Skip to content

[3.x] Add root static file passthrough with new _static/ directory support - #2585

Merged
emmadesilva merged 3 commits into
masterfrom
v3/root-static-passthrough
Aug 10, 2026
Merged

[3.x] Add root static file passthrough with new _static/ directory support#2585
emmadesilva merged 3 commits into
masterfrom
v3/root-static-passthrough

Conversation

@emmadesilva

@emmadesilva emmadesilva commented Aug 10, 2026

Copy link
Copy Markdown
Member

Summary

  • add an optional _static/ convention that copies files verbatim to the compiled site root while preserving relative paths
  • serve _static/ files through the realtime compiler, with _static/media taking precedence over the _media fallback
  • preflight collisions against outputs Hyde is producing in the current build while allowing prior passthrough output to be replaced
  • document the convention without adding scaffold files or configuration

Deleting a source from _static may leave its previous output because Hyde's existing cleaner does not track historical passthrough mappings.

Tests

  • focused static passthrough and realtime compiler tests: 51 passed (159 assertions)
  • FeatureFramework, UnitFramework, and FeatureHyde: 3,812 passed; documented PHP 8.5 FeaturedImageUnitTest failure remains; socket test passed separately with loopback access
  • php monorepo/HydeStan/run.php: no errors

@emmadesilva
emmadesilva temporarily deployed to pr-documentation-2585 August 10, 2026 15:12 — with GitHub Actions Inactive
@codecov

codecov Bot commented Aug 10, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (d9690af) to head (04c2b13).
⚠️ Report is 5 commits behind head on master.

Additional details and impacted files
@@             Coverage Diff             @@
##              master     #2585   +/-   ##
===========================================
  Coverage     100.00%   100.00%           
- Complexity      1807      1815    +8     
===========================================
  Files            183       184    +1     
  Lines           4474      4506   +32     
===========================================
+ Hits            4474      4506   +32     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@emmadesilva
emmadesilva force-pushed the v3/root-static-passthrough branch from 6ad2274 to 705936c Compare August 10, 2026 15:45
@emmadesilva
emmadesilva temporarily deployed to pr-documentation-2585 August 10, 2026 15:46 — with GitHub Actions Inactive
@emmadesilva
emmadesilva force-pushed the v3/root-static-passthrough branch from 705936c to 43a1619 Compare August 10, 2026 16:25
@emmadesilva
emmadesilva temporarily deployed to pr-documentation-2585 August 10, 2026 16:26 — with GitHub Actions Inactive
@emmadesilva
emmadesilva force-pushed the v3/root-static-passthrough branch from 43a1619 to 507535a Compare August 10, 2026 16:51
@emmadesilva
emmadesilva temporarily deployed to pr-documentation-2585 August 10, 2026 16:51 — with GitHub Actions Inactive
@emmadesilva
emmadesilva force-pushed the v3/root-static-passthrough branch from 507535a to 04c2b13 Compare August 10, 2026 17:55
@emmadesilva
emmadesilva marked this pull request as ready for review August 10, 2026 18:25
@emmadesilva emmadesilva changed the title [3.x] Add root static file passthrough [3.x] Add root static file passthrough with new _static/ directory support Aug 10, 2026
@emmadesilva
emmadesilva merged commit 26d138b into master Aug 10, 2026
21 checks passed
@emmadesilva
emmadesilva deleted the v3/root-static-passthrough branch August 10, 2026 18:26
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.

1 participant