Files
skills/public/deployment-netlify-optimization.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

550 lines
27 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>deployment-netlify-optimization</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/deployment-netlify-optimization.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/deployment-netlify-optimization">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/deployment-netlify-optimization.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>deployment-netlify-optimization</h1><p class="lede">Improving site load times and Core Web Vitals</p><h1>Netlify Optimization</h1>
<p><strong>Scope</strong>: Netlify performance optimization, CDN caching, build optimization, and cost reduction <strong>Lines</strong>: ~310 <strong>Last Updated</strong>: 2025-10-18</p>
<h2>When to Use This Skill</h2>
<p>Activate this skill when:</p>
<ul><li>Improving site load times and Core Web Vitals</li><li>Optimizing build times and reducing CI/CD duration</li><li>Reducing bandwidth costs and Netlify usage</li><li>Implementing effective caching strategies</li><li>Optimizing images, fonts, and static assets</li><li>Leveraging Netlify CDN for global performance</li><li>Debugging slow builds or large bundle sizes</li><li>Setting up incremental builds (Next.js, Gatsby)</li></ul>
<h2>Core Concepts</h2>
<h3>Netlify CDN</h3>
<p><strong>Global edge network</strong>:</p>
<ul><li>100+ edge locations worldwide</li><li>Automatic SSL/TLS</li><li>DDoS protection included</li><li>HTTP/2 and HTTP/3 support</li></ul>
<p><strong>Caching behavior</strong>:</p>
<ul><li>Static assets cached at edge by default</li><li>HTML pages: <code>Cache-Control: public, max-age=0, must-revalidate</code></li><li>Assets: Cached based on headers or defaults</li><li>Cache invalidation on new deploy</li></ul>
<h3>Build Optimization</h3>
<p><strong>Build minutes are limited</strong>:</p>
<ul><li>Starter: 300 min/month</li><li>Pro: 1,000 min/month</li><li>Each build counts toward limit</li></ul>
<p><strong>Optimization strategies</strong>:</p>
<ul><li>Enable build caching</li><li>Use incremental builds (Next.js, Gatsby)</li><li>Optimize dependencies (reduce install time)</li><li>Skip builds for non-code changes</li><li>Use build plugins efficiently</li></ul>
<h3>Performance Budget</h3>
<p><strong>Key metrics</strong>:</p>
<ul><li>Time to First Byte (TTFB): &lt;200ms</li><li>First Contentful Paint (FCP): &lt;1.8s</li><li>Largest Contentful Paint (LCP): &lt;2.5s</li><li>Cumulative Layout Shift (CLS): &lt;0.1</li><li>Time to Interactive (TTI): &lt;3.8s</li></ul>
<hr>
<h2>Patterns</h2>
<h3>Pattern 1: Optimal Cache Headers</h3>
<pre><code class="lang-toml"># netlify.toml - Cache optimization
[[headers]]
for = &quot;/*.html&quot;
[headers.values]
Cache-Control = &quot;public, max-age=0, must-revalidate&quot;
[[headers]]
for = &quot;/assets/*&quot;
[headers.values]
Cache-Control = &quot;public, max-age=31536000, immutable&quot;
[[headers]]
for = &quot;/*.js&quot;
[headers.values]
Cache-Control = &quot;public, max-age=31536000, immutable&quot;
[[headers]]
for = &quot;/*.css&quot;
[headers.values]
Cache-Control = &quot;public, max-age=31536000, immutable&quot;
[[headers]]
for = &quot;/*.woff2&quot;
[headers.values]
Cache-Control = &quot;public, max-age=31536000, immutable&quot;
[[headers]]
for = &quot;/images/*&quot;
[headers.values]
Cache-Control = &quot;public, max-age=2592000, immutable&quot; # 30 days
[[headers]]
for = &quot;/api/*&quot;
[headers.values]
Cache-Control = &quot;no-cache, no-store, must-revalidate&quot;</code></pre>
<p><strong>Best practices</strong>:</p>
<ul><li><strong>HTML</strong>: No cache or short cache (always fresh)</li><li><strong>Hashed assets</strong> (e.g., <code>main.abc123.js</code>): 1 year + immutable</li><li><strong>Non-hashed assets</strong>: Shorter cache (1 day - 30 days)</li><li><strong>API responses</strong>: No cache or short cache with revalidation</li></ul>
<h3>Pattern 2: Image Optimization</h3>
<pre><code class="lang-toml"># netlify.toml - Image optimization plugin
[[plugins]]
package = &quot;@netlify/plugin-image-optim&quot;
[plugins.inputs]
# Optimize quality (0-100)
quality = 85
# Generate WebP versions
formats = [&quot;webp&quot;, &quot;avif&quot;]
# Resize images
maxWidth = 1920
maxHeight = 1080</code></pre>
<p><strong>Next.js Image Optimization</strong>:</p>
<pre><code class="lang-javascript">// next.config.js
module.exports = {
images: {
domains: [&#x27;cdn.example.com&#x27;],
formats: [&#x27;image/avif&#x27;, &#x27;image/webp&#x27;],
deviceSizes: [640, 750, 828, 1080, 1200, 1920],
imageSizes: [16, 32, 48, 64, 96, 128, 256, 384],
},
};</code></pre>
<p><strong>Manual optimization</strong>:</p>
<pre><code class="lang-bash"># Use sharp for build-time optimization
npm install sharp
# Optimize during build
node scripts/optimize-images.js</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Large image assets (&gt;100KB)</li><li>High-traffic sites</li><li>Mobile-first applications</li></ul>
<h3>Pattern 3: Build Caching</h3>
<pre><code class="lang-toml"># netlify.toml - Build plugins for caching
[[plugins]]
package = &quot;netlify-plugin-cache&quot;
[plugins.inputs]
# Cache directories
paths = [
&quot;node_modules&quot;,
&quot;.next/cache&quot;,
&quot;.cache&quot;,
&quot;public/static&quot;,
]</code></pre>
<p><strong>Next.js incremental builds</strong>:</p>
<pre><code class="lang-javascript">// next.config.js
module.exports = {
// Enable Next.js cache
experimental: {
outputStandalone: true,
},
};</code></pre>
<p><strong>Gatsby incremental builds</strong>:</p>
<pre><code class="lang-toml"># netlify.toml
[build.environment]
GATSBY_EXPERIMENTAL_PAGE_BUILD_ON_DATA_CHANGES = &quot;true&quot;
[build]
command = &quot;npm run build&quot;
publish = &quot;public&quot;</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Long build times (&gt;5 minutes)</li><li>Large node_modules</li><li>Next.js or Gatsby projects</li></ul>
<h3>Pattern 4: Skip Builds</h3>
<pre><code class="lang-toml"># netlify.toml - Skip builds conditionally
[build]
command = &quot;npm run build&quot;
publish = &quot;dist&quot;
# Skip build if no relevant changes
ignore = &quot;git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF -- src/ public/&quot;</code></pre>
<p><strong>Skip builds for docs changes</strong>:</p>
<pre><code class="lang-bash"># Only build if src/ or config changed, not docs/
ignore = &quot;git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF -- src/ package.json netlify.toml&quot;</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Monorepo with multiple projects</li><li>Documentation-heavy repos</li><li>Frequent non-code commits</li></ul>
<h3>Pattern 5: Asset Optimization</h3>
<pre><code class="lang-toml"># netlify.toml - Asset optimization
[build]
command = &quot;npm run build &amp;&amp; npm run optimize&quot;
publish = &quot;dist&quot;
[build.processing]
skip_processing = false
[build.processing.css]
bundle = true
minify = true
[build.processing.js]
bundle = true
minify = true
[build.processing.images]
compress = true</code></pre>
<p><strong>Vite bundle optimization</strong>:</p>
<pre><code class="lang-javascript">// vite.config.js
import { defineConfig } from &#x27;vite&#x27;;
export default defineConfig({
build: {
minify: &#x27;terser&#x27;,
terserOptions: {
compress: {
drop_console: true, // Remove console.log in production
},
},
rollupOptions: {
output: {
manualChunks: {
vendor: [&#x27;react&#x27;, &#x27;react-dom&#x27;],
utils: [&#x27;lodash&#x27;, &#x27;date-fns&#x27;],
},
},
},
},
});</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Large JavaScript bundles (&gt;500KB)</li><li>Many dependencies</li><li>Performance-critical applications</li></ul>
<h3>Pattern 6: Prerendering and Caching</h3>
<pre><code class="lang-toml"># netlify.toml - Prerender routes
[[redirects]]
from = &quot;/blog/*&quot;
to = &quot;/blog/:splat&quot;
status = 200
force = true
# Cache prerendered pages
headers = {Cache-Control = &quot;public, max-age=3600, s-maxage=31536000&quot;}
# Cache static API responses
[[redirects]]
from = &quot;/api/static/*&quot;
to = &quot;/.netlify/functions/api-static/:splat&quot;
status = 200
headers = {Cache-Control = &quot;public, max-age=300&quot;} # 5 min cache</code></pre>
<p><strong>On-Demand Builders</strong> (cache until redeploy):</p>
<pre><code class="lang-javascript">// netlify/functions/expensive-page.js
import { builder } from &#x27;@netlify/functions&#x27;;
export const handler = builder(async (event) =&gt; {
// Expensive computation, cached until next deploy
const data = await fetchExpensiveData();
return {
statusCode: 200,
headers: {
&#x27;Content-Type&#x27;: &#x27;application/json&#x27;,
&#x27;Cache-Control&#x27;: &#x27;public, max-age=0, must-revalidate&#x27;,
&#x27;Netlify-CDN-Cache-Control&#x27;: &#x27;public, max-age=31536000&#x27;, // CDN cache 1 year
},
body: JSON.stringify(data),
};
});</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Semi-static content (updates infrequently)</li><li>Expensive API calls</li><li>Database queries that don&#x27;t change often</li></ul>
<h3>Pattern 7: Bundle Analysis</h3>
<pre><code class="lang-bash"># Analyze Next.js bundle
npm install @next/bundle-analyzer
# next.config.js
const withBundleAnalyzer = require(&#x27;@next/bundle-analyzer&#x27;)({
enabled: process.env.ANALYZE === &#x27;true&#x27;,
});
module.exports = withBundleAnalyzer({
// Next.js config
});
# Run analysis
ANALYZE=true npm run build</code></pre>
<p><strong>Vite bundle analysis</strong>:</p>
<pre><code class="lang-bash">npm install rollup-plugin-visualizer
# vite.config.js
import { visualizer } from &#x27;rollup-plugin-visualizer&#x27;;
export default defineConfig({
plugins: [
visualizer({
open: true,
gzipSize: true,
brotliSize: true,
}),
],
});</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Large bundle sizes (&gt;1MB)</li><li>Slow page loads</li><li>High bounce rates</li></ul>
<h3>Pattern 8: Netlify Edge for Performance</h3>
<pre><code class="lang-typescript">// netlify/edge-functions/cache-control.ts
import { Context } from &quot;https://edge.netlify.com&quot;;
export default async (request: Request, context: Context) =&gt; {
const response = await context.next();
// Add caching to specific routes
if (request.url.includes(&#x27;/blog/&#x27;)) {
const headers = new Headers(response.headers);
headers.set(&#x27;Cache-Control&#x27;, &#x27;public, max-age=3600, s-maxage=86400&#x27;);
return new Response(response.body, {
status: response.status,
headers,
});
}
return response;
};
export const config = {
path: &quot;/*&quot;,
};</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Dynamic cache control</li><li>A/B testing without rebuilds</li><li>Personalization with caching</li></ul>
<hr>
<h2>Quick Reference</h2>
<h3>Cache Control Values</h3>
<pre><code>Pattern | Use Case
-------------------------------------------|---------------------------
public, max-age=0, must-revalidate | HTML pages (always fresh)
public, max-age=31536000, immutable | Hashed assets (1 year)
public, max-age=3600 | Semi-static content (1 hour)
no-cache, no-store, must-revalidate | Private/dynamic data
s-maxage=86400 | CDN cache (1 day)</code></pre>
<h3>Build Optimization Checklist</h3>
<pre><code>✅ Enable build caching (node_modules, framework caches)
✅ Use incremental builds (Next.js, Gatsby)
✅ Skip builds for non-code changes
✅ Optimize dependencies (prune unused packages)
✅ Use build plugins efficiently
✅ Cache build artifacts between deploys
✅ Analyze bundle size regularly
✅ Remove console.log in production</code></pre>
<h3>Performance Metrics Targets</h3>
<pre><code>Metric | Good | Needs Improvement | Poor
-----------|---------|-------------------|-------
TTFB | &lt;200ms | 200-600ms | &gt;600ms
FCP | &lt;1.8s | 1.8-3.0s | &gt;3.0s
LCP | &lt;2.5s | 2.5-4.0s | &gt;4.0s
CLS | &lt;0.1 | 0.1-0.25 | &gt;0.25
TTI | &lt;3.8s | 3.8-7.3s | &gt;7.3s</code></pre>
<h3>Asset Optimization Tools</h3>
<pre><code>Asset Type | Tool | Command
-----------|------------------------|---------------------------
Images | sharp | npm install sharp
Images | imagemin | npm install imagemin
CSS | cssnano | npm install cssnano
JS | terser | npm install terser
Fonts | subset-font | npm install subset-font
SVG | svgo | npm install svgo</code></pre>
<h3>Build Plugin Recommendations</h3>
<pre><code>Plugin | Purpose
--------------------------------|---------------------------
@netlify/plugin-image-optim | Image optimization
netlify-plugin-cache | Cache node_modules
@netlify/plugin-lighthouse | Performance audits
netlify-plugin-inline-critical | Inline critical CSS
@netlify/plugin-nextjs | Next.js optimization</code></pre>
<hr>
<h2>Anti-Patterns</h2>
<p>❌ <strong>No cache headers</strong>: Static assets fetched every time ✅ Set long cache for hashed assets, short for HTML</p>
<p>❌ <strong>Large bundle sizes</strong>: Slow page loads, poor UX ✅ Code split, tree shake, analyze bundles</p>
<p>❌ <strong>Unoptimized images</strong>: Large file sizes, slow loads ✅ Use WebP/AVIF, resize, compress, lazy load</p>
<p>❌ <strong>No build caching</strong>: Slow builds, wasted build minutes ✅ Cache node_modules and framework caches</p>
<p>❌ <strong>Building for every commit</strong>: Wasted resources ✅ Skip builds for docs/non-code changes</p>
<p>❌ <strong>No bundle analysis</strong>: Unknown performance bottlenecks ✅ Regularly analyze with tools (bundle-analyzer, lighthouse)</p>
<p>❌ <strong>Synchronous loading</strong>: Blocking render ✅ Async/defer scripts, lazy load images/components</p>
<p>❌ <strong>No performance monitoring</strong>: Issues go unnoticed ✅ Use Netlify Analytics, Lighthouse CI, Real User Monitoring</p>
<hr>
<h2>Related Skills</h2>
<ul><li><code>netlify-deployment.md</code> - Site deployment, build configuration, continuous deployment</li><li><code>netlify-functions.md</code> - Serverless functions, Edge Functions, API optimization</li><li><code>frontend-performance.md</code> - General frontend performance patterns</li><li><code>nextjs-seo.md</code> - Next.js SEO and performance optimization</li><li><code>cdn-configuration.md</code> - CDN strategies and caching patterns</li><li><code>web-vitals-optimization.md</code> - Core Web Vitals improvement techniques</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2025-10-18 <strong>Format Version</strong>: 1.0 (Atomic)</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/deployment-netlify-optimization.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>