CDNHFX hosts the Scripts/Styles/Images/Fonts used by HtmlForgeX. It is a mirror repository that is published to multiple CDNs so HtmlForgeX can serve assets reliably worldwide.
- Custom domain (recommended): https://cdnhfx.evotec.xyz
- GitHub Pages (latest): https://evotecit.github.io/CDNHFX
- jsDelivr (tagged, immutable): https://cdn.jsdelivr.net/gh/evotecit/cdnhfx@/
- Latest (unversioned):
/Scripts,/Styles,/Images,/Fonts - Versioned:
/v/<VERSION>/Scripts,/v/<VERSION>/Styles,/v/<VERSION>/Images,/v/<VERSION>/Fonts
HtmlForgeX defaults to versioned URLs using the HfxVersion baked into the library.
Versioned:
- https://cdnhfx.evotec.xyz/v/0.3.2/Scripts/dataTables.min.js
- https://cdnhfx.evotec.xyz/v/0.3.2/Styles/hfx-theme.css
Latest:
jsDelivr:
- https://cdn.jsdelivr.net/gh/evotecit/cdnhfx@0.3.2/Scripts/dataTables.min.js
- https://cdn.jsdelivr.net/gh/evotecit/cdnhfx@0.3.2/Fonts/fontawesome-6/fa-solid-900.woff2
- Assets are synced from the HtmlForgeX repository (
HtmlForgeX/Resources/**). - GitHub Actions copies assets to both the latest (root) and versioned (
/v/<VERSION>) paths. - Manual export uses
Build/ExportCdn.ps1from the HtmlForgeX repo when needed.
The root pipeline.json stages the public CDN files into _site through
PowerForge.Web. The build requires PowerShell 7 (pwsh).
powerforge-web pipeline --config ./pipeline.json --mode ciThe host-initiated powerforge-site-pull-deploy lane builds this pipeline and
packages _site for promotion. HtmlForgeX releases continue to supply the assets.
Staging preserves every latest, versioned, and preview path and copies file bytes
unchanged. Only Fonts, Images, Scripts, Styles, v, preview, index.html,
and .nojekyll enter the artifact.
For CI artifact staging or local qualification, select a fresh output directory.
./Build/Stage-CdnSite.ps1 -OutputPath ../cdnhfx-artifactThe destination must be absent or empty. Linked paths and source-overlapping
destinations other than _site are rejected. A failed build requires a fresh
destination before retrying.
Some HtmlForgeX assets are large, customized, or not hosted elsewhere. CDNHFX keeps a single source of truth and provides consistent URLs for HtmlForgeX.