astro-bolt — Astro Blog Template

SHA-256: f71d47b7d82045080f8df69866aec778072554c474decf532593ea36bc6d1d7d

2026-10-13T00:31:17.010Z

# Astro Bolt 📄

<!--
Take screenshot on https://www.site-shot.com/
Options:
Width: 1280
Height: 820
Zoom: 125
Format: PNG
-->

<p align="center">
  <a href="https://astro-bolt.netlify.app/">
    <img width="1280" height="820" alt="Astro Bolt" src="https://github.com/user-attachments/assets/e31b8de7-3ec5-4967-9db3-68b015feff76" />
  </a>
</p>

<div align="center">

[![Astro Bolt live preview](https://img.shields.io/badge/Preview-astro--bolt.netlify.app-FF5A1F?style=for-the-badge&logo=astro&logoColor=white)](https://astro-bolt.netlify.app/)
![Typescript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)
![GitHub](https://img.shields.io/github/license/dantehemerson/astro-bolt?color=%232F3742&style=for-the-badge)

</div>

Astro Bolt is a minimal, responsive, accessible and SEO-friendly Astro blog theme.

Read [the blog posts](https://astro-bolt.netlify.app/posts/) or check [the README Documentation Section](#-documentation) for more info.

## 🔥 Features

- [x] type-safe markdown
- [x] super fast performance
- [x] accessible (Keyboard/VoiceOver)
- [x] responsive (mobile ~ desktops)
- [x] SEO-friendly
- [x] light & dark mode
- [x] static search ([Pagefind](https://pagefind.app/))
- [x] draft posts & pagination
- [x] sitemap & rss feed
- [x] MDX support
- [x] collapsible table of contents
- [x] followed best practices
- [x] highly customizable
- [x] dynamic OG image generation for blog posts
- [x] i18n ready

_Note: Screen-reader accessibility of Astro Bolt is tested using **VoiceOver** on Mac and **TalkBack** on Android. I couldn't test all other screen-readers out there. However, accessibility enhancements in Astro Bolt should be working fine on others as well._

<!--## ✅ Lighthouse Score

<p align="center">
  <a href="https://pagespeed.web.dev/report?url=https%3A%2F%2Fastro-bolt.netlify.app%2F&form_factor=desktop">
    <img width="710" alt="Astro Bolt Lighthouse Score" src="AstroPaper-lighthouse-score.svg">
  </a>
</p>-->

## 🚀 Project Structure

Inside of Astro Bolt, you'll see the following folders and files:

```bash
/
├── public/
│   ├── pagefind/          # auto-generated on build
│   ├── favicon.svg
│   └── default-og.jpg
├── src/
│   ├── assets/
│   │   ├── icons/
│   │   └── images/
│   ├── components/
│   ├── content/
│   │   ├── pages/
│   │   │   └── about.md
│   │   └── posts/
│   │       └── some-blog-posts.md
│   ├── i18n/
│   ├── layouts/
│   ├── pages/
│   ├── scripts/
│   ├── styles/
│   ├── types/
│   ├── utils/
│   ├── config.ts
│   └── content.config.ts
├── astro-template.config.ts  # user-defined configurations
└── astro.config.ts
```

All blog posts are stored in the `src/content/posts/` directory. You can organise posts into subdirectories — the subdirectory name becomes part of the post URL.

## 📖 Documentation

Documentation can be read in two formats\_ _markdown_ & _blog post_.

- Configuration - [markdown](src/content/posts/how-to-configure-astropaper-theme.md) | [blog post](https://astro-paper.pages.dev/posts/how-to-configure-astropaper-theme/)
- Add Posts - [markdown](src/content/posts/adding-new-post.md) | [blog post](https://astro-paper.pages.dev/posts/adding-new-posts-in-astropaper-theme/)
- Customize Color Schemes - [markdown](src/content/posts/customizing-astropaper-theme-color-schemes.md) | [blog post](https://astro-paper.pages.dev/posts/customizing-astropaper-theme-color-schemes/)
- Predefined Color Schemes - [markdown](src/content/posts/predefined-color-schemes.md) | [blog post](https://astro-paper.pages.dev/posts/predefined-color-schemes/)

## 💻 Tech Stack

**Main Framework** - [Astro](https://astro.build/)  
**Type Checking** - [TypeScript](https://www.typescriptlang.org/)  
**Styling** - [TailwindCSS](https://tailwindcss.com/)  
**UI/UX** - [Figma Design File](https://www.figma.com/community/file/1356898632249991861)  
**Static Search** - [Pagefind](https://pagefind.app/)  
**Icons** - [Lucide React](https://lucide.dev/)  
**Code Formatting** - [Prettier](https://prettier.io/)  
**Deployment** - [Cloudflare Pages](https://pages.cloudflare.com/)  
**Linting** - [ESLint](https://eslint.org)  
**Dynamic OG images** - [Satori](https://github.com/vercel/satori) + [Sharp](https://sharp.pixelplumbing.com/) + [Astro Fonts](https://docs.astro.build/en/guides/fonts/)

## 👨🏻‍💻 Running Locally

Clone this repository and start the project by running the following commands:

```bash
# install dependencies
npm install

# start running the project
npm run dev
```

## Google Site Verification (optional)

You can add your [Google Site Verification HTML tag](https://support.google.com/webmasters/answer/9008080#meta_tag_verification&zippy=%2Chtml-tag) by setting `site.googleVerification` in `astro-template.config.ts`:

```ts file="astro-template.config.ts"
export default defineAstroTemplateConfig({
  site: {
    // ...
    googleVerification: "your-google-site-verification-value",
  },
  // ...
});
```

## 🧞 Commands

All commands are run from the root of the project, from a terminal:

| Command           | Action                                                                                           |
| :---------------- | :----------------------------------------------------------------------------------------------- |
| `npm install`     | Installs dependencies                                                                            |
| `npm run dev`     | Starts local dev server at `localhost:4321`                                                      |
| `npm run build`   | Type-checks, builds the site, runs Pagefind indexing, and copies the index to `public/pagefind/` |
| `npm run preview` | Preview your build locally, before deploying                                                     |
| `npm run astro`   | Run CLI commands like `astro add`, `astro check`                                                 |

## ✨ Feedback & Suggestions

If you have any suggestions/feedback, feel free to open an issue if you find bugs or want to request new features.

## 📜 License

Licensed under the MIT License, Copyright © 2026

---

Based on [AstroPaper](https://github.com/satnaing/astro-paper) by [Sat Naing](https://satnaing.dev) 👨🏻‍💻 and [contributors](https://github.com/satnaing/astro-paper/graphs/contributors).