AstroPortfolioBlog

ziteox-blog — Astro Portfolio Template

By LakiXd

An Astro-based blog and portfolio site template using the Vitesse theme, with support for Markdown/MDX and Vue 3 components.

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-10-12View source

What stands out

A quick read of the recorded project description.

01

Built with Astro, using the Vitesse theme (astro-theme-vitesse) with customization and maintenance

02

Supports Markdown and MDX content, and allows Vue 3 components to be used in pages

03

Uses UnoCSS for styling and provides light/dark theme switching

04

The README states it includes SEO-related configuration such as meta tags, sitemap, and RSS

05

Responsive mobile-first layout, with the README noting deployment on Netlify

06

Uses the MIT license, and the README lists planned follow-ups such as a Headless CMS, tags, and animations

Template Details

Ziteox Blog is a blog and portfolio website template built with Astro, customized and maintained based on @kevinwong865's Vitesse theme (astro-theme-vitesse). The README describes it as a minimal, fast, and SEO-friendly blog and portfolio site, and provides the live URL blog.ziteox.com.

In terms of features, the README lists: a responsive mobile-first layout, light/dark theme switching, Markdown and MDX support, Vue 3 component support, the UnoCSS styling approach, and SEO configuration including meta tags, sitemap, and RSS; the deployment method is noted as Netlify. The README also mentions "Perfect Lighthouse scores," which is a claim from the project's own description; this introduction does not verify or endorse it.

The template is still evolving, and the README's Future Improvements section lists planned follow-ups: integrating a Headless CMS, author support and content tags, performance monitoring, enhanced SEO and share card previews, and more animations and page transitions. These are planned items and do not mean they are currently available.

For usage, the README provides a local startup flow of cloning the repository, npm install, and npm run dev, with the development server port at 1977; building and previewing use npm run build and npm run preview, with output going to the dist directory. The project uses the MIT license. The README does not provide a dependency list, specific framework version numbers, content directory structure, or integration details for CMS, comments, search, and similar features.

AstroPortfolioBlog

Is it right for your project?

Use Cases

  • Building a personal blog and publishing Markdown/MDX articles
  • A site that displays both a personal portfolio and blog content
  • A reading-oriented site that needs light/dark theme switching and mobile adaptation
  • An Astro project that wants to extend page interactions with Vue 3 components

Suitable For

  • Front-end developers familiar with npm and the basic Astro workflow
  • Individual developers who need a single site for both a blog and a portfolio
  • Content authors who prefer writing in Markdown/MDX and want to use Vue components

Getting started & customization

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

  1. 1

    The local startup flow provided by the README: git clone the repository, cd into the directory, npm install, npm run dev

  2. 2

    The development server is accessed by default at http://localhost:1977

  3. 3

    The build and preview commands are npm run build and npm run preview, with output in the dist directory

  4. 4

    The README notes the deployment platform as Netlify, but does not provide specific deployment configuration steps

  5. 5

    The README does not provide a dependency list, content directory structure, or integration details such as CMS; you need to check the repository files yourself

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version in the public repository under the MIT license; the free scope is the code of that version and does not mean external services or third-party assets are free.

Must comply with when using

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

  • 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

Compiled by DeepSeek based on repository license and README ·2026-10-12. 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 · 79 / 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
2025-07-30
Screenshot last checked
2026-10-12

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-20261015 · 2026-10-15

Inspect the recorded source material

SHA-256: 47fc153f39e64ac5733df895b0336980967fc8e61655433280c3e94f47f868ea

2026-10-12T20:22:53.120Z

Source file / repository
# Ziteox Blog — Astro-Powered Portfolio & Blog

A minimal, fast, and SEO-friendly blog & portfolio site built with [Astro](https://astro.build), using the **Vitesse** theme by [@kevinwong865](https://github.com/kevinwong865). Currently live at 👉 [**blog.ziteox.com**](https://blog.ziteox.com)

> This is a customized and maintained version of the [astro-theme-vitesse](https://github.com/kevinwong865/astro-theme-vitesse) template.

---

## 🚀 Live Preview

![Preview](./public/preview.jpg)

Explore the blog: [**blog.ziteox.com**](https://blog.ziteox.com)

---

## ⚡ Features

- Perfect Lighthouse scores
- Fully responsive, mobile-first layout
- SEO-optimized with meta tags, sitemap, and RSS
- Dark & light theme toggle
- Markdown & MDX support
- Vue 3 component support
- UnoCSS for fast and utility-first styling
- Deployed on Netlify

---

## 📈 Future Improvements

Ziteox Blog is still evolving. Upcoming upgrades include:

- Headless CMS integration for easier content management  
- Author support & content tagging  
- Better performance monitoring  
- Enhanced SEO and share card previews  
- More animations & page transitions

Stay tuned and feel free to fork or contribute.

---

## 🛠️ Quick Start

Clone & run locally:

```bash
git clone https://github.com/ziteox/ziteox-blog
cd ziteox-blog
npm install
npm run dev
```

Then open `http://localhost:1977`

---

## 🧱 Build & Preview

```bash
npm run build
npm run preview
```

Production files will be in the `dist` folder.


---

## 📄 License

MIT License © [Ziteox](https://github.com/ziteox)  
Original base: [astro-theme-vitesse](https://github.com/kieranwv/astro-theme-vitesse) by [@kevinwong865](https://github.com/kieranwv)
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.