Also covers the built-in Fonts API (stable since Astro 6.0) for zero-layout-shift font loading, dynamic OG image generation with Satori at build time, and CDN integration (Cloudinary, Imgix). Does not cover general SEO meta tags (astro-seo) or deployment-specific image CDN config beyond the adapter itself (astro-deployment).
Astro Assets
Production-ready image optimization and asset management with astro:assets in Astro 7.
Agent Workflow (MANDATORY)
Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:
- fuse-ai-pilot:explore-codebase - Analyze existing image usage and asset patterns
- fuse-ai-pilot:research-expert - Verify astro:assets API via Context7/Exa
- mcp__context7__query-docs - Check Astro 6 Fonts API and image component docs
After implementation, run fuse-ai-pilot:sniper for validation.
Overview
When to Use
- Displaying optimized images with automatic WebP/AVIF conversion
- Building responsive images with multiple breakpoints
- Loading remote images from external CDNs
- Configuring custom fonts without layout shift
- Generating OG images dynamically with Satori
- Integrating Cloudinary or Imgix as image CDN
Key Modules
| Module |
Exports |
astro:assets |
<Image />, <Picture />, getImage() |
@astrojs/sharp |
Default image processing service |
| Fonts API (stable, Astro 6.0+) |
Built-in fonts config |
Core Concepts
Image Component
<Image /> automatically optimizes local and remote images. Always provide alt. Use priority for above-the-fold images. Defaults to WebP output.
Picture Component
<Picture /> generates <source> elements for multiple formats. Use formats={['avif', 'webp']} for best compression with fallback.
getImage()
For server-side image generation (API routes, CSS background images). Returns { src, attributes } object.
Fonts API (stable, Astro 6.0+)
Built-in font optimization via the top-level fonts config in astro.config.mjs (stable since Astro 6.0 — no experimental flag). Zero layout shift, automatic preloading, supports Google Fonts and local fonts.
Reference Guide
Concepts
| Topic |
Reference |
When to Consult |
| Image Component |
image-component.md |
Local/remote image display |
| Responsive Images |
picture-responsive.md |
Multi-format, srcset, sizes |
| Remote Images |
remote-images.md |
External URLs, inferSize |
| Fonts API |
fonts-api.md |
Zero-CLS font loading |
| OG with Satori |
og-satori.md |
Dynamic OG image generation |
| CDN Integration |
cdn-integration.md |
Cloudinary, Imgix setup |
Templates
| Template |
When to Use |
| image-setup.md |
Full image optimization setup |
| og-image-route.md |
Dynamic OG image API route |
Best Practices
- Always provide
alt - Required for accessibility and SEO
- Use
priority for LCP - Above-the-fold images load eagerly
inferSize for remote - Avoids layout shift without known dimensions
- Fonts API over @font-face - Built-in optimization, no manual preload
- Satori at build time - Run OG generation during SSG, not SSR
1---2name: astro-assets3description: Use when optimizing images or other assets in Astro — <Image />, <Picture />, getImage(), Fonts API, or OG image generation.4versions:5 astro: "7"6user-invocable: true7references: references/image-component.md, references/picture-responsive.md, references/remote-images.md, references/fonts-api.md, references/og-satori.md, references/cdn-integration.md, references/templates/image-setup.md, references/templates/og-image-route.md8related-skills: astro-7, astro-seo, astro-deployment9metadata:10 source: https://skillmd.com/skills/fusengine/astro-assets11---1213<objective>14Handles image and asset optimization in Astro 7 via the `astro:assets` module: `<Image />` and `<Picture />` components (automatic WebP/AVIF conversion, responsive `srcset`/`sizes`, required `alt`), `getImage()` for server-side generation (API routes, CSS backgrounds), remote image handling with `inferSize`, and `@astrojs/sharp` as the default processing service.1516Also covers the built-in Fonts API (stable since Astro 6.0) for zero-layout-shift font loading, dynamic OG image generation with Satori at build time, and CDN integration (Cloudinary, Imgix). Does not cover general SEO meta tags (astro-seo) or deployment-specific image CDN config beyond the adapter itself (astro-deployment).17</objective>1819# Astro Assets2021Production-ready image optimization and asset management with `astro:assets` in Astro 7.2223## Agent Workflow (MANDATORY)2425Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:26271. **fuse-ai-pilot:explore-codebase** - Analyze existing image usage and asset patterns282. **fuse-ai-pilot:research-expert** - Verify astro:assets API via Context7/Exa293. **mcp__context7__query-docs** - Check Astro 6 Fonts API and image component docs3031After implementation, run **fuse-ai-pilot:sniper** for validation.3233---3435## Overview3637### When to Use3839- Displaying optimized images with automatic WebP/AVIF conversion40- Building responsive images with multiple breakpoints41- Loading remote images from external CDNs42- Configuring custom fonts without layout shift43- Generating OG images dynamically with Satori44- Integrating Cloudinary or Imgix as image CDN4546### Key Modules4748| Module | Exports |49|--------|---------|50| `astro:assets` | `<Image />`, `<Picture />`, `getImage()` |51| `@astrojs/sharp` | Default image processing service |52| Fonts API (stable, Astro 6.0+) | Built-in `fonts` config |5354---5556## Core Concepts5758### Image Component5960`<Image />` automatically optimizes local and remote images. Always provide `alt`. Use `priority` for above-the-fold images. Defaults to WebP output.6162### Picture Component6364`<Picture />` generates `<source>` elements for multiple formats. Use `formats={['avif', 'webp']}` for best compression with fallback.6566### getImage()6768For server-side image generation (API routes, CSS background images). Returns `{ src, attributes }` object.6970### Fonts API (stable, Astro 6.0+)7172Built-in font optimization via the top-level `fonts` config in `astro.config.mjs` (stable since Astro 6.0 — no experimental flag). Zero layout shift, automatic preloading, supports Google Fonts and local fonts.7374---7576## Reference Guide7778### Concepts7980| Topic | Reference | When to Consult |81|-------|-----------|-----------------|82| **Image Component** | [image-component.md](references/image-component.md) | Local/remote image display |83| **Responsive Images** | [picture-responsive.md](references/picture-responsive.md) | Multi-format, srcset, sizes |84| **Remote Images** | [remote-images.md](references/remote-images.md) | External URLs, inferSize |85| **Fonts API** | [fonts-api.md](references/fonts-api.md) | Zero-CLS font loading |86| **OG with Satori** | [og-satori.md](references/og-satori.md) | Dynamic OG image generation |87| **CDN Integration** | [cdn-integration.md](references/cdn-integration.md) | Cloudinary, Imgix setup |8889### Templates9091| Template | When to Use |92|----------|-------------|93| [image-setup.md](references/templates/image-setup.md) | Full image optimization setup |94| [og-image-route.md](references/templates/og-image-route.md) | Dynamic OG image API route |9596---9798## Best Practices991001. **Always provide `alt`** - Required for accessibility and SEO1012. **Use `priority` for LCP** - Above-the-fold images load eagerly1023. **`inferSize` for remote** - Avoids layout shift without known dimensions1034. **Fonts API over @font-face** - Built-in optimization, no manual preload1045. **Satori at build time** - Run OG generation during SSG, not SSR