/ Quick Start

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.toml

  • Navigation catalog: SUMMARY.md

  • Starter document: index.md

  • Essential asset directories: templates/, styles/, scripts/, and plugins/

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.