Built with Astro and styled using Tailwind CSS
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.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Resume data maintained centrally in src/config/cv.json
Theme colors adjustable in src/styles/theme.ts
Built-in dark mode toggle and responsive layout
Supports writing blog posts in MDX, with a blog post example included in the repository
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.
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
Initialize the project with bun create astro@latest --template wasutz/astro-resume-theme or the corresponding npm, pnpm, or yarn command
- 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
Modify colors in src/styles/theme.ts; theme-related styles are located in src/styles/theme.css
- 4
Run bun run dev to start the local development server, which defaults to localhost:4321, with build output to ./dist/
- 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
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis 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
https://github.com/wasutz/astro-resume-theme/blob/main/LICENSEhttps://github.com/wasutz/astro-resume-theme/blob/main/README.mdSee [LICENSE](/LICENSE) for more information.
Original README
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.
Explore similar templates
Compare previews and descriptions within the same stack and category.

astro-theme-cactus
Astro Cactus is an Astro-based blog and portfolio theme that uses Markdown/MDX content collections to manage posts, notes, and tags, with frontmatter type-checked by a schema.
Astro · Portfolio

astrofy
Astrofy is a free and open-source personal portfolio website template built with Astro and TailwindCSS, with built-in blog, CV timeline, project showcase, store, and RSS feed modules.
Astro · Portfolio

astro-nano
Astro Nano is a static, minimalist portfolio and blog template built with Astro, Tailwind, and TypeScript without frontend frameworks. It includes light/dark themes, animated UI, automatic sitemap and RSS feed generation, and Markdown/MDX support with component imports.
Astro · Portfolio

astro-erudite
astro-erudite is an opinionated, unstyled static blog template built with Astro and native CSS, with no UI or CSS framework and minimal dependencies.
Astro · Portfolio

astro-sphere
Astro Sphere is a static, minimalist portfolio and blog theme maintained by markhorn-dev, built mainly with Astro, Tailwind, and TypeScript, with a small amount of SolidJS for stateful components.
Astro · Portfolio

astro-micro
Astro Micro is a framework-free blog and portfolio theme for Astro, forked from Astro Nano. It adds Pagefind search and Giscus comments while retaining type safety, sitemap, RSS, Markdown and MDX support, and TailwindCSS with system, light, and dark themes.
Astro · Portfolio
