Quick Start

Fumapress turns your Markdown files into a complete docs site on Astro. It is built on Fumadocs and comes with layouts, search, SEO files and plugins. Your content is stored in Astro content collections, and Astro handles routing, builds and deployment.

Creating a Site

Astro needs Node.js 22.23.4 or later.

Create the Project

npm create fumapress -- --framework astro

Start the Dev Server

From the new folder:

npm run dev

The project looks like this:

index.mdx

app.css

content.config.ts

press.config.tsx

astro.config.mjs

Write a Page

Each file under content/ is a page. Add one:

content/hello.mdx

---
title: Hello
description: My second page.
---

## Overview

It is available at `/hello`, and listed in the sidebar.

Learn more in Content.

Name the Site

Set the name in press.config.tsx. It shows in the navbar and page metadata.

press.config.tsx

export default createPress(
  toFumadocsSource(await getCollection("docs"), await getCollection("meta")),
).config({
  site: {
    name: "My Docs", 
  },
});