AstroPortfolioBlog

hiyanxyz — Astro Portfolio Template

By mrlinnth

A personal portfolio website template built with Astro, Tailwind CSS and TypeScript, supporting MDX content, light and dark themes, and automatic sitemap and RSS generation.

Open Source Site Download Source ZIP

Explore the design

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

2 previews

Desktop homepage1 / 2

Visit websiteOpens in a new tab

Desktop captureTop of page

Actual browser screenshot from the verified demo.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-18View source

What stands out

A quick read of the recorded project description.

Built with the Astro static site generator

Tailwind CSS for styling and TypeScript for type safety

Supports writing content in MDX

Includes light and dark themes and responsive design

SEO configuration with automatic sitemap and RSS generation

Provides ESLint check and auto-fix commands

Template Details

This template is a personal portfolio website. The README states that it uses Astro as the static site generator, Tailwind CSS for styling, and TypeScript for type safety, with MDX content support. Functionally it includes responsive design, light and dark theme switching, SEO configuration with automatic sitemap and RSS generation, and an ESLint code-checking script.

For usage, the README lists commands for installing dependencies with npm, local development (default localhost:4321), building to ./dist/, previewing the build locally, and running and auto-fixing ESLint. For deployment, it only states publishing via Cloudflare Pages with Wrangler and does not give specific configuration steps. The README does not document the content model, page structure, component organization or configurable options, and does not provide integration details beyond the deployment platform; performance-related descriptions are claims in the README and are not inferred or expanded here.

AstroPortfolioBlog

Is it right for your project?

Use Cases

Building a personal portfolio or introductory static website
Writing project introductions and articles in MDX
Showcase sites that need light and dark theme switching
Personal sites deployed to Cloudflare Pages

Suitable For

Individual developers who want to use Astro and Tailwind CSS
Portfolio sites that need to maintain content in MDX
Front-end projects that prefer TypeScript type checking

Getting started & customization

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

1
Run npm install to install dependencies
2
Run npm run dev to start the local development server, with the default address localhost:4321
3
Run npm run build to generate the production site into the ./dist/ directory
4
Run npm run preview to preview the build result locally
5
The README states deployment via Cloudflare Pages with Wrangler but does not provide specific deployment steps

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

The code of this version may be used, modified, used commercially and distributed free of charge.
When distributing copies or substantial portions of the code, the original author's copyright notice and the complete MIT license notice must retain.
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

Demo images, fonts, icons and other third-party assets must be checked against 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 separate charges.

View Original Text Basis

Permission is hereby granted, free of charge
Original License Text

https://github.com/mrlinnth/hiyanxyz/blob/main/LICENSE https://github.com/mrlinnth/hiyanxyz/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-13. 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 · 85 / 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: 2026-06-05
Screenshot last checked: 2026-10-18

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.

Review declaration: codex-user-requested-batch-review-20261018 · 2026-10-18

Inspect the recorded source material

SHA-256: 7ee0b7a08fa5ca341365702d977bbe4682906686273947098b3ac411c18a752f

2026-10-13T06:29:04.725Z

Source file / repository

# Yan's Portfolio

Personal portfolio website built with Astro, Tailwind CSS, and TypeScript.

## Features

- 100/100 Lighthouse performance
- Responsive design
- Light/dark theme
- SEO optimized with auto-generated sitemap and RSS feed
- Type-safe with TypeScript
- MDX support for content

## Tech Stack

- Astro - Static site generator
- Tailwind CSS - Styling
- TypeScript - Type safety
- MDX - Enhanced markdown content

## Commands

| Command | Action |
|---------|--------|
| `npm install` | Install dependencies |
| `npm run dev` | Start local dev server at `localhost:4321` |
| `npm run build` | Build production site to `./dist/` |
| `npm run preview` | Preview build locally |
| `npm run lint` | Run ESLint |
| `npm run lint:fix` | Auto-fix ESLint issues |

## Deployment

The site is deployed via Cloudflare Pages using Wrangler.

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

astrowind

AstroWind is a free, open-source Astro starter theme using Astro and Tailwind CSS, released under the MIT license.

Astro · Blog

astro-paper

An Astro blog theme with Markdown/MDX content, Tailwind styling and Pagefind search. Search is a feature of the blog, rather than a separate tool-site product.

Astro · Blog

fuwari

Fuwari is a static blog template built with Astro and Tailwind CSS for personal blogs. It manages posts as Markdown files in src/content/posts/, with frontmatter for title, date, description, cover, tags, categories, draft status, and language.

Astro · Blog

Firefly

Firefly is a clean personal blog theme forked from Astro and Fuwari, offering four background modes, single/double sidebar and list/grid layouts, Pagefind client-side full-text search, and a six-language UI.

Astro · Blog

astro-theme-cactus

An Astro blog and notes starter with Markdown/MDX content, Tailwind styling and Pagefind search. Its main purpose is publishing posts and notes.

Astro · Blog

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