Skip to content

feat(template): fingerprint local asset URLs - #59

Open
hakula139 wants to merge 1 commit into
mainfrom
feat/asset-fingerprinting
Open

feat(template): fingerprint local asset URLs#59
hakula139 wants to merge 1 commit into
mainfrom
feat/asset-fingerprinting

Conversation

@hakula139

@hakula139 hakula139 commented Jul 19, 2026

Copy link
Copy Markdown
Owner

Summary

  • Resolve the site-overridden theme stylesheet and theme-owned local scripts through kiln's static asset manifest.
  • Raise the minimum kiln version to 0.3.0-rc.2 and document content-hashed local entry assets.
  • Keep generated Pagefind and page-specific assets on their existing paths because kiln creates them after the manifest is built.

Design decisions

  • The template keeps config.base_url separate from asset_url, so subpath deployments retain their public prefix while manifest lookup remains root-relative.
  • Manifest lookup runs against the merged site and theme static tree. A site override such as /css/style.css therefore receives the hash of the file that kiln actually publishes.
  • Kiln preserves the original static paths for compatibility while templates prefer the fingerprinted copies.

Related PRs

Validation

  • nix develop -c pnpm build
  • nix develop -c pnpm format
  • nix develop -c pnpm lint
  • nix develop -c pnpm spellcheck
  • nix flake check
  • Built hakula.xyz-kiln with the exact kiln and IgnIt feature commits
  • Verified emitted CSS and JavaScript fingerprints against the final file bytes
  • GitHub Actions

Resolve the site-overridden stylesheet and every theme-owned script through kiln's static asset manifest. Keep the configured base URL prefix while requiring the kiln release that provides asset_url().
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant