English 丨 简体中文
A clean, elegant, feature-rich blog theme for Astro.
Static pages, Markdown / MDX, light and dark modes, content components, local search, feeds, comments, and a music capsule that persists across navigation.
Use this template · Quick start · Report an issue
Install Node.js 22.12.0+ and pnpm. Use the pnpm version specified in the packageManager field of package.json.
Click Use this template to create an independent repository, then clone your copy with your account and repository names.
git clone https://github.com/YOUR_NAME/my-blog.git
cd my-blog
pnpm install --frozen-lockfile
pnpm devOpen the local URL shown in your terminal to preview the theme and sample content.
Edit site.config.ts to set your site URL, title, author, navigation, and theme options.
import { defineSolitudeConfig } from './src/config';
export default defineSolitudeConfig({
site: 'https://example.com',
title: 'My blog',
description: 'Notes, stories, and discoveries.',
locale: 'en',
author: { name: 'Your name' },
});For a site hosted under a subdirectory, also set base, for example base: '/blog/'.
The template includes sample posts and pages with local search enabled. Comments, comment aggregation, and the music hall are disabled with empty service identifiers. The music capsule is enabled with a sample Qishui playlist. Replace theme.capsule.id with your own playlist or set theme.capsule.enable: false to disable it. Replace sample content, images, and site identity before publishing. Changing the interface locale does not translate posts or custom navigation.
Create a Markdown or MDX file named hello-world.md under src/content/posts/.
---
title: Hello, world
date: 2026-09-11
description: My first post.
tags: [Life]
---
Start your story here.The default URL is /p/hello-world/. Use slug, url, and aliases to customize addresses. Set draft: true for drafts, or home: false to hide a post from homepage areas while keeping it in archives, search, RSS, and direct links.
pnpm build
pnpm previewPublish the generated dist/ directory to your hosting platform. Set the build command to pnpm build and the output directory to dist. Use pnpm install --frozen-lockfile during dependency installation.
Icons use local Iconify sets and render as SVG through Astro Icon at build time. Icon parameters in navigation, profile links, and MDX components accept names such as lucide:book-open and simple-icons:github. Browse Lucide and Simple Icons for available names.
<Button url="/archives/" text="Read the posts" icon="lucide:book-open" />Use label to name the action of an icon-only button.
For an icon-based site name, use theme.site.name: { class: 'icon', custom: 'simple-icons:astro' }.
Edit about.ts, links.ts, kit.ts, and brevity.ts in src/data/ to maintain the about, friends, equipment, and short-update pages. Each module uses satisfies for type checking and supports comments and multiline text.
import type { AboutData } from '@/types/about';
export default {
title: 'About me',
sections: [
{ type: 'story', title: 'My story', content: 'Introduce yourself here.' },
],
} satisfies AboutData;Save custom data as src/data/profile.ts, then set type: about and data: profile in the page front matter. Run pnpm check to validate data types. Builds report missing data files.
Run commands from the project root.
| Command | Purpose |
|---|---|
pnpm dev |
Start local development |
pnpm build |
Generate the static site in dist/ |
pnpm preview |
Preview the production build |
pnpm check |
Check TypeScript and Astro components |
Feedback and focused improvements are welcome. Follow the contribution guide and include reproduction steps and verification results in issues or pull requests.
Apache-2.0 License © 2026–present everfu. Retain the applicable license and copyright notices when modifying or redistributing the project.