The coastal road to Essaouira
6 days · Road trip
v0.16.46 BLOG EXAMPLE / PLACES / GUIDES
Destination journals led by photography and itineraries. Preview the finished page, then inspect the exact source compiled by the current Kudzu release.
PROJECT SOURCE
function Travel({ blog }: { blog: BlogExample }) {
return (
<div className="tpl tpl-travel">
<header>
<a href="#home">ELSEWHERE</a>
<nav>
<a href="#destinations">Destinations</a>
<a href="#guides">Field guides</a>
<a href="/example">Examples</a>
</nav>
</header>
<main>
<section className="travel-cover">
<div>
<span>FIELD GUIDE 014 · PORTUGAL</span>
<h1>
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[0].slug}`}>
{blog.posts[0].title}
</a>
</h1>
<p>
Volcanic paths, ocean weather, and taking the long way around.
</p>
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[0].slug}`}>
Explore Madeira →
</a>
</div>
<aside>
<strong>7 DAYS</strong>
<span>12 PLACES</span>
<span>1 SMALL CAR</span>
</aside>
</section>
<section className="travel-recent" id="destinations">
<header>
<div>
<span>RECENT JOURNEYS</span>
<h2>Go somewhere slowly.</h2>
</div>
<a href={`/example/blog/${blog.slug}/demo/${blog.posts[1].slug}`}>
View latest guide →
</a>
</header>
<div>
{blog.posts.slice(1).map((post, index) => (
<article>
<a
className={`travel-image travel-image-${index + 1}`}
href={`/example/blog/${blog.slug}/demo/${post.slug}`}
>
<span>{index ? "JAPAN" : "MOROCCO"}</span>
</a>
<h3>
<a href={`/example/blog/${blog.slug}/demo/${post.slug}`}>
{post.title}
</a>
</h3>
<p>{index ? "3 days · City guide" : "6 days · Road trip"}</p>
</article>
))}
</div>
</section>
<section className="travel-plan">
<span>THE POCKET ITINERARY</span>
<h2>48 hours with no reservations.</h2>
<ol>
<li>
<time>08:00</time> Walk the old harbor
</li>
<li>
<time>13:30</time> Lunch above the market
</li>
<li>
<time>18:45</time> Follow the light west
</li>
</ol>
</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 "travel":slug: "travel",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;
}
}
.tpl-travel {
color: #f8f3df;
background: #17312f;
font-family: Arial;
}
.tpl-travel > header {
position: absolute;
left: 50%;
z-index: 1;
display: flex;
justify-content: space-between;
align-items: center;
width: min(1200px, calc(100% - 40px));
min-height: 82px;
transform: translateX(-50%);
border-bottom: 1px solid #ffffff55;
}
.tpl-travel > header > a {
color: inherit;
font: 700 28px Georgia;
letter-spacing: 0.1em;
}
.tpl-travel > header nav a {
color: inherit;
}
.article-travel {
color: #f6f0de;
background: #17312f;
}
.article-travel .article-hero {
background-image: url("https://images.unsplash.com/photo-1488646953014-85cb44e25828?auto=format&fit=crop&w=1600&q=85");
}
.article-travel .article-content > aside {
background: #21433f;
}
.article-travel article > header > span {
color: #ffcf70;
}
.travel-cover {
min-height: 760px;
display: flex;
justify-content: space-between;
align-items: end;
padding: 120px max(24px, calc((100vw - 1200px) / 2)) 70px;
background:
linear-gradient(0deg, #102d2aaa, transparent 70%),
url("https://images.unsplash.com/photo-1488646953014-85cb44e25828?auto=format&fit=crop&w=1800&q=85")
center/cover;
}
.travel-cover > div {
max-width: 750px;
}
.travel-cover span,
.travel-recent span,
.travel-plan > span {
color: #ffcf70;
font: 10px var(--mono);
letter-spacing: 0.14em;
}
.travel-cover h1 {
margin: 20px 0;
font: 500 clamp(68px, 9vw, 120px)/0.84 Georgia;
letter-spacing: -0.06em;
}
.travel-cover p {
font-size: 19px;
}
.travel-cover a {
color: inherit;
border-bottom: 1px solid;
}
.travel-cover aside {
display: flex;
flex-direction: column;
padding: 22px;
border: 1px solid #ffffff66;
font: 10px var(--mono);
}
.tpl-travel main > section:not(.travel-cover) {
width: min(1200px, calc(100% - 40px));
margin: auto;
}
.travel-recent {
padding: 100px 0;
}
.travel-recent > header {
display: flex;
justify-content: space-between;
align-items: end;
}
.travel-recent h2 {
margin: 12px 0;
font: 500 54px Georgia;
}
.travel-recent > div {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 30px;
margin-top: 35px;
}
.travel-image {
height: 390px;
padding: 20px;
background-size: cover;
}
.travel-image-1 {
background-image: url("https://images.unsplash.com/photo-1489493585363-d69421e0edd3?auto=format&fit=crop&w=900&q=80");
}
.travel-image-2 {
background-image: url("https://images.unsplash.com/photo-1528360983277-13d401cdc186?auto=format&fit=crop&w=900&q=80");
}
.travel-recent h3 {
font: 30px Georgia;
}
.travel-plan {
display: grid;
grid-template-columns: 0.6fr 1fr 1fr;
gap: 30px;
padding: 45px 0;
border-top: 1px solid #ffffff55;
}
.travel-plan h2 {
font: 38px Georgia;
}
.travel-plan li {
display: grid;
grid-template-columns: 70px 1fr;
padding: 12px 0;
border-bottom: 1px solid #ffffff33;
}
@media (max-width: 800px) {
.travel-cover {
min-height: 680px;
}
.travel-cover aside {
display: none;
}
.travel-recent > div {
grid-template-columns: 1fr;
}
.travel-plan {
grid-template-columns: 1fr;
}
}
@media (max-width: 480px) {
.tpl-travel > header nav {
display: none;
}
.travel-cover {
padding-inline: 20px;
}
}