v0.17.5 BLOG EXAMPLE / ALBUMS / STORIES
Photography
blog.
Image-led albums, field notes, and photo essays. Preview the finished page, then inspect the exact source compiled by the current Kudzu release.
02
PROJECT SOURCE
Build it yourself
function Photography({ blog }: { blog: BlogExample }) {
return (
<div className="tpl tpl-photography">
<header>
<a href="#home">
SILVER
<br />
GRAIN
</a>
<span>PHOTOGRAPHS BY NOAH KIM</span>
<nav>
<a href="#series">Series</a>
<a href="#archive">Archive</a>
<a href="/example">Index ↗</a>
</nav>
</header>
<main>
<section className="photo-cover">
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[0].slug}`}>
<figure>
<span>01 / 07</span>
</figure>
</a>
<aside>
<small>PHOTO ESSAY · SEOUL</small>
<h1>
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[0].slug}`}>
{blog.posts[0].title}
</a>
</h1>
<p>
Neon reflected in wet pavement, the hour after everyone has gone
home.
</p>
</aside>
</section>
<section className="photo-story">
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[1].slug}`}>
<figure className="photo-story-1" />
</a>
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[2].slug}`}>
<figure className="photo-story-2" />
</a>
<blockquote>“Rain makes a second city beneath the first.”</blockquote>
<figure className="photo-story-3" />
</section>
<footer>
<span>Next series</span>
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[1].slug}`}>
Atlantic light →
</a>
</footer>
</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 "photography":slug: "photography",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.17.5 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.17.5 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;
}
}
.tpl-photography {
color: #eee;
background: #0b0b0b;
font-family: Arial;
}
.tpl-photography > header {
display: grid;
grid-template-columns: 1fr 1fr 1fr;
align-items: center;
padding: 24px 3vw;
border-bottom: 1px solid #333;
}
.tpl-photography > header > a {
color: #f06442;
font-size: 20px;
font-weight: 800;
line-height: 0.8;
}
.tpl-photography > header > span {
text-align: center;
font: 9px var(--mono);
}
.tpl-photography > header nav {
justify-content: end;
}
.tpl-photography > header nav a {
color: inherit;
}
.tpl-photography > main {
padding: 4vw;
}
.tpl-photography main > footer {
display: flex;
justify-content: space-between;
width: auto;
padding: 50px 0;
border-top: 1px solid #333;
}
.article-photography .article-hero {
background-image: url("https://images.unsplash.com/photo-1449824913935-59a10b8d2000?auto=format&fit=crop&w=1600&q=85");
}
.article-photography article > header h1 {
font-family: Arial;
}
.article-photography article > header > span {
color: #f06442;
}
.photo-cover {
display: grid;
grid-template-columns: 1.45fr 0.55fr;
gap: 40px;
align-items: end;
}
.photo-cover figure {
min-height: 690px;
margin: 0;
padding: 18px;
background: url("https://images.unsplash.com/photo-1449824913935-59a10b8d2000?auto=format&fit=crop&w=1400&q=85")
center/cover;
}
.photo-cover figure span,
.photo-cover small {
font: 9px var(--mono);
}
.photo-cover h1 {
font-size: clamp(50px, 7vw, 98px);
line-height: 0.87;
letter-spacing: -0.07em;
}
.photo-cover p {
color: #999;
line-height: 1.7;
}
.photo-story {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 20px;
margin-top: 120px;
}
.photo-story figure {
min-height: 520px;
margin: 0;
background-size: cover;
}
.photo-story-1 {
background-image: url("https://images.unsplash.com/photo-1519608487953-e999c86e7455?auto=format&fit=crop&w=1000&q=80");
}
.photo-story-2 {
background-image: url("https://images.unsplash.com/photo-1514565131-fce0801e5785?auto=format&fit=crop&w=1000&q=80");
}
.photo-story-3 {
grid-column: 1 / -1;
min-height: 700px !important;
background-image: url("https://images.unsplash.com/photo-1477959858617-67f85cf4f1df?auto=format&fit=crop&w=1500&q=80");
}
.photo-story blockquote {
align-self: center;
padding: 70px;
font: 32px Georgia;
}
@media (max-width: 800px) {
.demo-photo-grid .photo-one {
grid-row: auto;
}
.photo-cover {
grid-template-columns: 1fr;
}
.photo-cover figure {
min-height: 520px;
}
.photo-story {
grid-template-columns: 1fr;
}
.photo-story-3 {
grid-column: auto;
}
}
@media (max-width: 480px) {
.tpl-photography > header > span {
display: none;
}
.photo-story blockquote {
padding: 35px 10px;
}
}