This guide walks you through setting up a functional MoPress documentation site in minutes using Book Mode—no coding required.
You can install MoPress through any of the following methods:
Requires the MoonBit toolchain:
moon install himeno/mopress
mopress version
Precompiled binaries for Windows are available on GitHub Releases. Download, extract to your preferred directory, and add it to your system PATH.
Requires the MoonBit toolchain, Bun (or Node.js), and Just:
git clone https://github.com/biyuehu/mopress.git
cd mopress
moon update
just prebuild
moon build --release
The resulting executable will be located at _build/native/release/build/mopress.exe.
Run the following command in a new directory (or provide a directory name like mopress init my-book):
mopress init
This scaffolds:
The core configuration file:
sena.tomlNavigation catalog:
SUMMARY.mdStarter document:
index.mdEssential asset directories:
templates/,styles/,scripts/, andplugins/
Directory structure:
├── sena.toml
├── index.md
├── SUMMARY.md
├── templates/
│ └── default.html
├── styles/
│ └── index.css
├── scripts/
│ └── main.js
└── plugins/
├── runtime/
├── preprocessors/
│ └── github-alert.ts
└── transformers/
Create or edit ./index.md:
---
title: Hello World
---
# Hello, MoPress
Welcome to your first documentation page generated with MoPress!
Organize your sidebar table of contents in ./SUMMARY.md:
# Summary
- [Home](./index.md)
Note
`SUMMARY.md` defines the navigation structure (sidebar hierarchy, breadcrumbs, and previous/next page links). All `*.md` and `*.markdown` files located within the source directory will be compiled into HTML pages.
mopress build
The compiled static HTML, CSS, JavaScript, and assets will be output to the directory configured in sena.toml (defaults to ./dest).
mopress serve
This launches a local development server with built-in live reloading, so you can preview changes in real time.