AstroPortfolio

astro-resume-theme — Astro Portfolio Template

By wasutz

An online resume/portfolio template built with Astro and Tailwind CSS, with resume data configured via JSON, dark mode support, and an MDX blog.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

3 previews
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-09-30View source

What stands out

A quick read of the recorded project description.

01

Built with Astro and styled using Tailwind CSS

02

Resume data maintained centrally in src/config/cv.json

03

Theme colors adjustable in src/styles/theme.ts

04

Built-in dark mode toggle and responsive layout

05

Supports writing blog posts in MDX, with a blog post example included in the repository

06

Provides a create astro template initialization command, compatible with bun, npm, pnpm, and yarn

Template Details

Astro Resume Theme is an Astro template for building a personal online resume or portfolio page, styled with Tailwind CSS. Resume content is maintained centrally in src/config/cv.json, theme colors are adjusted in src/styles/theme.ts, and the CV file is placed in src/public/cv and referenced by filename in the configuration, so personal information can be replaced without changing the page structure. The template includes a built-in dark mode toggle, responsive layout, and support for writing blog posts in MDX, with a blog post example included in the repository.

Usage involves initializing a project with the create astro command using this repository as a template, then installing dependencies with bun (or another package manager such as npm) and running the development server, which defaults to localhost:4321, with build output to ./dist/. The repository uses the MIT license, allowing free use, modification, commercial use, and distribution of the code, but third-party assets such as demo images, fonts, and icons require separate license verification, and external services such as domains and hosting may incur costs. The Lighthouse/PageSpeed scores and SEO-friendliness mentioned in the README are the author's own claims, with no verifiable data provided in the materials.

AstroPortfolio

Is it right for your project?

Use Cases

  • Creating a personal online resume page with a downloadable CV file
  • Building a portfolio site that includes blog posts
  • A personal homepage requiring dark mode and mobile adaptation
  • Quickly replacing resume content via JSON configuration without changing the page structure

Suitable For

  • Developers and job seekers who need to quickly launch a personal resume or portfolio
  • Users familiar with Astro or willing to initialize a project using Astro commands
  • Those who prefer maintaining resume content through configuration files rather than modifying the template
  • Individual users who need a blog and resume on the same site

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Initialize the project with bun create astro@latest --template wasutz/astro-resume-theme or the corresponding npm, pnpm, or yarn command

  2. 2

    Fill in resume data in src/config/cv.json, place the CV file in src/public/cv, and update the filename in the configuration

  3. 3

    Modify colors in src/styles/theme.ts; theme-related styles are located in src/styles/theme.css

  4. 4

    Run bun run dev to start the local development server, which defaults to localhost:4321, with build output to ./dist/

  5. 5

    Third-party assets such as demo images, fonts, and icons require separate license verification and cannot be judged solely based on the code's MIT license

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope applies to that version's code and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of that version's code are permitted.
  • 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

  • The code is under the MIT license, allowing free use, modification, commercial use, and distribution, but copyright and license notices must be retained.
  • When using and redistributing, include the full MIT license text and comply with its copyright and disclaimer terms.
  • Demo images, fonts, icons, and other third-party assets require separate license verification and cannot be judged solely based on the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

Licensed under the MIT License, Copyright © Wasut Panyawiphat.

Original README

See [LICENSE](/LICENSE) for more information.

Original README
https://github.com/wasutz/astro-resume-theme/blob/main/LICENSEhttps://github.com/wasutz/astro-resume-theme/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-01. 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 · 81 / 100
Technologies
Astro
Website type
Portfolio
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
2025-08-23
Screenshot last checked
2026-10-01

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: 5ac0f42b29acb4914e61a0a8c0d23200d346c5f63c0ef6ed6fd1b4c72c7c1064

2026-10-01T14:05:09.904Z

Source file / repository
# Astro Resume Theme

Astro Resume Theme is a fully customizable and responsive template, built to help you create a beautiful online resume or portfolio with ease. It is powered by Astro and styled using Tailwind CSS, making it fast, modern, and easy to work with.

## Usage

You can bootstrap a new Astro project using the following command:

```bash
# Bun
bun create astro@latest --template wasutz/astro-resume-theme

# npm 7+
npm create astro@latest -- --template wasutz/astro-resume-theme

# pnpm
pnpm dlx create-astro --template wasutz/astro-resume-theme

# yarn
yarn create astro --template wasutz/astro-resume-theme
```

## 🚀 Features

- Tailwind CSS: Utilizes utility-first styling for rapid UI development.
- Dark Mode: Built-in dark mode toggle for better UX.
- Theme Customization: Easily adjustable in src/styles/theme.css.
- Responsive Design: Optimized for mobile, tablet, and desktop devices.
- MDX Support: Allows blog posts written in Markdown with JSX components.
- Excellent Lighthouse/PageSpeed scores
- SEO-friendly

## 🧞 Commands

All commands are run from the root of the project, from a terminal:
(Could be use 'npm' instead of bun)

| Command                   | Action                                           |
| :------------------------ | :----------------------------------------------- |
| `bun install`             | Installs dependencies                            |
| `bun run dev`             | Starts local dev server at `localhost:4321`      |
| `bun run build`           | Build your production site to `./dist/`          |
| `bun run preview`         | Preview your build locally, before deploying     |
| `bun run astro ...`       | Run CLI commands like `astro add`, `astro check` |
| `bun run astro -- --help` | Get help using the Astro CLI                     |

# Getting Started

1) Initialize the project
Run one of the commands listed in the Quick Start section.

2) Customize your resume data
Edit your resume data in `src/config/cv.json`

3) Customize theme colors
Modify the color scheme by editing `src/styles/theme.ts` to match your personal branding.

4) Replace your CV file
Put your cv file in `src/public/cv` and then replace the file name in `src/config/cv.json` (basic.cv_file_name)

5) Run the project locally
Once you’ve made your customizations, run the development server:

```
bun run dev
```

Open http://localhost:4321 in your browser to view the result 🚀

## License

Licensed under the MIT License, Copyright © Wasut Panyawiphat.

See [LICENSE](/LICENSE) for more information.
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.