AstroBlog

astro-air-bento — Astro Blog Template

By deventw

Astro Air Bento is a minimalist personal blog theme built on Astro, supporting dark mode, responsive layout, Markdown/MDX writing, bilingual English/Chinese, and RSS subscription.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

1 previews
Author preview
Author-provided preview

Preview provided in the project README.

One original preview is available. Open the full image to inspect the design.

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

Write posts using Markdown or MDX, with frontmatter supporting title, description, publication date, optional update date, tags, and cover image

02

Built-in dark mode and device-responsive layout

03

Provides bilingual English/Chinese (EN/ZH) interface and content configuration

04

Supports RSS subscription and sitemap, using SSG static rendering

05

Integrates social media links, Google Analytics, and Twikoo comments

06

MIT license, allowing free use, modification, commercial use, and distribution

Template Details

Astro Air Bento is a minimalist personal blog theme for Astro, inspired by Astro Air. It uses Markdown or MDX to write posts, outputs pages via SSG static rendering, and includes built-in RSS subscription and sitemap. The theme provides dark mode, device-responsive layout, bilingual English/Chinese (EN/ZH) interface, social media links, Google Analytics, and Twikoo comment integration.

Configuration is required before use: site information in src/config/index.ts, site links in src/config/links.ts, and content for the about and intro pages in src/config/zh(en)/about.mdx, intro.mdx, links.mdx. Posts go in the src/content/posts/ directory, with frontmatter supporting title, description, pubDate, and optional updatedDate, tags, ogImage.

The repository README still shows local search and transition animations as unchecked, indicating these capabilities are not yet included in the current version. The theme is released under the MIT license, allowing free use, modification, commercial use, and distribution, but third-party assets such as demo images, fonts, and icons require separate license verification; external services like domain, hosting, and comments may incur costs.

AstroBlog

Is it right for your project?

Use Cases

  • Building a text-focused personal blog and managing posts with Markdown/MDX
  • Personal sites that need bilingual English/Chinese display
  • Static blogs that want RSS subscription and sitemap
  • Sites that prefer a minimalist visual style and need dark mode

Suitable For

  • Individual developers familiar with Astro or willing to adjust the site via configuration files
  • Personal bloggers focused on writing articles who do not need a complex backend
  • Content sites that need bilingual English/Chinese and RSS output
  • Users who accept configuring external services such as comments and analytics themselves

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Configure site settings in src/config/index.ts and site links in src/config/links.ts

  2. 2

    Modify the corresponding page content in src/config/zh(en)/about.mdx, intro.mdx, links.mdx

  3. 3

    Create posts in the src/content/posts/ directory, following the frontmatter template provided in the README

  4. 4

    Comments use Twikoo and analytics use Google Analytics; you need to prepare the corresponding services yourself

  5. 5

    For local development, use bun install and bun dev as per the README; to update the theme, add the upstream repository and merge upstream/main

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope applies to this version's code and does not imply that external services or third-party assets are free.

Must comply with when using

  • Allows free use, modification, commercial use, and distribution of this version's code.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and liability limitations are governed by the original license and applicable law.

Additional costs & items to verify

  • The comment feature relies on the external Twikoo service; you need to deploy or connect to a Twikoo backend yourself, which may incur additional service and costs.
  • Site analytics uses Google Analytics; you need to register an account and configure a tracking ID yourself, which is an external service.
  • One-click deployment relies on third-party hosting platforms such as Vercel; domain and hosting may incur costs.
  • Demo images, fonts, icons, and other third-party assets require verification under their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domain, hosting, database, payment, or AI may incur additional charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

Commenting Integration (Twikoo)

Original README

Google analysis integration

Original README

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/deventw/astro-air-bento)

Original README
https://github.com/deventw/astro-air-bento/blob/main/LICENSEhttps://github.com/deventw/astro-air-bento/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 87 / 100
Technologies
Astro
Website type
Blog
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2025-10-27
Screenshot last checked
2026-10-02

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: aca12b1fd8b2e9875c981039397cecd0eb51711cb543a1cea1373a31065bb52a

2026-10-02T09:48:38.197Z

Source file / repository
# Astro Air Bento

[Astro Theme Details](https://astro.build/themes/details/astro-air-bento/)

A minimalism, personal blog theme for Astro, which inspired by [Astro Air](https://astro-air.guoqi.dev).

> If you find this project helpful, please consider giving it a star ⭐️

[![Built with Astro](https://astro.badg.es/v1/built-with-astro/tiny.svg)](https://astro.build)
[![Netlify Status](https://api.netlify.com/api/v1/badges/a4eb6e88-606d-4ea6-9a53-179e03a7e2ef/deploy-status)](https://app.netlify.com/sites/astro-air-bento/deploys)

<img style="border-radius: 10px;" src="https://cdn.jsdelivr.net/gh/deventw/astro-air-bento@master/public/preview.png" alt="Astro Air Bento">

## Showcase

- [Astro Air Bento](https://astro-air-bento.netlify.app)
- [Astro Air](https://astro-air.guoqi.dev)
- [Guoqi's blog](https://blog.sunguoqi.com)
- ...

> Welcome to add your own blog to the list by creating 🅿🆁

## Features

- [x] 🌓 Dark mode support
- [x] 📱 Fully device responsive
- [x] 🎨 Clean and minimalist design
- [x] 📝 Markdown/MDX for content authoring
- [x] 🏄‍♂️ SSG static rendering, SEO friendly
- [x] 🌐 i18n support (EN/ZH)
- [x] 🔗 Social media integration
- [x] 📰 RSS feed & sitemap support
- [x] 🛠️ Google analysis integration
- [x] 💬 Commenting Integration (Twikoo)
  <!-- - [ ] 🔍 Local search functionality -->
  <!-- - [ ] 🎨 Enhance Transition and Animation -->
  <!-- - [ ] ...and more -->

## Quick Start

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/deventw/astro-air-bento)

[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/deventw/astro-air-bento)

## Configuration

- Open `src/config/index.ts` and customize your site settings

- Open `src/config/links.ts` and customize your site links

- Open `src/config/zh(en)/about.mdx(intro.mdx、links.mdx)` and customize your pages content

## Writing Content

1. Create new blog posts in the `src/content/posts/` directory
2. Use the following frontmatter template:

```markdown
---
title: "Your Post Title"
description: "A brief description of your post"
pubDate: YYYY-MM-DD
updatedDate(optional): YYYY-MM-DD
tags(optional): ["tag1", "tag2"]
ogImage(optional): "cover image URL"
---

Your content here...
```

## Update Theme

```bash
git remote add upstream https://github.com/deventw/astro-air-bento

git fetch upstream

git merge upstream/main --allow-unrelated-histories

```

## Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create your feature branch
3. Submit a pull request

```bash
git clone https://github.com/deventw/astro-air-bento

cd astro-air-bento

bun install

bun dev
```

## License

This project is licensed under the MIT License - see the LICENSE file for details.
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.