Write posts using Markdown or MDX, with frontmatter supporting title, description, publication date, optional update date, tags, and cover image
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.
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.
What stands out
A quick read of the recorded project description.
Built-in dark mode and device-responsive layout
Provides bilingual English/Chinese (EN/ZH) interface and content configuration
Supports RSS subscription and sitemap, using SSG static rendering
Integrates social media links, Google Analytics, and Twikoo comments
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.
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
Configure site settings in src/config/index.ts and site links in src/config/links.ts
- 2
Modify the corresponding page content in src/config/zh(en)/about.mdx, intro.mdx, links.mdx
- 3
Create posts in the src/content/posts/ directory, following the frontmatter template provided in the README
- 4
Comments use Twikoo and analytics use Google Analytics; you need to prepare the corresponding services yourself
- 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
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis 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
https://github.com/deventw/astro-air-bento/blob/main/LICENSEhttps://github.com/deventw/astro-air-bento/blob/main/README.md[](https://vercel.com/new/clone?repository-url=https://github.com/deventw/astro-air-bento)
Original README
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 ⭐️ [](https://astro.build) [](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 [](https://vercel.com/new/clone?repository-url=https://github.com/deventw/astro-air-bento) [](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.
Explore similar templates
Compare previews and descriptions within the same stack and category.

astrowind
AstroWind is a free, open-source Astro starter theme using Astro and Tailwind CSS, released under the MIT license.
Astro · Blog

astro-paper
AstroPaper is a minimal, responsive, accessible, and SEO-friendly Astro blog theme. Articles are stored as Markdown/MDX in src/content/posts/, with subdirectories affecting URLs.
Astro · Blog

fuwari
Fuwari is a static blog template built with Astro and Tailwind CSS for personal blogs. It manages posts as Markdown files in src/content/posts/, with frontmatter for title, date, description, cover, tags, categories, draft status, and language.
Astro · Blog

Firefly
Firefly is a clean personal blog theme forked from Astro and Fuwari, offering four background modes, single/double sidebar and list/grid layouts, Pagefind client-side full-text search, and a six-language UI.
Astro · Blog

astro-theme-cactus
Astro Cactus is an Astro-based blog and portfolio theme that uses Markdown/MDX content collections to manage posts, notes, and tags, with frontmatter type-checked by a schema.
Astro · Portfolio

astrofy
Astrofy is a free and open-source personal portfolio website template built with Astro and TailwindCSS, with built-in blog, CV timeline, project showcase, store, and RSS feed modules.
Astro · Portfolio
