English / 简体中文
Bocchi is a personal homepage/blog system shaped by the author's tastes and preferences, with solid compatibility and extensibility.
Key features:
- Static site: Deploy to Nginx, GitHub Pages, Cloudflare Pages, and other static hosts—minimal ops overhead and cognitive load.
- Markdown-first content: Portable, easy to migrate, and cross-platform friendly.
- Full admin backend: Run on a home server or private lightweight host for complete content management and publishing.
- Modular frontend: Build frontend themes your way, or use the default theme template.
The project is in early development:
- Runnable for early preview and experimentation.
- Stability is not guaranteed; future version compatibility is not guaranteed.
- Full data compatibility with future versions is not guaranteed.
Bocchi Home Server is meant to run on a home server, NAS, personal VPS, or similar. It includes an admin panel and is not designed to be exposed directly to the public internet. Once Home Server is deployed, you can use Bocchi's full feature set.
Download stable Bocchi Home Server binaries from GitHub Releases and run them. No database, SDK, or runtime dependencies required.
TODO Documentation to be added
You can fully define your site's look, interactions, and how content is presented—on your own or with help from an AI agent.
TODO Documentation to be added
Todo
Bocchi Home Server
- .NET 10 (dotNet 10) / ASP.NET Core
- Entity Framework Core + SQLite
- Blazor Server
- ASP.NET Core Identity / OpenID Connect
- Vite + TailwindCSS v4
Bocchi Cloud Server
- Hono / TypeScript (placeholder, not yet implemented)
Bocchi Mono (default frontend theme)
- Template engine: Liquid
- Web Components
- Native JavaScript / CSS
Bocchi uses the following third-party libraries and toolchain components:
- Vite (MIT License): frontend asset build tool for Home Server.
- YamlDotNet (MIT License): YAML parser (Markdown frontmatter, etc.).
- Markdig (BSD-2-Clause): Markdown parsing.
- Serilog (Apache-2.0): logging for Home Server.
- Blazicons.Lucide (MIT License): icon library for the Home Server admin panel.
- LibGit2Sharp (MIT License): Git operations for content directory management.
- Fluid (MIT License): template rendering for one of the built-in base theme approaches.
- TailwindCSS (MIT License): CSS framework for the Home Server admin panel.
- CodeMirror (MIT License): Markdown editor for the Home Server admin panel.
TODO