JAVASCRIPT
A practical guide to ESM
JUL 18 · 5 MINv0.16.46 BLOG EXAMPLE / CODE / TUTORIALS
Technical articles, code samples, tags, and series. Preview the finished page, then inspect the exact source compiled by the current Kudzu release.
PROJECT SOURCE
function Developer({ blog }: { blog: BlogExample }) {
return (
<div className="tpl tpl-developer">
<header>
<a href="/example">
undefined<span>.blog</span>
</a>
<nav>
<a href="#articles">/articles</a>
<a href="#snippets">/snippets</a>
<a href="#about">/about</a>
</nav>
</header>
<main>
<section className="dev-lead">
<div>
<span>FEATURED_POST</span>
<h1>
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[0].slug}`}>
Compilers are just
<br />
careful readers<span>_</span>
</a>
</h1>
<p>
A practical tour through ASTs, transforms, and why boring compiler
passes usually win.
</p>
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[0].slug}`}>
readArticle() →
</a>
</div>
<pre>
<code>{`const result = source
|> parse()
|> transform()
|> print()
// no magic required`}</code>
</pre>
</section>
<section className="dev-feed" id="articles">
<header>
<span>RECENT_WRITING</span>
<small>2 entries</small>
</header>
{blog.posts.slice(1).map((post, index) => (
<article>
<span>0{index + 1}</span>
<div>
<small>{index ? "DOM" : "JAVASCRIPT"}</small>
<h2>
<a href={`/example/blog/${blog.slug}/demo/${post.slug}`}>
{post.title}
</a>
</h2>
</div>
<code>{post.meta}</code>
</article>
))}
</section>
<section className="dev-snippet" id="snippets">
<span>SNIPPET_014</span>
<code>const lessCode = bugs.filter(Boolean).length</code>
<button>Copy</button>
</section>
</main>
</div>
);
}export function BlogArticle({ blog, post }: { blog: BlogExample; post: Post }) {
const index = blog.posts.findIndex((entry) => entry.slug === post.slug);
const previous =
blog.posts[(index + blog.posts.length - 1) % blog.posts.length];
const next = blog.posts[(index + 1) % blog.posts.length];
const feature = articleFeature(blog.layout);
const copy = articleCopy(blog.layout);
const section = articleSection(blog.layout);
const deck = articleDeck(blog.layout);
const author = articleAuthor(blog.layout);
const heading = articleHeading(blog.layout);
const quote = articleQuote(blog.layout);
return (
<div className={`article-template article-${blog.layout}`}>
<header>
<a href={`/example/blog/${blog.slug}/demo`}>{blog.publication}</a>
<nav>
<a href={`/example/blog/${blog.slug}/demo`}>All stories</a>
<a href="/example">Kudzu examples ↗</a>
</nav>
</header>
<main>
<div className="article-breadcrumb">
<a href={`/example/blog/${blog.slug}/demo`}>{blog.name}</a>
<span>/</span>
<span>{post.meta}</span>
</div>
<article>
<header>
<span>{section}</span>
<h1>{post.title}</h1>
<p>{deck}</p>
<div>
<span>By {author}</span>
<time>July 25, 2026 · 8 min read</time>
</div>
</header>
<figure
className="article-hero"
role="img"
aria-label={`${post.title} cover`}
/>
<div className="article-content">
{feature}
<div className="article-copy">
<p className="article-opening">{copy[0]}</p>
<h2>{heading}</h2>
<p>{copy[1]}</p>
<blockquote>{quote}</blockquote>
<p>{copy[2]}</p>
</div>
</div>
</article>
<footer className="article-pagination">
<a href={`/example/blog/${blog.slug}/demo/${previous.slug}`}>
<span>← Previous</span>
<strong>{previous.title}</strong>
</a>
<a href={`/example/blog/${blog.slug}/demo/${next.slug}`}>
<span>Next →</span>
<strong>{next.title}</strong>
</a>
</footer>
</main>
</div>
);
}
// Layout-specific feature
case "developer":slug: "developer",import {
BlogDemo,
BlogExample,
blogExamples,
} from "../../../../components/examples/BlogExamples";
import {
inlineStyles,
loadBlogStyles,
} from "../../../../components/examples/ExampleSource";
export const metadata = {
title: "Kudzu Blog Demo",
description: "A static blog design compiled with Kudzu 0.16.46 TSX.",
lang: "en",
locale: "en_US",
siteName: "Kudzu Examples",
styles: true,
};
export function getStaticPaths() {
return blogExamples.map((blog) => ({
params: { slug: blog.slug },
props: { blog },
}));
}
export default async function BlogDemoPage({ blog }: { blog: BlogExample }) {
const css = await loadBlogStyles(blog);
return [inlineStyles(css), BlogDemo({ blog })];
}
import { BlogArticle } from "../../../../../components/examples/BlogArticles";
import {
BlogExample,
blogExamples,
} from "../../../../../components/examples/BlogExamples";
import {
inlineStyles,
loadBlogStyles,
} from "../../../../../components/examples/ExampleSource";
type Post = BlogExample["posts"][number];
export const metadata = {
title: "Kudzu Blog Article Demo",
description: "A statically generated article page compiled with Kudzu 0.16.46 TSX.",
lang: "en",
locale: "en_US",
siteName: "Kudzu Examples",
styles: true,
};
export function getStaticPaths() {
return blogExamples.flatMap((blog) =>
blog.posts.map((post) => ({
params: { slug: blog.slug, post: post.slug },
props: { blog, post },
})),
);
}
export default async function BlogArticlePage({
blog,
post,
}: {
blog: BlogExample;
post: Post;
}) {
const css = await loadBlogStyles(blog);
return [inlineStyles(css), BlogArticle({ blog, post })];
}
.tpl {
min-height: 100vh;
}
.tpl,
.tpl * {
box-sizing: border-box;
}
.tpl > main,
.tpl main {
width: auto;
margin: 0;
}
.tpl a {
text-decoration: none;
}
.tpl button,
.tpl input {
font: inherit;
}
.tpl nav {
font-family: inherit;
}
.tpl h1 a,
.tpl h2 a,
.tpl h3 a {
color: inherit;
}
.tpl .story-link {
display: inline-block;
padding: 11px 14px;
color: inherit;
border: 1px solid currentColor;
}
.article-template {
min-height: 100vh;
color: #25211d;
background: #f3efe7;
font-family: Georgia, serif;
}
.article-template > header,
.article-template > main {
width: min(1120px, calc(100% - 40px));
margin: auto;
}
.article-template > header {
display: flex;
justify-content: space-between;
align-items: center;
min-height: 82px;
border-bottom: 1px solid currentColor;
}
.article-template > header > a {
color: inherit;
font-size: 25px;
font-weight: 700;
}
.article-template > header nav a {
color: inherit;
opacity: 0.7;
}
.article-breadcrumb {
display: flex;
gap: 12px;
padding: 30px 0;
color: #766f67;
font: 10px var(--mono);
text-transform: uppercase;
}
.article-breadcrumb a {
color: inherit;
}
.article-template article > header {
max-width: 920px;
padding: 50px 0 65px;
}
.article-template article > header > p {
max-width: 720px;
font-size: 20px;
line-height: 1.65;
}
.article-template article > header > div {
display: flex;
gap: 30px;
margin-top: 28px;
color: #746c64;
font: 10px var(--mono);
}
.article-hero {
min-height: 620px;
margin: 0;
background: linear-gradient(130deg, #c55e40, #e7b778);
background-position: center;
background-size: cover;
}
.article-content {
display: grid;
grid-template-columns: 240px minmax(0, 680px);
gap: 70px;
justify-content: center;
padding: 80px 0 120px;
}
.article-content > aside {
align-self: start;
display: flex;
flex-direction: column;
gap: 13px;
padding: 22px;
border-top: 3px solid currentColor;
background: #e7dfd2;
font: 11px var(--mono);
line-height: 1.6;
}
.article-content > aside a {
color: inherit;
border-bottom: 1px solid;
}
.article-copy {
font-size: 18px;
line-height: 1.85;
}
.article-copy .article-opening:first-letter {
float: left;
margin: 8px 10px 0 0;
font-size: 76px;
line-height: 0.7;
}
.article-copy h2 {
margin: 60px 0 20px;
font-size: 38px;
line-height: 1.1;
}
.article-copy blockquote {
margin: 55px 0;
padding-left: 28px;
border-left: 3px solid #b64b31;
font: italic 31px/1.45 Georgia;
}
.article-pagination {
display: grid;
grid-template-columns: 1fr 1fr;
width: auto;
padding: 0 0 80px;
border-top: 1px solid currentColor;
}
.article-pagination a {
display: flex;
flex-direction: column;
gap: 12px;
padding: 30px;
color: inherit;
}
.article-pagination a:last-child {
border-left: 1px solid;
text-align: right;
}
.article-pagination span {
color: #81786f;
font: 9px var(--mono);
}
.article-pagination strong {
font-size: 20px;
}
.article-ingredients ul,
.article-takeaways ol {
margin: 0;
padding-left: 20px;
}
.article-developer,
.article-changelog,
.article-photography,
.article-community {
color: #e6edf3;
background: #0d1117;
font-family: var(--mono);
}
.article-developer article > header h1,
.article-changelog article > header h1 {
font-family: var(--mono);
}
.article-developer article > header > span,
.article-changelog article > header > span {
color: #56d29a;
}
.article-developer .article-content > aside,
.article-changelog .article-content > aside,
.article-community .article-content > aside {
background: #161b22;
}
.article-developer .article-copy blockquote,
.article-changelog .article-copy blockquote {
border-color: #56d29a;
}
.article-template article > header > span {
color: #b64b31;
font: 10px var(--mono);
letter-spacing: 0.13em;
}
.article-template article > header h1 {
margin: 22px 0;
font:
600 clamp(60px, 9vw, 120px)/0.87 Georgia,
serif;
letter-spacing: -0.07em;
}
.article-content > aside > strong:first-child,
.article-content > aside > span:first-child {
color: #b64b31;
font-size: 10px;
letter-spacing: 0.1em;
}
.article-editorial .article-hero {
background-image: url("https://images.unsplash.com/photo-1489599849927-2ee91cede3ba?auto=format&fit=crop&w=1500&q=85");
}
@media (max-width: 800px) {
.article-template > header,
.article-template > main {
width: min(100% - 28px, 1120px);
}
.article-content {
grid-template-columns: 1fr;
gap: 40px;
padding-top: 50px;
}
.article-content > aside {
position: static;
}
.article-hero {
min-height: 440px;
}
.tpl > header nav {
display: none;
}
}
@media (max-width: 480px) {
.article-template > header nav a:first-child {
display: none;
}
.article-template article > header > div {
align-items: flex-start;
flex-direction: column;
gap: 8px;
}
.article-pagination {
grid-template-columns: 1fr;
}
.article-pagination a:last-child {
border-top: 1px solid;
border-left: 0;
text-align: left;
}
}
.article-developer .article-hero {
background: linear-gradient(135deg, #0d2d1e, #79f2b5);
}
.tpl-developer {
color: #d7f5e5;
background: #07100c;
font-family: var(--mono);
}
.tpl-developer > header,
.tpl-developer > main {
width: min(1160px, calc(100% - 40px));
margin: auto;
}
.tpl-developer > header {
display: flex;
justify-content: space-between;
align-items: center;
min-height: 74px;
border-bottom: 1px solid #244334;
}
.tpl-developer > header > a {
color: #79f2b5;
font-size: 20px;
font-weight: 800;
}
.tpl-developer > header > a span {
color: #718077;
}
.dev-lead > div > span,
.dev-feed > header span,
.dev-snippet > span {
color: #79f2b5;
font-size: 10px;
letter-spacing: 0.12em;
}
.dev-lead h1 {
margin: 22px 0;
font: 700 clamp(48px, 7vw, 92px)/0.9 var(--mono);
letter-spacing: -0.07em;
}
.dev-lead h1 span {
color: #79f2b5;
}
.article-code code {
padding: 14px;
color: #79f2b5;
background: #07100c;
}
.dev-lead {
display: grid;
grid-template-columns: 1fr 0.75fr;
gap: 60px;
align-items: center;
min-height: 580px;
}
.dev-lead p {
color: #799285;
line-height: 1.7;
}
.dev-lead > div > a {
color: #79f2b5;
}
.dev-lead pre {
padding: 32px;
color: #bce8d0;
border: 1px solid #315942;
background: #0b1912;
line-height: 2;
box-shadow: 12px 12px 0 #10271b;
}
.dev-feed {
border-top: 1px solid #315942;
}
.dev-feed > header {
display: flex;
justify-content: space-between;
padding: 18px 0;
}
.dev-feed article {
display: grid;
grid-template-columns: 60px 1fr auto;
align-items: center;
padding: 25px 0;
border-top: 1px solid #1c3327;
}
.dev-feed article > span,
.dev-feed small,
.dev-feed article > code {
color: #6d8879;
}
.dev-feed h2 {
margin: 7px 0 0;
font-size: 24px;
}
.dev-snippet {
display: grid;
grid-template-columns: 130px 1fr auto;
margin: 70px 0;
padding: 24px;
border: 1px dashed #315942;
}
.dev-snippet button {
color: #79f2b5;
border: 0;
background: none;
}
@media (max-width: 800px) {
.dev-lead {
grid-template-columns: 1fr;
}
.dev-lead {
padding: 70px 0;
}
.dev-feed article {
grid-template-columns: 45px 1fr;
}
.dev-feed article > code {
grid-column: 2;
}
.dev-snippet {
grid-template-columns: 1fr;
gap: 14px;
}
}