Astro-based blog template with an MIT-licensed repository
yukina — Astro Blog Template
By WhitePaper233
Yukina is an Astro-based blog template. The repository is MIT-licensed and provides desktop and mobile pages, with design inspired by Hexo Shoka and Astro Fuwari.
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.
Provides an online demo site with desktop and mobile page screenshots
README gives a complete command flow from Node.js 22, Corepack, and pnpm through build and preview
Design inspired by the Hexo Shoka theme and the Astro Fuwari template
Roadmap lists search, i18n, RSS/SiteMap, adjustable colors, and other features still in testing or in progress
Template Details
Yukina is an Astro blog template maintained by WhitePaper233. The repository is described as "Simple and Elegant Astro Blog Template", listed on Astro Themes, and has about 282 GitHub stars. The template provides an online demo site with pages including a homepage and an about page, and desktop and mobile preview screenshots have been captured.
The build process is documented in the README: Node.js 22 or later is required, pnpm is enabled via Corepack, and commands are run in sequence to install dependencies, build the search index, start the development server, build, and preview. The README Roadmap shows that basic functionality, code refactoring, animations, mobile adaptation, adjustable colors, RSS/SiteMap, search, and i18n are in testing or in progress, while Live2D, CLI and a small CMS, Slidev components, and more Markdown components remain planned, indicating that some capabilities are not yet complete.
Regarding licensing, the repository LICENSE is MIT, permitting free use, modification, commercial use, and distribution of this version of the code, provided the copyright notice and license notice are retained when distributing. 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.
Is it right for your project?
Use Cases
- Building a personal technical blog or writing site
- Developing a custom blog theme on top of Astro
- Learning how an Astro blog project is organized by referencing its page structure and build process
Suitable For
- Bloggers using Astro who want a quick start
- Developers who need an MIT license and the freedom to modify the code
- People willing to configure Node.js and pnpm environments themselves following the README steps
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Requires Node.js 22 or later
- 2
First run corepack enable and corepack enable pnpm to enable pnpm
- 3
Run pnpm install to install dependencies and pnpm build to build the search index
- 4
Use pnpm dev to start the development server, pnpm build to build the project, and pnpm preview to preview
- 5
Third-party assets such as demo images, fonts, and icons must be checked against their respective licenses; external services such as hosting may incur separate charges
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope applies to this version of the code 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 permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete 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.
- Using this template requires Node.js 22 or later; environments below this version cannot build following the README process.
- Dependency management requires enabling pnpm via Corepack; without pnpm enabled, subsequent install and build commands cannot be run.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
### 1. Install Node.js version 22 or above
Original README
https://github.com/WhitePaper233/yukina/blob/main/LICENSEhttps://github.com/WhitePaper233/yukina/blob/main/README.mdcorepack enable pnpm
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-04. 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
- Astro Themes
- Documentation and maintenance reference score
- More documented · 91 / 100
- Technologies
- Astro
- Website type
- 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-09-09
- Screenshot last checked
- 2026-10-04
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: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: 2e116543549979c8f544ef4b016f4df0c2d0c67702268c75678cd504c4472019
2026-10-04T10:14:57.748Z
Source file / repository# Yukina Simple and Elegant Astro Blog Template  [中文](https://github.com/WhitePaper233/yukina/blob/main/README_zh.md) ## Demo Preview Links [🖥️ Live Demo (Vercel)](https://yukina-blog.vercel.app) | [🖥️ WhitePaper233's Blog (possibly not the latest version)](https://whitepaper233.top/) ## 🛠️ Build Guide ### 1. Install Node.js version 22 or above Go to the [Node.js official website](https://nodejs.org/) to download and install the latest version of Node.js. ### 2. Enable Corepack ```bash corepack enable ``` ### 3. Install pnpm ```bash corepack enable pnpm ``` ### 4. Install Dependencies ```bash pnpm install ``` ### 5. Build Search Index ```bash pnpm build ``` ### 6. Start Development Server ```bash pnpm dev ``` ### 7. Build Project ```bash pnpm build ``` ### 8. Preview Project ```bash pnpm preview ``` ## 🗺️ Roadmap ### Recent ✅ - Completed | 🧪 - In Testing | 🚧 - In Progress | ⏳ - Planned | Status | Project | | ------ | --------------------------------------------------- | | 🧪 | Basic feature implementation | | 🧪 | Refactoring some code, optimizing overall structure | | 🧪 | Optimizing animation effects | | 🧪 | Mobile adaptation | | 🚧 | Optimizing website performance | | 🧪 | Adjustable colors | | 🧪 | Adding RSS, SiteMap, and other features | | 🧪 | More build options (e.g., SLUG generation methods) | | ⏳ | Adding Live2D character | | 🧪 | Search functionality | | 🧪 | i18n | ### Long-term | Status | Project | | ------ | ---------------------------------------------- | | ⏳ | Developing an easy-to-manage CLI and small CMS | | ⏳ | Slidev components | | ⏳ | More Markdown components | ## 🙏 Special Thanks - [Hexo Shoka Theme](https://github.com/amehime/hexo-theme-shoka) for providing design ideas - [Astro Fuwari Template](https://github.com/saicaca/fuwari) for providing the main design ideas and some code implementations
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
AstroPaper is a minimal, responsive, accessible, and SEO-friendly Astro blog theme. Articles are stored as Markdown/MDX in src/content/posts/, with subdirectories affecting URLs.
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
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
