Introduction

Hydrogen Astro is a minimal and highly customizable free Astro personal blog template. It's designed for creating personal blog websites with a focus on performance and flexibility. The template offers a clean, modern design and is built using Astro, a modern static site generator.

Main Features

• Contact Form support
• Disqus Comment integration
• Related Posts suggestion functionality
• MDX support with custom components
• Semantic HTML structure for better SEO
• Custom logo support
• Includes all SCSS files for easy customization
• Taxonomy page support
• Image optimization using Astro-Image
• Fast page speed (100% score)

Installation Steps

1. Ensure Node.js is installed on your machine
2. Clone the repository
3. Open the project in your preferred IDE (VS Code recommended)
4. Install dependencies:

   npm install
   

5. Run the development server:

   npm run dev
   

Usage Instructions

1. Customize the template by modifying the source files
2. Add your blog posts as MDX files in the appropriate directory
3. Customize the styling by editing the SCSS files
4. Add your custom logo in the designated location
5. Configure the contact form to work with your preferred service
6. Set up Disqus comments by adding your Disqus shortname
7. Optimize images using the built-in Astro-Image integration
8. Create taxonomy pages for categories or tags
9. Test your changes locally using the development server
10. Build for production:

    npm run build
    

Important Notes

1. The template is released under the MIT license
2. Demo images are for demonstration purposes only and may have their own licenses
3. Astro is used as the primary framework, providing excellent performance
4. TypeScript is supported out of the box for type-safe development
5. The project uses Tailwind CSS for styling, configured via tailwind.config.js
6. PostCSS is used for processing CSS, configured in postcss.config.js
7. The template is set up for easy deployment on platforms like Vercel or Netlify
8. For reporting issues or suggesting improvements, use the GitHub Issues feature
9. Regular updates to Astro and other dependencies are recommended
10. The template structure is designed for easy customization and extension