A responsive Astro starter portfolio template designed to be easy to customize as a reusable template.
- Centralized Data: All content in
/data/for easy customization - Built-in Themes: Choose a costum theme color palettes from a single config file.
- Fully Responsive: Optimized for mobile, tablet, and desktop.
- Performance: Optimized for perfect Lighthouse scores.
- SEO Ready: Open Graph and semantic HTML
- Fast — Static-first architecture
Make sure you have Node.js v22.12.0 or higher installed on your machine.
- Click Use this template on this repository.
- Choose Create a new repository.
- Clone your new repository:
git clone <your-repo-url> - Navigate to your repo:
cd <your-repo-name> - Install dependencies:
npm install - Start development server:
npm run dev - Update your content in
/data - Deploy on your preferred platform
Edit data/site.ts to update:
- Hero section texts
- About section texts
- experience cards content
- Archive projects page content
- Contact links
Replace the sample images in /public with your own:
- Featured projects cards images
- Favicon/logo
This template comes with multiple built-in color palettes. To change the theme of your portfolio,
open src/config.ts and update the baseTheme variable to one of the available options:
'default', 'strategic', 'innovator', 'executive'
├── public/ # Static assets
├── data/ # jsON files for project data
├── src/
│ ├── components/ # Reusable Astro components
│ ├── layouts/ # Layout templates with Meta tags
│ ├── pages/ # Site routes (index.astro)
│ └── styles/ # global css styles
│ └── config.ts # Global site configuration
├── astro.config.mjs # Astro configuration
└── tsconfig.json # Typescript configuration
| Command | Action |
|---|---|
npm install |
Installs dependencies |
npm run dev |
Starts local dev server at localhost:4321 |
npm run build |
Build your production site to ./dist/ |
npm run preview |
Preview your build locally, before deploying |
npm run astro ... |
Run CLI commands like astro add, astro check |
npm run astro -- --help |
Get help using the Astro CLI |
Please read the Contributing Guide before opening a PR.
This project is licensed under the MIT License. You are free to use, modify, and distribute this template.