Newsletter
Join the Community
Subscribe to our newsletter for the latest news and updates
A minimal writing focused Astro blog template
Astro Sienna is a minimal, writing-focused blog template built on Astro that generates a static site with serif typography, dark mode, RSS, and per-post OG images generated at build time.
Astro Sienna is an open-source blog template built on Astro 7. It takes Markdown and MDX posts from src/content/post/, a typed site configuration in src/site.config.ts, and content schemas from src/content.config.ts, and outputs a fully static dist/ directory ready to deploy anywhere. The template was created by Anjay Goel as a fork of astro-theme-cactus and later heavily revamped; it is released under the MIT license.
.md or .mdx) and the About page are validated with Zod schemas defined in src/content.config.ts..mdx posts.data-theme="light" and data-theme="dark" attributes on the <html> element, with design tokens set as CSS variables in src/styles/global.css.public/.$...$ and display $$...$$ math render with KaTeX.src/pages/og-image/[...slug].png.ts and can be overridden per post via the ogImage frontmatter field.src/content/post/ and it automatically appears with tag pages, a /tags/ index, and RSS updates.src/site.config.ts; leave them undefined and the scripts never load.dist/ directory; the bundled GitHub Actions workflow auto-detects a GitHub Pages project subpath, and other hosts can use BASE_PATH=/sub pnpm build.Start by clicking "Use this template" on GitHub or cloning the repository, then run pnpm install and pnpm dev for local development. Posts are written as .md or .mdx files with YAML frontmatter (title, publishDate, description, tags, and optional updatedDate, draft, coverImage, or ogImage). Running pnpm build type-checks the project, builds it, and runs Pagefind indexing for search.
.gitattributes merge=ours drivers on personal content paths; configuration is code-based, not UI-based.Astro Sienna is open source under the MIT license, so it is free to use, modify, and deploy without a license fee.
Yes. Astro Sienna is released under the MIT license, so you can use, modify, and redistribute it freely.
Add a .md or .mdx file to src/content/post/. The filename becomes the slug. Frontmatter requires title, publishDate, description, and tags; optional fields include updatedDate, draft, coverImage, and ogImage.
By default, Satori generates a 1200×630 OG image for every post at build time. To use your own image, set ogImage: "/path/to/image.png" in the post's frontmatter.
Yes. Use the bundled .github/workflows/deploy.yml and set Settings → Pages → Source to GitHub Actions. The workflow auto-detects the repository subpath for project sites; user sites work with the default root.
Edit src/site.config.ts. For Giscus comments, provide a comments configuration. For analytics, provide an analytics object with a GA4 key or Goatcounter key. If either section is undefined, the corresponding scripts are never loaded.
