v0.17.5 BLOG EXAMPLE / ISSUES / SUBSCRIBE

Newsletter
blog.

Issue-based publishing with an email-first rhythm. Preview the finished page, then inspect the exact source compiled by the current Kudzu release.

01

LIVE OUTPUT

Preview

Open full page ↗
kudzu.local/example/blog/newsletter/demo
02

PROJECT SOURCE

Build it yourself

src/components/examples/BlogTemplates.tsx · NewsletterTSX
function Newsletter({ blog }: { blog: BlogExample }) {
  return (
    <div className="tpl tpl-newsletter">
      <header>
        <a href="#home">GOOD MONDAY</a>
        <span>ONE THOUGHTFUL EMAIL, EVERY MONDAY</span>
        <a href="/example">ARCHIVE ↗</a>
      </header>
      <main>
        <section className="letter-signup">
          <span>JOIN 12,840 CURIOUS PEOPLE</span>
          <h1>
            Start the week with
            <br />a better question.
          </h1>
          <p>
            A short letter about creative work, useful habits, and ideas worth
            carrying into Monday.
          </p>
          <form>
            <input
              type="email"
              placeholder="you@example.com"
              aria-label="Email address"
            />
            <button type="submit">Subscribe free</button>
          </form>
          <small>No growth hacks. Leave whenever you like.</small>
        </section>
        <section className="letter-current">
          <header>
            <span>ISSUE 048 · JULY 20, 2026</span>
            <strong>6 MIN READ</strong>
          </header>
          <h2>
            <a href={`/example/blog/${blog.slug}/demo/${blog.posts[0].slug}`}>
              The useful kind of quiet
            </a>
          </h2>
          <p>
            Silence is not the absence of work. Sometimes it lets the right work
            become visible.
          </p>
          <blockquote>
            Make enough room for the thought you did not schedule.
          </blockquote>
          <a href={`/example/blog/${blog.slug}/demo/${blog.posts[0].slug}`}>
            Read issue 048 →
          </a>
        </section>
        <section className="letter-archive">
          <h2>Previous issues</h2>
          {blog.posts.slice(1).map((post, index) => (
            <article>
              <span>ISSUE 0{47 - index}</span>
              <h3>
                <a href={`/example/blog/${blog.slug}/demo/${post.slug}`}>
                  {post.title}
                </a>
              </h3>
              <a href={`/example/blog/${blog.slug}/demo/${post.slug}`}>
                Read →
              </a>
            </article>
          ))}
        </section>
      </main>
    </div>
  );
}
src/components/examples/BlogArticles.tsx · shared articleTSX
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 "newsletter":
src/components/examples/BlogExamples.tsx · newsletterTSX
slug: "newsletter",
src/pages/example/blog/[slug]/demo.tsxTSX
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 })];
}
src/pages/example/blog/[slug]/demo/[post].tsxTSX
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 })];
}
examples/styles/base.cssCSS
.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;
  }
}
examples/styles/newsletter.cssCSS
.tpl-newsletter {
  color: #34261f;
  background: #f7ead5;
  font-family: Georgia;
}
.tpl-newsletter > header {
  display: grid;
  grid-template-columns: 1fr auto 1fr;
  align-items: center;
  min-height: 80px;
  padding: 0 4vw;
  border-bottom: 1px solid #a98b74;
}
.tpl-newsletter > header > a:first-child {
  color: #e14e34;
  font: 800 23px Arial;
}
.tpl-newsletter > header > span {
  font: 9px var(--mono);
}
.tpl-newsletter > header > a:last-child {
  justify-self: end;
  font: 9px var(--mono);
}
.tpl-newsletter > main {
  width: min(1050px, calc(100% - 40px));
  margin: auto;
}
.article-newsletter {
  color: #34261f;
  background: #f7ead5;
}
.article-newsletter .article-hero {
  background: linear-gradient(145deg, #fff 55%, #e14e34 55%);
}
.article-newsletter .article-content > aside {
  background: white;
  box-shadow: 8px 8px 0 #e14e34;
}
.letter-signup {
  padding: 100px 70px;
  margin: 60px 0;
  background: white;
  box-shadow: 14px 14px 0 #e14e34;
  text-align: center;
}
.letter-signup > span {
  color: #e14e34;
  font: 9px var(--mono);
}
.letter-signup h1 {
  margin: 25px 0;
  font: 600 clamp(58px, 8vw, 100px)/0.88 Georgia;
  letter-spacing: -0.065em;
}
.letter-signup p {
  max-width: 620px !important;
  margin: 0 auto 30px;
  font-size: 18px;
  line-height: 1.6;
}
.letter-signup form {
  display: flex;
  max-width: 570px;
  margin: auto;
}
.letter-signup input {
  flex: 1;
  min-width: 0;
  padding: 15px;
  border: 1px solid #a98b74;
}
.letter-signup button {
  padding: 15px 20px;
  color: white;
  border: 0;
  background: #e14e34;
}
.letter-signup small {
  display: block;
  margin-top: 15px;
  color: #8e7665;
}
.letter-current {
  padding: 80px 0;
  border-bottom: 1px solid #a98b74;
}
.letter-current > header {
  display: flex;
  justify-content: space-between;
  font: 9px var(--mono);
}
.letter-current h2 {
  margin: 40px 0 20px;
  font: 600 64px Georgia;
}
.letter-current > p {
  max-width: 650px;
  font-size: 20px;
  line-height: 1.8;
}
.letter-current blockquote {
  margin: 45px 0;
  padding-left: 30px;
  border-left: 3px solid #e14e34;
  font: italic 30px Georgia;
}
.letter-current a {
  color: #e14e34;
}
.letter-archive {
  padding: 70px 0 100px;
}
.letter-archive > article {
  display: grid;
  grid-template-columns: 130px 1fr auto;
  align-items: center;
  padding: 25px 0;
  border-top: 1px solid #a98b74;
}
.letter-archive article span {
  font: 9px var(--mono);
}
.letter-archive h3 {
  font-size: 26px;
}

@media (max-width: 800px) {
  .letter-signup {
    padding: 60px 25px;
  }
  .letter-archive > article {
    grid-template-columns: 100px 1fr;
  }
  .letter-archive article a {
    grid-column: 2;
  }
}

@media (max-width: 480px) {
  .tpl-newsletter > header > span {
    display: none;
  }
  .letter-signup form {
    flex-direction: column;
  }
}