| name | kirby-performance-and-media |
| description | Improve Kirby performance and media delivery (cache tuning, CDN, responsive images, lazy loading). Use when optimizing page speed, caching, or image handling. |
Kirby Performance and Media
Quick start
- Follow the workflow below, and run a full audit checklist when performance work spans multiple templates or plugins.
Workflow
- Call
kirby_initand readkirby://config/cacheandkirby://config/thumbs. - Inspect templates/snippets that render large collections of images:
kirby_templates_indexkirby_snippets_index
- Search the KB with
kirby_search(examples: "cdn asset and media urls", "lazy loading images", "responsive images srcset", "fine tune page cache", "conditional loading frontend libraries", "tailwindcss build workflow", "purgecss build workflow"). - Apply minimal changes first:
- use
srcset()/sizesfor responsive images - add
loading="lazy"anddecoding="async" - adjust cache ignore rules via blueprint options or fields
- route assets/media through a CDN when required
- use
- Verify output and caching behavior:
kirby_render_page(noCache=true)for HTML- inspect generated media variants and cache headers in a browser