Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions Docs/PowerForge.Web.Pipeline.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,9 @@ Builds markdown + theme into static HTML.
```
Notes:
- `clean: true` clears the output directory before building (avoids stale files).
- `language: "pl"` builds a single language slice.
- `languages: ["en","fr","de","es"]` builds a selected multi-language subset into one artifact.
- `languageAsRoot: true` only applies to single-language domain-style builds (for example `evotec.pl` as Polish at `/`).

#### nav-export
Exports a deterministic `site-nav.json` payload (including `surfaces` + `profiles`) from `site.json` + discovered content, without building HTML output.
Expand Down Expand Up @@ -736,6 +739,7 @@ Applies critical CSS, minifies HTML/CSS/JS, optimizes images, and can hash asset
}
```
Notes:
- `minifyHtml`, `minifyCss`, and `minifyJs` default to `false`; the `optimize` task does not minify by name alone, so CI/deploy pipelines should set them explicitly.
- `config` loads `AssetPolicy` from `site.json` (rewrites, hashing defaults, cache headers).
- `hashAssets` fingerprints files and rewrites references (HTML + CSS).
- `cacheHeaders` writes `_headers` with cache-control rules (Netlify/Cloudflare Pages compatible).
Expand Down
8 changes: 8 additions & 0 deletions Docs/PowerForge.Web.WebsiteStarter.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,14 @@ This is compatible with both "standalone themes" and "themes that extend a vendo
- Always run with two modes:
- dev: warn, summarize, stay fast
- ci/release: fail on new issues, enforce budgets
- Always make the performance path explicit:
- add `optimize` to CI/release pipelines with explicit `minifyHtml`, `minifyCss`, and `minifyJs`
- choose `assetRegistry.cssStrategy` intentionally:
- `blocking` when the shell must never flash unstyled during hard navigations or reloads
- `preload` when critical CSS is solid and you want a softer non-blocking path
- `async` only when the theme's critical CSS truly covers the first paint
- prefer `Head.Links` for fonts/preconnects instead of hiding `@import` font loads inside inline theme CSS
- when a site needs first-party copies of remote fonts/CSS, prefer `AssetPolicy.Rewrites` with `SourceUrl` + `DownloadDependencies:true`
- Always keep escape hatches scoped:
- baselines for legacy noise
- do not blanket-ignore whole categories without a written reason
Expand Down
Loading
Loading