Minimalist personal blog theme built on Astro, with content written in Markdown/MDX
AstroBlog
astro-air — Astro Blog Template
By sun0225SUN
Astro Air is a minimalist personal blog theme built on Astro, supporting dark mode, responsive layout, Markdown/MDX writing, and Chinese-English bilingual content.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 3
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-09-30View source
What stands out
A quick read of the recorded project description.
Supports dark mode and responsive layout, adapting to desktop and mobile
Built-in Chinese-English bilingual (i18n), with RSS feed and sitemap
Integrates Twikoo comments and Google Analytics, with configurable social links
Site configuration, links, and about/intro/friends links page content are managed in separate files for easy replacement
README provides Vercel and Netlify deployment entries and git steps to sync upstream updates
Template Details
Astro Air is a personal blog theme released by author sun0225SUN, built with Astro and positioned as minimalist. Content is written in Markdown/MDX, with articles placed in the src/content/posts/ directory, and frontmatter defining title, description, publication date, optional update date, tags, and cover image. Site configuration is centralized in src/config/index.ts and src/config/links.ts, while the about page, intro page, and friends links page content are provided by about.mdx, intro.mdx, and links.mdx under src/config/zh(en)/ respectively. The theme includes built-in dark mode, responsive layout, Chinese-English bilingual (i18n), RSS and sitemap, social links, Google Analytics, and Twikoo-based comment integration, with transition and animation effects. Local search is still marked as incomplete in the README, so this feature should not be considered available. The project uses SSG static rendering; the README provides deployment buttons for Vercel and Netlify, and gives steps to sync theme updates by adding an upstream remote via git remote, then fetching and merging. The code 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, and external services like domains and hosting may incur additional charges.
AstroBlog
Is it right for your project?
Use Cases
- Building a personal tech blog or writing site
- Content sites requiring Chinese-English bilingual and RSS output
- Blogs that want to manage articles with Markdown/MDX and deploy statically
- Personal projects that want to start quickly with an existing theme and adjust configuration as needed
Suitable For
- Personal bloggers using Astro who prefer minimalist typography
- Authors who write in Markdown/MDX and accept a static generation workflow
- Independent blogs needing Chinese-English bilingual, RSS, and comment features
- Users planning to deploy to static hosting platforms like Vercel or Netlify
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
After cloning the repository, enter the directory, install dependencies with pnpm install, and start local development with pnpm dev
- 2
Modify site settings in src/config/index.ts and site links in src/config/links.ts
- 3
Edit about.mdx, intro.mdx, and links.mdx under src/config/zh(en)/ to customize the corresponding page content
- 4
Place new articles in src/content/posts/, filling in title, description, date, tags, and cover image according to the frontmatter fields given in the README
- 5
To sync theme updates, add the upstream remote and run git fetch upstream and git merge upstream/main --allow-unrelated-histories
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 the code of this version and does not imply that external services or third-party assets are free.
Must comply with when using
- The code of this version may be used, modified, used commercially, and distributed for free.
- 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 limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- The comment feature relies on the third-party Twikoo service; you must deploy or configure a Twikoo backend yourself, which may incur additional service and costs.
- The Google Analytics integration requires you to apply for a Google Analytics account and configure a tracking ID, which is an external service.
- Deploying to Vercel requires registering a Vercel account; the hosting service may charge based on usage.
- Deploying to Netlify requires registering a Netlify account; the hosting service may charge based on usage.
- The local search feature is marked as incomplete in the README and should not be considered available.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; they cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, 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
Original README
Deploy to Netlify
Original README
https://github.com/sun0225SUN/astro-air/blob/main/LICENSEhttps://github.com/sun0225SUN/astro-air/blob/main/README.mdLocal search functionality
Original README
Compiled by DeepSeek based on repository license and README ·2026-09-30. 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-09-30
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: 45916c685114850cb59ee571c9d464a6443e7eda5db0ada09145c40927a48025
2026-09-30T08:54:30.226Z
Source file / repository# Astro Air A minimalism, personal blog theme for Astro. > If you find this project helpful, please consider giving it a star ⭐️ [](https://astro.build) [](https://app.netlify.com/sites/astro-air/deploys) <img style="border-radius: 10px;" src="https://cdn.jsdelivr.net/gh/sun0225SUN/astro-air/public/preview.png" alt="Astro Air"> ## Showcase - [Astro Air](https://astro-air.guoqi.dev) - [Guoqi's blog](https://blog.sunguoqi.com) - ... > welcome to add your own blog to the list ❤️ ## 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) - [x] 🎨 Enhance Transition and Animation - [ ] 🔍 Local search functionality - [ ] ...and more ## Quick Start [](https://vercel.com/new/clone?repository-url=https://github.com/sun0225SUN/astro-air) [](https://app.netlify.com/start/deploy?repository=https://github.com/sun0225SUN/astro-air) ## 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/sun0225SUN/astro-air 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/sun0225SUN/astro-air cd astro-air pnpm install pnpm 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