Astro Minimal Starter

Astro Minimal Starter is a minimal, SEO-ready blog starter built on the Astro static site generator that compiles Markdown posts into a deployable static website.

What is Astro Minimal Starter?

Astro Minimal Starter is a bare-bones blog boilerplate for Astro that turns Markdown files into a static blog site. It accepts Markdown posts placed in src/pages/blog/ and a site configuration at src/data/site.js, and outputs a fully structured blog with an RSS feed, XML sitemap, robots.txt, Open Graph tags, and JSON-LD schema. The project is hosted on GitHub under jaydanurwin/astro-minimal-starter and includes a Netlify deployment badge, showing it deploys cleanly to Netlify. Because styles are intentionally minimal, the starter makes no design assumptions, letting you bring your own CSS framework.

Key Features

• SEO built in — Ships with Open Graph tags for Twitter and Facebook, user-declared canonical URLs, an RSS feed, an XML sitemap, a robots.txt file, and JSON-LD schema.
• Markdown blog engine — Write posts in Markdown with featured images; the starter compiles them into blog pages with proper structure.
• Minimal styles — Comes with almost no CSS, so you can drop in vanilla CSS, Tailwind, Sass, or any other approach without dismantling a theme.
• Performant Google Fonts setup — Includes an optimized pattern for loading Google Fonts, avoiding render-blocking requests.
• Rapid workflow — Install with npm i, run locally with npm start, and build for production with npm run build.
• Customizable site config — Edit src/data/site.js to update your site's name, description, and other metadata in one place.

Who is it for?

• Personal bloggers who want an SEO-friendly blog without wrestling with a heavy theme.
• Developers learning Astro who want a small, readable codebase to understand how Astro pages, layouts, and Markdown collections work.
• Frontend developers who prefer their own styling who need a basic structure and don't want to untangle a starter that forces Tailwind, SCSS, or other tools on them.

Use Cases

• Blogging with Markdown: Create a new post by dropping a Markdown file into src/pages/blog/; it automatically becomes part of the blog with SEO tags, RSS, and sitemap integration.
• Learning Astro: Use this starter as a reference for how Astro handles page routes, Markdown content, and headless SEO tags.
• Rapid prototyping: Spin up a personal site quickly by editing site config and writing a couple of posts, then deploy to Netlify.

How does it work?

Clone the repo, run npm i to install dependencies, then npm start to preview locally. Edit src/data/site.js to set your site metadata, and add Markdown posts in src/pages/blog/. When ready, run npm run build to generate the static output.