AstroPortfolioBlog

astro-theme-resume — Astro Portfolio Template

By srleom

An open-source personal resume site template built with Astro and Tailwind, featuring a resume homepage and a blog supporting Markdown/MDX.

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

Homepage displays a resume, with a separate blog module

02

Uses TailwindCSS utility classes, supports dark/light mode

03

Blog posts support Markdown and MDX formats

04

Built-in pagination, automatic RSS feed, and sitemap generation

05

Preconfigured ESLint and Prettier

06

Image optimization handled through Astro Assets Integration

Template Details

astro-theme-resume is a personal resume site template built with Astro. The homepage presents resume content and includes a built-in blog module. Styling uses TailwindCSS utility classes, provides dark/light mode switching, and the pages use semantic HTML markup. Blog posts are placed as Markdown or MDX files in the src/content/ directory, supporting pagination, automatic RSS feed generation, and sitemap, with code blocks highlighted using Expressive Code. The project comes with preconfigured ESLint and Prettier, and handles image optimization through Astro Assets Integration.

Site information for the template is centralized in src/site.config.ts, the resume homepage content and design are in src/pages/index.astro, the global layout is in src/layouts/BaseLayout.astro, the blog post layout is in src/layouts/BlogPost.astro, theme colors are in src/styles/app.css, and fonts must be placed in public and registered in the styles and Tailwind configuration. The README states that the blog design references astro-theme-cactus, and the resume homepage design references minirezume-framer.

Regarding usage restrictions, the repository uses the MIT license, allowing free use, modification, commercial use, and distribution of this version of the code, but the copyright notice and the full MIT license notice must be retained when distributing; third-party assets such as demo images, fonts, and icons must be checked separately under their respective licenses, and external services such as domains and hosting may incur additional charges.

AstroPortfolioBlog

Is it right for your project?

Use Cases

  • Building a personal online resume with an attached technical blog
  • As an Astro learning project, referencing its content collections and layout organization
  • Quickly replacing site information and theme colors based on existing resume content
  • Static personal sites that need RSS and sitemap

Suitable For

  • Developers who want to publish a resume and articles using a static site
  • Users familiar with or willing to use Astro and TailwindCSS
  • Maintainers of personal sites who need a Markdown/MDX writing workflow

Getting started & customization

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

  1. 1

    Site title, description, and other information are modified in src/site.config.ts

  2. 2

    Resume homepage content and design are edited in src/pages/index.astro

  3. 3

    Blog posts are placed as .md files in the src/content/ directory; images can be placed in a subfolder of the same directory and referenced in the text

  4. 4

    Theme colors are adjusted in src/styles/app.css; custom fonts must be placed in public and registered in the styles and tailwind.config.js

  5. 5

    The repository uses the MIT license; when distributing, the copyright notice and full license notice must be retained, and third-party assets must be checked separately for licensing

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 is the code of this version and does not mean external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version of the code are allowed.
  • 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 blog design references the astro-theme-cactus project; that design originates from a third-party project, and if redistributing or commercially using the related design, you should check its license terms yourself.
  • The resume homepage design references minirezume-framer (a Framer website); that design originates from a third party, and when using or redistributing the related design, you must confirm its authorization yourself.
  • Custom fonts require you to provide the font files and place them in the public directory; the licensing of the fonts themselves must be confirmed by the user, and the template does not include usable font licenses.
  • Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses and cannot be judged solely by 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

[astro-theme-cactus](https://github.com/chrismwilliams/astro-theme-cactus) for blog design

Original README

[minirezume-framer](https://minirezume.framer.website/) for resume homepage design

Original README

To change the fonts of the site, add your font files into `/public`

Original README
https://github.com/srleom/astro-theme-resume/blob/main/LICENSEhttps://github.com/srleom/astro-theme-resume/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 · Blog
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
2024-04-13
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: 837b5d366cfa16f7b99b1b575622ae13d9384a04efb11e49fe0739ac73f6010f

2026-10-01T13:52:41.751Z

Source file / repository
# Astro Resume

## Features

- Astro v4
- TailwindCSS utility classes
- ESLint / Prettier pre-installed and pre-configured
- Accessible, semantic HTML markup
- Responsive & SEO-friendly
- Dark / Light mode, using Tailwind and CSS variables (referenced from shadcn)
- [Astro Assets Integration](https://docs.astro.build/en/guides/assets/) for optimised images
- MD & [MDX](https://docs.astro.build/en/guides/markdown-content/#mdx-only-features) posts
- Pagination
- [Automatic RSS feed](https://docs.astro.build/en/guides/rss)
- Auto-generated [sitemap](https://docs.astro.build/en/guides/integrations-guide/sitemap/)
- [Expressive Code](https://expressive-code.com/) source code and syntax highlighter

## Credits

- [astro-theme-cactus](https://github.com/chrismwilliams/astro-theme-cactus) for blog design
- [minirezume-framer](https://minirezume.framer.website/) for resume homepage design

## Project Structure

Inside of your Astro project, you'll see the following folders and files:

```text
├── public/
├── src/
    ├── assets/
│   ├── components/
│   ├── content/
│   ├── layouts/
|   ├── pages/
|   ├── styles/
|   ├── utils/
|   ├── site.config.ts
│   └── types.ts
├── .elintrc.cjs
├── .gitignore
├── .prettierignore
├── package.json
├── prettier.config.cjs
├── README.md
├── tailwind.config.js
└── tsconfig.json
```

## Editing guide

### Site info

To edit site info such as site title and description, edit the `src/site.config.ts` file.

### Page contents

To edit the resume homepage content and design, edit the `src/pages/index.astro` file.

### Page components

To edit page components found site-wide such as the card used in the homepage, edit the files found in the `src/components/` directory.

### Layouts

To edit the base layouts of all pages, edit the `src/layouts/BaseLayout.astro` file.

To edit the layout of a blog article, edit the `src/layouts/BlogPost.astro` file.

### Blog content

To add blog content, insert `.md` files in the `src/content/` directory.

To add images in blog articles, insert a folder in the `src/content/` directory, add both the `.md` and image files into the new folder, and reference the image in your `.md` file.

## Theming

To change the theme colours of the site, edit the `src/styles/app.css` file.

To change the fonts of the site, add your font files into `/public`, add it as a `@font-face` in the `src/styles/app.css` file, as a `fontFamily` in the `tailwind.config.js` file, and apply the new font class to the `body` tag in the `src/layouts/BaseLayout.astro` file.
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.