Repolode
Submit
satnaing

satnaing/astro-paper

A minimal, accessible, SEO-friendly blog theme built on Astro with TypeScript, Tailwind CSS and Pagefind search.

Open-source alternative to:MediumGhost

View on GitHubWebsite
Stars
5,137
Forks
1,118
Open issues
32
Last commit
21 hours ago

What is it?

AstroPaper is a blog theme for the Astro static site generator. It gives you a ready-made layout for writing posts in Markdown or MDX, with type-safe content, draft posts, pagination, a collapsible table of contents and light and dark modes.

The theme includes a sitemap, an RSS feed, SEO metadata, and dynamically generated Open Graph images for each post. Search runs statically through Pagefind, so no backend or external search service is needed. Styling uses Tailwind CSS, and the project is written in TypeScript.

Configuration is centralized in an astro-paper.config.ts file, and the theme is set up to be customized for colors and site settings. It is deployable to static hosts such as Cloudflare Pages.

Key features

  • 01Markdown and MDX support with type-safe content
  • 02Static search powered by Pagefind
  • 03Light and dark mode with predefined color schemes
  • 04Sitemap, RSS feed and SEO metadata
  • 05Dynamic Open Graph image generation for posts
  • 06Keyboard and screen-reader accessible design

Use cases

  • Launching a personal or technical blog on a static host
  • Publishing a writing site with draft posts and pagination
  • Starting a Markdown-based blog that needs search without a backend

Quick start

  1. 1

    Create a new project from the template with pnpm

    pnpm create astro@latest --template satnaing/astro-paper
  2. 2

    Install dependencies

    pnpm install
  3. 3

    Start the local dev server

    pnpm dev

Things to know

  • Built on Astro, so you need Node.js and the pnpm toolchain set up locally.

Topics

#astro#blog#theme#static-site-generator#tailwindcss#typescript#accessibility#seo#a11y#astro-theme

FAQ

What is astro-paper?
A minimal, accessible, SEO-friendly blog theme built on Astro with TypeScript, Tailwind CSS and Pagefind search. AstroPaper is a blog theme for the Astro static site generator. It gives you a ready-made layout for writing posts in Markdown or MDX, with type-safe content, draft posts, pagination, a collapsible table of contents and light and dark modes.
Is astro-paper free to use? What license does it have?
astro-paper is open source under the MIT license. Check the license terms before using it in commercial products.
Is astro-paper still maintained?
Actively maintained. The last commit to astro-paper was on Oct 21, 2026.
What can I use astro-paper for?
Launching a personal or technical blog on a static host Publishing a writing site with draft posts and pagination Starting a Markdown-based blog that needs search without a backend
How do I install astro-paper?
Create a new project from the template with pnpm: pnpm create astro@latest --template satnaing/astro-paper Install dependencies: pnpm install Start the local dev server: pnpm dev
Where can I get astro-paper?
The source code and installation instructions are on GitHub: https://github.com/satnaing/astro-paper

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects