Files
skills/public/deployment-netlify-functions.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

674 lines
29 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-functions</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-functions.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/deployment-netlify-functions">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/deployment-netlify-functions.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-functions</h1><p class="lede">Building API endpoints for JAMstack applications</p><h1>Netlify Functions</h1>
<p><strong>Scope</strong>: Netlify Functions (serverless), Edge Functions, background functions, and API patterns <strong>Lines</strong>: ~330 <strong>Last Updated</strong>: 2025-10-18</p>
<h2>When to Use This Skill</h2>
<p>Activate this skill when:</p>
<ul><li>Building API endpoints for JAMstack applications</li><li>Handling form submissions, webhooks, or third-party integrations</li><li>Implementing authentication, authorization, or session management</li><li>Processing data, images, or files serverlessly</li><li>Running scheduled tasks or background jobs</li><li>Using edge computing for low-latency responses</li><li>Avoiding CORS issues with external APIs</li><li>Creating serverless GraphQL or REST APIs</li></ul>
<h2>Core Concepts</h2>
<h3>Function Types</h3>
<p><strong>Netlify Functions (serverless)</strong>:</p>
<ul><li>Run on AWS Lambda (us-east-1 by default)</li><li>Cold start: ~100-500ms</li><li>Timeout: 10 seconds (free), 26 seconds (Pro)</li><li>Memory: 1024 MB</li><li>Use for: API endpoints, data processing, webhooks</li></ul>
<p><strong>Edge Functions (Deno)</strong>:</p>
<ul><li>Run on Deno Deploy (global edge network)</li><li>Cold start: &lt;10ms</li><li>Timeout: 50 seconds</li><li>Memory: 128 MB</li><li>Use for: Authentication, geo-routing, A/B testing, low-latency APIs</li></ul>
<p><strong>Background Functions</strong>:</p>
<ul><li>Long-running tasks (up to 15 minutes)</li><li>No cold starts (always warm)</li><li>Use for: Data imports, report generation, batch processing</li></ul>
<h3>Function Structure</h3>
<p><strong>Directory structure</strong>:</p>
<pre><code>netlify/
functions/ # Serverless functions
hello.js
api-proxy.ts
edge-functions/ # Edge functions
auth.ts
geo-routing.ts
background-functions/
daily-report.js</code></pre>
<p><strong>Function file = endpoint</strong>:</p>
<ul><li><code>netlify/functions/hello.js</code> → <code>/.netlify/functions/hello</code></li><li><code>netlify/functions/api/users.js</code> → <code>/.netlify/functions/api/users</code></li><li><code>netlify/edge-functions/auth.ts</code> → <code>/</code> (configured in netlify.toml)</li></ul>
<h3>Environment Access</h3>
<p><strong>Environment variables</strong>:</p>
<ul><li>Access via <code>process.env.VAR_NAME</code> (Functions)</li><li>Access via <code>Deno.env.get(&quot;VAR_NAME&quot;)</code> (Edge Functions)</li><li>Set in Netlify UI, CLI, or netlify.toml (non-sensitive)</li></ul>
<p><strong>Context object</strong>:</p>
<ul><li>Request data, headers, query params</li><li>Identity (Netlify Identity user info)</li><li>Geo location (Edge Functions)</li></ul>
<hr>
<h2>Patterns</h2>
<h3>Pattern 1: Basic Netlify Function (Node.js)</h3>
<pre><code class="lang-javascript">// netlify/functions/hello.js
exports.handler = async (event, context) =&gt; {
// event.httpMethod - GET, POST, etc.
// event.path - Request path
// event.headers - Request headers
// event.queryStringParameters - Query params
// event.body - Request body (string)
try {
const name = event.queryStringParameters?.name || &#x27;World&#x27;;
return {
statusCode: 200,
headers: {
&#x27;Content-Type&#x27;: &#x27;application/json&#x27;,
&#x27;Access-Control-Allow-Origin&#x27;: &#x27;*&#x27;, // CORS
},
body: JSON.stringify({
message: `Hello, ${name}!`,
timestamp: new Date().toISOString(),
}),
};
} catch (error) {
return {
statusCode: 500,
body: JSON.stringify({ error: error.message }),
};
}
};</code></pre>
<p><strong>TypeScript version</strong>:</p>
<pre><code class="lang-typescript">// netlify/functions/hello.ts
import { Handler, HandlerEvent, HandlerContext } from &#x27;@netlify/functions&#x27;;
interface HelloResponse {
message: string;
timestamp: string;
}
export const handler: Handler = async (
event: HandlerEvent,
context: HandlerContext
) =&gt; {
const name = event.queryStringParameters?.name || &#x27;World&#x27;;
return {
statusCode: 200,
headers: {
&#x27;Content-Type&#x27;: &#x27;application/json&#x27;,
},
body: JSON.stringify({
message: `Hello, ${name}!`,
timestamp: new Date().toISOString(),
} as HelloResponse),
};
};</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Simple API endpoints</li><li>Webhook handlers</li><li>Form processors</li></ul>
<h3>Pattern 2: POST Request with Body Parsing</h3>
<pre><code class="lang-typescript">// netlify/functions/create-user.ts
import { Handler } from &#x27;@netlify/functions&#x27;;
interface CreateUserBody {
email: string;
name: string;
}
export const handler: Handler = async (event) =&gt; {
// Only allow POST
if (event.httpMethod !== &#x27;POST&#x27;) {
return {
statusCode: 405,
body: JSON.stringify({ error: &#x27;Method not allowed&#x27; }),
};
}
try {
// Parse JSON body
const body: CreateUserBody = JSON.parse(event.body || &#x27;{}&#x27;);
// Validate required fields
if (!body.email || !body.name) {
return {
statusCode: 400,
body: JSON.stringify({ error: &#x27;Missing required fields&#x27; }),
};
}
// Process user creation (e.g., save to database)
const user = await createUser(body);
return {
statusCode: 201,
headers: { &#x27;Content-Type&#x27;: &#x27;application/json&#x27; },
body: JSON.stringify({ user }),
};
} catch (error) {
console.error(&#x27;Error creating user:&#x27;, error);
return {
statusCode: 500,
body: JSON.stringify({ error: &#x27;Internal server error&#x27; }),
};
}
};
async function createUser(data: CreateUserBody) {
// Database logic here
return { id: &#x27;123&#x27;, ...data };
}</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Form submissions</li><li>API mutations</li><li>Webhook receivers</li></ul>
<h3>Pattern 3: API Proxy (Avoid CORS)</h3>
<pre><code class="lang-typescript">// netlify/functions/api-proxy.ts
import { Handler } from &#x27;@netlify/functions&#x27;;
const API_BASE = &#x27;https://external-api.com&#x27;;
const API_KEY = process.env.API_KEY;
export const handler: Handler = async (event) =&gt; {
const path = event.path.replace(&#x27;/.netlify/functions/api-proxy&#x27;, &#x27;&#x27;);
try {
const response = await fetch(`${API_BASE}${path}`, {
method: event.httpMethod,
headers: {
&#x27;Authorization&#x27;: `Bearer ${API_KEY}`,
&#x27;Content-Type&#x27;: &#x27;application/json&#x27;,
},
body: event.body || undefined,
});
const data = await response.text();
return {
statusCode: response.status,
headers: {
&#x27;Content-Type&#x27;: response.headers.get(&#x27;Content-Type&#x27;) || &#x27;application/json&#x27;,
},
body: data,
};
} catch (error) {
return {
statusCode: 500,
body: JSON.stringify({ error: &#x27;Failed to fetch from API&#x27; }),
};
}
};</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Hiding API keys from client</li><li>Avoiding CORS issues</li><li>Adding authentication to external APIs</li></ul>
<h3>Pattern 4: Edge Function (Deno)</h3>
<pre><code class="lang-typescript">// netlify/edge-functions/auth.ts
import { Context } from &quot;https://edge.netlify.com&quot;;
export default async (request: Request, context: Context) =&gt; {
// Access cookies
const token = context.cookies.get(&quot;auth_token&quot;);
// Check authentication
if (!token) {
return new Response(&quot;Unauthorized&quot;, {
status: 401,
headers: {
&quot;Content-Type&quot;: &quot;text/plain&quot;,
},
});
}
// Verify token (simplified)
const isValid = await verifyToken(token);
if (!isValid) {
return new Response(&quot;Invalid token&quot;, { status: 401 });
}
// Continue to origin (pass-through)
return context.next();
};
async function verifyToken(token: string): Promise&lt;boolean&gt; {
// JWT verification logic
return token === &quot;valid-token&quot;;
}
export const config = {
path: &quot;/protected/*&quot;,
};</code></pre>
<p><strong>Configure in netlify.toml</strong>:</p>
<pre><code class="lang-toml">[[edge_functions]]
function = &quot;auth&quot;
path = &quot;/protected/*&quot;</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Authentication gates</li><li>Geo-based routing</li><li>A/B testing</li><li>Header manipulation</li><li>Low-latency responses</li></ul>
<h3>Pattern 5: Edge Function with Geo Routing</h3>
<pre><code class="lang-typescript">// netlify/edge-functions/geo-routing.ts
import { Context } from &quot;https://edge.netlify.com&quot;;
export default async (request: Request, context: Context) =&gt; {
const country = context.geo?.country?.code || &quot;US&quot;;
// Route EU users to different content
if ([&quot;GB&quot;, &quot;FR&quot;, &quot;DE&quot;, &quot;IT&quot;, &quot;ES&quot;].includes(country)) {
return context.rewrite(&quot;/eu/index.html&quot;);
}
// Route APAC users
if ([&quot;JP&quot;, &quot;CN&quot;, &quot;AU&quot;, &quot;SG&quot;].includes(country)) {
return context.rewrite(&quot;/apac/index.html&quot;);
}
// Default: US content
return context.next();
};
export const config = {
path: &quot;/&quot;,
};</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Geo-based content delivery</li><li>Regional compliance (GDPR, etc.)</li><li>Multi-language routing</li><li>Performance optimization</li></ul>
<h3>Pattern 6: Background Function</h3>
<pre><code class="lang-javascript">// netlify/background-functions/daily-report.js
import { schedule } from &#x27;@netlify/functions&#x27;;
// Runs daily at 9 AM UTC
export const handler = schedule(&quot;0 9 * * *&quot;, async (event) =&gt; {
console.log(&quot;Generating daily report...&quot;);
try {
// Long-running task (up to 15 minutes)
const report = await generateReport();
// Send report via email
await sendEmail({
to: process.env.ADMIN_EMAIL,
subject: &quot;Daily Report&quot;,
body: report,
});
return {
statusCode: 200,
body: JSON.stringify({ message: &quot;Report sent successfully&quot; }),
};
} catch (error) {
console.error(&quot;Error generating report:&quot;, error);
return {
statusCode: 500,
body: JSON.stringify({ error: error.message }),
};
}
});
async function generateReport() {
// Expensive computation
return &quot;Report data...&quot;;
}
async function sendEmail(options) {
// Email sending logic
console.log(`Sending email to ${options.to}`);
}</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Scheduled tasks (cron jobs)</li><li>Data imports/exports</li><li>Report generation</li><li>Batch processing</li></ul>
<h3>Pattern 7: Multipart Form Upload</h3>
<pre><code class="lang-typescript">// netlify/functions/upload.ts
import { Handler } from &#x27;@netlify/functions&#x27;;
import multiparty from &#x27;multiparty&#x27;;
export const handler: Handler = async (event) =&gt; {
if (event.httpMethod !== &#x27;POST&#x27;) {
return { statusCode: 405, body: &#x27;Method Not Allowed&#x27; };
}
return new Promise((resolve) =&gt; {
const form = new multiparty.Form();
form.parse(event, async (err, fields, files) =&gt; {
if (err) {
resolve({
statusCode: 400,
body: JSON.stringify({ error: err.message }),
});
return;
}
// Process uploaded file
const file = files.file?.[0];
if (!file) {
resolve({
statusCode: 400,
body: JSON.stringify({ error: &#x27;No file uploaded&#x27; }),
});
return;
}
// Upload to storage (S3, Cloudinary, etc.)
const url = await uploadToStorage(file.path);
resolve({
statusCode: 200,
body: JSON.stringify({ url }),
});
});
});
};
async function uploadToStorage(filePath: string): Promise&lt;string&gt; {
// Upload logic (S3, etc.)
return &#x27;https://cdn.example.com/file.jpg&#x27;;
}</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>File uploads</li><li>Image processing</li><li>CSV imports</li></ul>
<h3>Pattern 8: Rate Limiting</h3>
<pre><code class="lang-typescript">// netlify/functions/rate-limited-api.ts
import { Handler } from &#x27;@netlify/functions&#x27;;
// Simple in-memory rate limiter (use Redis in production)
const requests = new Map&lt;string, number[]&gt;();
const RATE_LIMIT = 10; // requests
const WINDOW_MS = 60000; // 1 minute
export const handler: Handler = async (event) =&gt; {
const ip = event.headers[&#x27;x-forwarded-for&#x27;] || &#x27;unknown&#x27;;
const now = Date.now();
// Get request timestamps for this IP
const timestamps = requests.get(ip) || [];
// Filter timestamps within window
const recentRequests = timestamps.filter(t =&gt; now - t &lt; WINDOW_MS);
// Check rate limit
if (recentRequests.length &gt;= RATE_LIMIT) {
return {
statusCode: 429,
body: JSON.stringify({
error: &#x27;Too many requests&#x27;,
retryAfter: Math.ceil((recentRequests[0] + WINDOW_MS - now) / 1000),
}),
};
}
// Add current request
recentRequests.push(now);
requests.set(ip, recentRequests);
// Process request
return {
statusCode: 200,
body: JSON.stringify({ message: &#x27;Success&#x27; }),
};
};</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Public APIs</li><li>Preventing abuse</li><li>Cost control</li></ul>
<hr>
<h2>Quick Reference</h2>
<h3>Function Types Comparison</h3>
<pre><code>Feature | Functions | Edge Functions | Background
-------------------|----------------|----------------|------------
Runtime | Node.js | Deno | Node.js
Cold Start | 100-500ms | &lt;10ms | None
Timeout | 10-26s | 50s | 15min
Memory | 1024 MB | 128 MB | 1024 MB
Use Case | API endpoints | Auth, routing | Batch jobs</code></pre>
<h3>Common Patterns</h3>
<pre><code>Pattern | Function Type | Example
---------------------|----------------|---------------------------
REST API | Functions | CRUD endpoints
GraphQL | Functions | Apollo Server
Authentication | Edge | JWT validation
Geo routing | Edge | Country-based redirects
Webhooks | Functions | Stripe, GitHub webhooks
Scheduled tasks | Background | Daily reports
File processing | Functions | Image resize
API proxy | Functions | Hide API keys</code></pre>
<h3>Environment Variables</h3>
<pre><code class="lang-bash"># Set via CLI
netlify env:set API_KEY &quot;secret&quot;
# Access in Functions (Node.js)
process.env.API_KEY
# Access in Edge Functions (Deno)
Deno.env.get(&quot;API_KEY&quot;)
# Access Netlify context
event.headers[&quot;x-nf-client-connection-ip&quot;] # Client IP
context.clientContext # Identity info</code></pre>
<h3>Local Development</h3>
<pre><code class="lang-bash"># Start dev server with functions
netlify dev
# Test function locally
curl http://localhost:8888/.netlify/functions/hello
# View function logs
netlify functions:logs hello
# Invoke function
netlify functions:invoke hello --payload &#x27;{&quot;name&quot;:&quot;World&quot;}&#x27;</code></pre>
<h3>Deployment</h3>
<pre><code class="lang-bash"># Deploy functions only
netlify deploy --functions=netlify/functions
# Deploy to production
netlify deploy --prod
# List deployed functions
netlify functions:list</code></pre>
<hr>
<h2>Anti-Patterns</h2>
<p>❌ <strong>Long-running functions exceeding timeout</strong>: Function times out, incomplete work ✅ Use Background Functions for tasks &gt;10 seconds</p>
<p>❌ <strong>No error handling</strong>: Functions crash, 500 errors to users ✅ Wrap in try-catch, return proper status codes</p>
<p>❌ <strong>Ignoring cold starts</strong>: Slow first request ✅ Use Edge Functions for low-latency, or keep Functions warm with pings</p>
<p>❌ <strong>Large dependencies</strong>: Slow cold starts, large bundle size ✅ Minimize dependencies, use ESM tree-shaking</p>
<p>❌ <strong>Storing state in memory</strong>: State lost between invocations ✅ Use external storage (Redis, Postgres, Netlify Blobs)</p>
<p>❌ <strong>No rate limiting</strong>: Abuse, unexpected bills ✅ Implement rate limiting for public APIs</p>
<p>❌ <strong>Hardcoded secrets</strong>: API keys in source code ✅ Use environment variables, never commit secrets</p>
<p>❌ <strong>Synchronous processing in Functions</strong>: Blocking, timeouts ✅ Use async/await, Background Functions for long tasks</p>
<hr>
<h2>Related Skills</h2>
<ul><li><code>netlify-deployment.md</code> - Site deployment, build configuration, continuous deployment</li><li><code>netlify-optimization.md</code> - Performance optimization, caching, cost reduction</li><li><code>aws-serverless.md</code> - AWS Lambda patterns (Netlify Functions run on Lambda)</li><li><code>cloudflare-workers.md</code> - Alternative edge computing platform</li><li><code>api-design-rest.md</code> - REST API design patterns</li><li><code>authentication-jwt.md</code> - JWT authentication implementation</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-functions.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>