Astro-based personal blog template with code released under the MIT license
AstroBlog
hydrogen-astro — Astro Blog Template
By statichunt
Hydrogen is a free Astro-based personal blog template released under the MIT license, offering common blog features such as a contact form, comments, related posts, MDX, and taxonomy pages.
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-10-03View source
What stands out
A quick read of the recorded project description.
Built-in contact form, Disqus comments, and related posts recommendations
Supports MDX and several built-in custom components
Provides taxonomy pages and Astro Image optimization
Generates llms.txt, llms-full.txt, and per-page .md documentation
Includes all SCSS files and supports custom logos
Template Details
Hydrogen is an Astro personal blog template published by statichunt, positioned as minimal and customizable, suitable for building a personal blog site. The repository is open source under the MIT license, and the demo site and screenshots can be viewed on the statichunt theme page.
In terms of features, the template includes a contact form, Google Tag Manager integration, Disqus comments, related posts recommendations, taxonomy pages, and image optimization based on Astro Image; content supports MDX and includes several built-in custom components, and it also generates LLM-oriented documentation such as llms.txt, llms-full.txt, and per-page .md files. For styling, all SCSS files are provided, custom logos are supported, and semantic HTML structure is used.
To use it, you need to install Node.js first, then run npm install to install dependencies, npm run dev to run locally, and npm run build to generate a production build. The template comes preconfigured with the Git-based headless CMS Sitepins, through whose clone entry you can visually edit text, images, and configuration.
Regarding limitations, the code is under the MIT license, but third-party assets such as demo images have their own licenses, and the repository is not authorized to share these images; external services such as domains and hosting may incur separate charges. The PageSpeed 100% in the README is a claim by the template provider and has not been verified in this introduction.
AstroBlog
Is it right for your project?
Use Cases
- Build a personal blog and publish image-text or MDX articles
- Add Disqus comments and related posts recommendations to a blog
- Organize articles on different topics through taxonomy pages
- Use Sitepins to visually edit site text, images, and configuration
Suitable For
- Developers who want to build a personal blog with Astro
- Writers who need MDX writing and custom component capabilities
- Users who prefer managing content through a Git repository and optionally integrating a headless CMS
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Install Node.js first; an LTS version is recommended
- 2
Run npm install in the project directory to install dependencies
- 3
Run npm run dev for local preview and npm run build to generate a production build
- 4
The template comes preconfigured with Sitepins; visual content editing is available through its clone entry
- 5
Third-party assets such as demo images must be checked against their respective licenses and cannot be covered by the code's MIT license
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope applies to that version's code and does not mean external services or third-party assets are free.
Must comply with when using
- You may use, modify, commercialize, and distribute this version's code 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
- Assets such as demo images have their own licenses, and the repository is not authorized to share them; they cannot be covered by the code's MIT license and must be checked and replaced independently.
- Visual content editing depends on the third-party Sitepins headless CMS service, which requires account registration and may incur external service fees.
- The contact form requires configuring a backend or third-party form service to actually receive submissions.
- Google Tag Manager integration requires providing external account configuration such as a GTM container ID.
- Disqus comments require registering a Disqus account and configuring a site shortname to enable.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
**Image license:** The images are only for demonstration purposes. They have their license, we don't have permission to share those images.
Original README
This template comes pre-configured with [**Sitepins**](https://sitepins.com), a Git-based Headless CMS designed for seamless content management.
Original README
- Supports Contact Form
Original README
- Google Tag Manager Integrated
Original README
https://github.com/statichunt/hydrogen-astro/blob/main/LICENSEhttps://github.com/statichunt/hydrogen-astro/blob/main/README.md- Disqus Comment Support
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
- 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
- 2026-07-09
- Screenshot last checked
- 2026-10-03
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: be94997de1ecbb639ab5ccd6c4377642d0f2c9d808adc3215f7e1aa51247b7c0
2026-10-03T04:44:46.924Z
Source file / repository<h1 align=center>Hydrogen Astro</h1>
<p align=center>Hydrogen is a minimal & highly customizable free Astro personal blog template ideal for creating personal blog website.
</p>
<h2 align="center"> <a target="_blank" href="https://hydrogen-astro.vercel.app/" rel="nofollow">👀Demo</a> | <a target="_blank" href="https://pagespeed.web.dev/report?url=https%3A%2F%2Fhydrogen-astro.vercel.app%2F&form_factor=desktop">Page Speed (100%)🚀</a>
</h2>
<p align=center>
<a href="https://github.com/withastro/astro/releases/tag/astro%406.3.1" alt="Contributors">
<img src="https://img.shields.io/static/v1?label=ASTRO&message=6.3&color=000&logo=astro" />
</a>
<a href="https://github.com/statichunt/hydrogen-astro/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/statichunt/hydrogen-astro" alt="license"></a>
<img src="https://img.shields.io/github/languages/code-size/statichunt/hydrogen-astro" alt="code size">
<a href="https://github.com/statichunt/hydrogen-astro/graphs/contributors">
<img src="https://img.shields.io/github/contributors/statichunt/hydrogen-astro" alt="contributors"></a>
</p>
## Key Features
- Supports Contact Form
- Google Tag Manager Integrated
- LLM-ready docs generation (llms.txt, llms-full.txt, and per-page .md)
- Disqus Comment Support
- Related Posts Suggestion
- MDX Support with many built-in custom components
- Semantic HTML Document Structure
- Custom Logo Support
- Includes All SCSS Files
- Taxonomy Page Support
- Images Optimized With Astro-Image
<!-- installation -->
## Installation
After downloading the template, you have some prerequisites to install. Then you can run it on your localhost. You can view the package.json file to see which scripts are included.
### Install prerequisites (once for a machine)
- **Node Installation:** [Install node js](https://nodejs.org/en/download/) [Recommended LTS version]
### Local setup
After successfully installing those dependencies, open this template with any IDE [[VS Code](https://code.visualstudio.com/) recommended], and then open the internal terminal of IDM [vs code shortcut <code>ctrl/cmd+\`</code>]
- Install dependencies
```
npm install
```
- Run locally
```
npm run dev
```
After that, it will open up a preview of the template in your default browser, watch for changes to source files, and live-reload the browser when changes are saved.
## Production Build
After finishing all the customization, you can create a production build by running this command.
```
npm run build
```
<!-- edit with sitepins -->
## 📝 Edit Content with CMS
This template comes pre-configured with [**Sitepins**](https://sitepins.com), a Git-based Headless CMS designed for seamless content management. You can update your website’s text, images, and configuration without touching a single line of code.
**How to get started:**
Click the Edit with Sitepins button below and follow the on-screen instructions to start editing your content visually.
<a target="_blank" href="https://app.sitepins.com/new/clone?name=Hydrogen%20Astro&repository=https://github.com/statichunt/hydrogen-astro/">
<img src="https://sitepins.com/button.svg" alt="Edit with Sitepins">
</a>
<!-- reporting issue -->
## Reporting Issues
We use GitHub Issues as the official bug tracker for this Template. Please Search [existing issues](https://github.com/statichunt/hydrogen-astro/issues). It’s possible someone has already reported the same problem.
If your problem or idea has not been addressed yet, feel free to [open a new issue](https://github.com/statichunt/hydrogen-astro/issues).
<!-- licence -->
## License
Copyright (c) 2024 - Present, Designed & Developed by [statichunt](https://statichunt.com)
**Code License:** Released under the [MIT](https://github.com/statichunt/hydrogen-astro/blob/main/LICENSE) license.
**Image license:** The images are only for demonstration purposes. They have their license, we don't have permission to share those images.
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