Minearm & Website is an open-source Astro blog template that generates a complete personal blogging site with tag and category organization, friend links, and a built-in dark theme, forked from HusBlog and upgraded to Astro 5.5.4.
What is Minearm & Website?
Minearm & Website is an open-source blog template built on the Astro framework (version 5.5.4), forked from HusBlog and maintained by Minearm-RPM. It takes Markdown-based blog content from the src/content/blog/default directory and generates a static site with pages for posts, categories, tags, an about page, and a friends page. The template runs on Node.js v18.17.1 or v20.3.0 and above (v19 is not supported) and is distributed via npm as the package "minearm-website" or through its GitHub repository.
Key Features
- Astro 5.5.4 framework — Upgraded from the original HusBlog, with SCSS warnings fixed and modern static-site generation.
- Category and tag pages — Dynamic routes for categories/[category] and tags/[tag] allow automatic grouping of posts.
- Friend links page — A dedicated /friends page for displaying blogroll or partner sites.
- Built-in dark theme — A styled template with SCSS-based styling located under src/styles.
- Content collections — Uses Astro's content collections with blog posts stored in src/content/blog/default.
- Componentized layout — Organized components for animation, aside, client, footer, header, icons, loading, and post list.
- MIT License — Free to use and modify, copyrighted 2025 by Minearm-RPM.
- Versioned releases — Latest stable version 0.2.1, latest beta 0.0.3-beta.4.
Who is it for?
- Bloggers and writers — who want a fast, SEO-friendly static blog without managing a server.
- Astro developers — who need a starting point with tag/category taxonomies and a friends page already implemented.
- Personal site owners — who want an about page, a dark theme, and an easy way to publish Markdown posts.
What can you do with Minearm & Website?
- Publish articles — Write posts in Markdown inside the content/blog/default folder and the template generates category and tag pages automatically.
- Customize the design — Edit SCSS files under src/styles to change colors, layout, and components.
- Share a blogroll — Use the friends page to list other websites you want to recommend.
- Build and deploy — Run npm run build to produce a static site that can be deployed to any static host, then npm run preview to test locally.
How does it work?
The template is installed either as an npm package (npm i minearm-website) or by cloning the GitHub repository. After running npm install, you start development with npm run dev, build the production site with npm run build, and preview it with npm run preview. Content is authored as Markdown files and automatically routed by Astro's file-based routing.
FAQ
What Node.js version is required?
Node.js v18.17.1 or v20.3.0 or higher is required; v19 is explicitly not supported.
What is the latest version?
The latest stable release is 0.2.1, while the latest beta is 0.0.3-beta.4.
Is Minearm & Website free?
Yes, it is open source under the MIT License.
How is this different from HusBlog?
It fixes SCSS warnings and upgrades Astro to version 5.5.4.
Can I use it with a different blog engine?
No, it is built on Astro's content collections and file-based routing, so posts are Markdown files in the content directory.
