Introduction

The Astro Minimal Portfolio Template is a sleek and efficient solution for creating personal portfolio websites. Built with Astro and Tailwind CSS, this template offers a minimalistic design inspired by Brian Ruiz. It's perfect for developers, designers, and creatives who want to showcase their work in a clean, professional manner without the need for complex coding.

Main Features

• Fully responsive design
• Perfect Google Lighthouse scores for optimal performance
• SEO-optimized blog with Markdown support
• Customizable content and styling
• Pre-built pages: Home, About, Projects, and Blog
• Self-hosting ready
• Fast loading times
• Easy configuration through a central config file

Installation Steps

1. Clone the repository:

   git clone https://github.com/TimWitzdam/astro-minimal-portfolio-template.git
   

2. Navigate to the project directory:

   cd astro-minimal-portfolio-template
   

3. Install dependencies:

   npm install
   

4. Start the development server:

   npm run dev
   

Usage Instructions

1. Customize your portfolio:

   • Edit the src/config.ts file to update personal information, social links, and page content
   • Modify or add Markdown files in the src/content directory for blog posts
   • Adjust styles using Tailwind CSS classes in the component files

2. Add your projects:

   • Update the projects array in the src/config.ts file with your project details

3. Write blog posts:

   • Create new Markdown files in the src/content/blog directory
   • Use the provided frontmatter format for consistent styling

4. Build for production:

   npm run build
   

5. Preview the production build:

   npm run preview
   

6. Deploy your site:

   • Use the generated dist folder to deploy on your preferred hosting platform

Important Notes

1. The template is designed for simplicity and ease of use, making it ideal for quick portfolio setups.

2. Astro's static site generation ensures fast loading times and excellent SEO performance.

3. Tailwind CSS integration allows for rapid styling and customization without writing custom CSS.

4. The centralized configuration file (src/config.ts) makes it easy to update content across the site.

5. The template includes a blog feature with Markdown support, allowing for easy content creation.

6. All pages are fully responsive and optimized for various screen sizes.

7. The project structure is kept minimal and intuitive, making it easy to understand and extend.

8. Custom components are available for common elements like navigation and social links.

9. The template is open-source and licensed under the MIT license, allowing for personal and commercial use.

10. For any issues or feature requests, users can utilize the GitHub issues section of the repository or contact the creator directly at contact@witzdam.com.