Shiina-Astro-Blog

Shiina-Astro-Blog is a blog theme and static site generator built with Astro and Vue that transforms Markdown and MDX content into a deployable blog, supporting both static (SSG) and server-side rendering (SSR) build modes.

What is Shiina-Astro-Blog?

Shiina-Astro-Blog is an open-source blog framework that combines the Astro site builder with Vue components for interactivity. It takes Markdown or MDX files as content input and outputs a static blog site; the repository's metadata lists support for both SSG and SSR build modes. The project is authored by QingXia-Ela and is available on GitHub, though the README announces it as deprecated in favor of a next-generation replacement.

Key Features

• Astro + Vue stack — Uses Astro as the core framework and Vue for interactive components, with TypeScript as the language according to the repository topics.
• SSG and SSR build modes — The repository description explicitly states support for both static site generation and server-side rendering, giving deployment flexibility.
• MDX content support — Posts are written in Markdown or MDX, allowing embedded components and richer formatting in articles.
• CLI workflow — A built-in command-line tool creates new posts with npx blog n and pushes updates to git with npx blog d, automating the writing and deployment loop.
• SEO-friendly — The repository topic list includes SEO-friendly, indicating the theme is designed with search engine visibility in mind.
• User guide included — The README links to a documentation file at docs/user/概览.md that explains how to use the theme.

Who is it for?

• Astro developers — Use this theme as a starting point for a personal blog, then customize the Astro and Vue components to fit your own design.
• Writers who prefer Markdown — Manage content entirely through Markdown or MDX files and create posts from the terminal instead of a CMS.
• Self-hosters — Since the blog can be built into static files, you can deploy it to GitHub Pages, Netlify, Vercel, or any static hosting service.

What can you do with Shiina-Astro-Blog?

• Start a blog quickly — Clone the repository, install dependencies with pnpm i, and run npm run dev for a local development server.
• Create a new article — Run npx blog n with a title to generate a new Markdown post file, then edit it in your editor.
• Build and deploy — Run npm run build to generate the static site, then use npx blog d to push the latest content to your git remote.

How does Shiina-Astro-Blog work?

The workflow is built around commands: after cloning and installing, you edit content in Markdown/MDX, preview locally with npm run dev, create posts via the CLI, and produce a production build with npm run build. The blog's search and layout are implemented in the theme, and the author notes that some features like image optimization and a sidebar index are either missing or not working well.

Known limitations

The author explicitly lists current drawbacks in the README: image handling is difficult and does not use Astro's built-in image preprocessing, making pages with many images slow to load; the design is not content-focused and the article layout is dense; there is no sidebar article index or image viewer/zoom; and the search uses a custom implementation rather than an integration like Pagefind. Because of these issues, the project is deprecated and the author recommends following the successor project Shiina-Astro-Blog-Next.

FAQ

Is Shiina-Astro-Blog free?

Yes, the project is open source on GitHub, so it is free to use, modify, and deploy. There are no paid tiers mentioned in the repository.

How do I create a new post?

Run npx blog n followed by the title of your article in the project directory. This generates a new Markdown file that you can then edit with your preferred text editor.

Does Shiina-Astro-Blog support image optimization?

No. The README states that the framework does not leverage Astro's native image import and processing, so image-heavy pages can be slow. The author recommends using the upcoming next version for better image handling.

What is the successor project?

The author is developing Shiina-Astro-Blog-Next, a new minimal blog framework that addresses the current version's issues. Progress is available at the linked GitHub repository.