Built on Astro, with content written using TypeScript and MDX
AstroBlog
Astro-star — Astro Blog Template
By hanlife02
Astro-star is an open-source personal site theme built on Astro that brings a blog, notes, projects, comments and friend links together into a single site, under the MIT license.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Author preview
Author-provided previewTop of page
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.
Content organized into collections such as blog, note, project and page
Integrates Waline comments and Algolia search
Provides top-level routes including home, about, blog, notes, projects and friend links
Styles centralized in src/style, including global styles, component styles and design tokens
MIT license, permitting free use, modification, commercial use and distribution
Template Details
Astro-star is an Astro theme for personal sites, aiming to bring a blog, notes, projects, comments and friend links together into one site. The repository README lists top-level routes including home, about, blog, notes, projects and friend links. Content is organized under src/content into collections such as blog, note, project and page, while site configuration, social links, friend links and search configuration are placed in src/config. Styles are centralized in src/style, including global styles, component styles and design tokens.
On the technical side, the README states that it uses Astro, TypeScript and MDX, and integrates Waline comments and Algolia search. Package management uses pnpm, and the Node.js version requirement is >= 22. The repository also provides a scripts directory for configuration migration, index synchronization and build assistance.
Usage limitations: the README does not provide detailed installation and deployment steps, instead linking to an introduction page on the author's site. The licensing of third-party assets such as demo images, fonts and icons must be checked separately and cannot be judged solely from the MIT license of the code.
AstroBlog
Is it right for your project?
Use Cases
- Building a personal site that includes a blog, notes and project showcases
- A static blog that needs comment and search functionality
- Developers who want to manage content with Astro and MDX
- Astro projects looking to reference a layered configuration and style structure
Suitable For
- Personal blog authors using Astro
- Site maintainers who need to aggregate a blog, notes, projects and friend links
- Front-end developers who accept a pnpm and Node.js >= 22 environment
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
The README does not give complete installation steps; deployment instructions link to an introduction page on the author's site
- 2
Package management uses pnpm, and the Node.js version requirement is >= 22
- 3
Before submitting a PR, it is recommended to run pnpm check, pnpm format:check and pnpm build
- 4
Third-party assets such as demo images, fonts and icons must be checked against their respective licenses
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 is the code of that version and does not mean that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use and distribution of that version's code are permitted.
- 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 depends on the third-party Waline service; you must deploy or connect to a Waline backend yourself, which may involve external services and account configuration.
- Search integrates Algolia; using it requires registering an Algolia account and obtaining an API key, which is an external service dependency.
- The README does not provide complete installation and deployment steps; you need to visit the author's site page for instructions.
- The runtime environment requires Node.js version >= 22; lower-version environments cannot use it directly.
- Package management uses pnpm 10.30.x, so the corresponding toolchain must be installed.
- Demo images, fonts, icons and other third-party assets must be checked against their respective licenses and cannot be judged solely from the MIT license of the code.
- 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
[](https://waline.js.org)
Original README
[](https://www.algolia.com)
Original README
See [Introduction and Deployment of Astro-star](https://hanlife02.com/project/astro-star/).
Original README
[](https://nodejs.org)
Original README
https://github.com/hanlife02/Astro-star/blob/main/LICENSEhttps://github.com/hanlife02/Astro-star/blob/main/README.md[](https://pnpm.io)
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-03. 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
- Partly documented · 67 / 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
- 2026-09-20
- Screenshot last checked
- 2026-10-03
No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.
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.
Review declaration: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: 8e3300530d2d18cbc7cc9afb375c59ec976adfec148162fb52d90290af70dd76
2026-10-03T10:16:08.687Z
Source file / repository<div align="center"> <img src="figures/Astro-star.png" alt="Astro-star" width="128" /> # Astro-star **An open-source Astro theme that brings blogs, notes, projects, comments, and friend links into one personal site.** [](https://astro.build) [](https://nodejs.org) [](https://pnpm.io) [](./LICENSE) [](./CONTRIBUTING.md) English · [简体中文](./README-zh-CN.md) <a href="./CONTRIBUTING.md">🤝 Contributing</a> · <a href="https://github.com/hanlife02/Astro-star/issues">🐛 Issues</a> · <a href="https://hanlife02.com/project/astro-star">📖 Docs</a> </div> --- ## Table of Contents - [Astro-star](#astro-star) - [Table of Contents](#table-of-contents) - [Project Map](#project-map) - [Introduction and Deployment](#introduction-and-deployment) - [Build Together](#build-together) - [Tech Stack](#tech-stack) - [Sites Using This Theme](#sites-using-this-theme) - [Discussion and Exchange](#discussion-and-exchange) - [License](#license) - [Star History](#star-history) ## Project Map ```text / ├── public/ # Static assets, avatars, site icon, article images ├── scripts/ # Config migration, index sync, and build helpers ├── src/ │ ├── components/ # Reusable components │ ├── config/ # Site, social links, friend links, and search config │ ├── content/ # blog / note / project / page content collections │ ├── layouts/ # Page layouts │ ├── pages/ # Routes and API endpoints │ ├── scripts/ # Browser-side interaction scripts │ ├── style/ # Global styles, component styles, design tokens │ └── utils/ # Markdown, MDX, and shared utilities ├── astro.config.mjs ├── ecosystem.config.cjs └── package.json ``` Top-level routes: | Path | Description | | ---------- | ------------ | | `/` | Home | | `/about` | About | | `/blog` | Blog | | `/note` | Notes | | `/project` | Projects | | `/links` | Friend links | ## Introduction and Deployment See [Introduction and Deployment of Astro-star](https://hanlife02.com/project/astro-star/). ## Build Together Small contributions are welcome. A clear Issue, a mobile screenshot, a reproducible bug, a more ergonomic component, or a short setup note can all make this theme easier to maintain and reuse. Before opening a PR, it is recommended to run: ```bash pnpm check pnpm format:check pnpm build ``` See [CONTRIBUTING.md](./CONTRIBUTING.md) for the core rules. The most important ones are: do not hard-code business content in components, keep styles in `src/style/`, build mobile-first, and never commit secrets. ## Tech Stack <div align="center"> [](https://astro.build) [](https://www.typescriptlang.org) [](https://mdxjs.com) [](https://waline.js.org) [](https://www.algolia.com) </div> ## Sites Using This Theme Welcome to use this theme for your personal site! Submit a PR to add your site to the list. | Avatar | Site | Description | | --------------------------------------------------------- | ------------------------------ | ------------------------------ | | <img src="https://github.com/hanlife02.png" width="50" /> | [Ethan](https://hanlife02.com) | Don't stay awake for too long. | ## Discussion and Exchange Welcome to participate in discussions, feedback issues, and feature suggestions in the [LINUX DO](https://linux.do) community. ## License Astro-star is open-source under the [MIT License](./LICENSE). ## Star History <a href="https://www.star-history.com/?repos=hanlife02%2FAstro-star&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=hanlife02/Astro-star&type=date&theme=dark&legend=top-left&sealed_token=SUzwHN5ZdCscIYlMbiRmw-j7ttKNlySwP5lTx0DRCE2cuY8mqab0dfXSD1kB0SzYvpNKvi83I8ogVp-jGSuX3VYtGFuf55k0vfIOyw2LU1JAYkkGGneifgvI_Egn2A-qH96gWrbfFlczWOcpRE8r2Cgqfc1cR75IISNQZbodN6x4P42-x6sdlRn5lcya" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=hanlife02/Astro-star&type=date&legend=top-left&sealed_token=SUzwHN5ZdCscIYlMbiRmw-j7ttKNlySwP5lTx0DRCE2cuY8mqab0dfXSD1kB0SzYvpNKvi83I8ogVp-jGSuX3VYtGFuf55k0vfIOyw2LU1JAYkkGGneifgvI_Egn2A-qH96gWrbfFlczWOcpRE8r2Cgqfc1cR75IISNQZbodN6x4P42-x6sdlRn5lcya" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=hanlife02/Astro-star&type=date&legend=top-left&sealed_token=SUzwHN5ZdCscIYlMbiRmw-j7ttKNlySwP5lTx0DRCE2cuY8mqab0dfXSD1kB0SzYvpNKvi83I8ogVp-jGSuX3VYtGFuf55k0vfIOyw2LU1JAYkkGGneifgvI_Egn2A-qH96gWrbfFlczWOcpRE8r2Cgqfc1cR75IISNQZbodN6x4P42-x6sdlRn5lcya" /> </picture> </a> --- <div align="center"> If you find this project helpful, consider giving it a ⭐ to show your support! </div>
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