Manual Installation

This guide creates by hand the files that npm create fumapress generates.

Astro needs Node.js 22.23.4 or later.

Setup

Install Dependencies

npm i @fumapress/astro
npm i @fumadocs/astro astro
npm i @astrojs/react react react-dom takumi-js fumadocs-core
npm i fumadocs-ui@npm:@fumadocs/base-ui

npm i tailwindcss @tailwindcss/vite -D
npm i typescript @types/mdx @types/react @types/react-dom -D

Fumapress uses the Base UI build of Fumadocs UI, installed as fumadocs-ui.

Create the Config Files

// @ts-check
import { defineConfig } from "astro/config";
import tailwindcss from "@tailwindcss/vite";
import press from "@fumapress/astro";

export default defineConfig({
  // the URL of your deployed site, for the sitemap and other full URLs
  // site: "https://example.com",
  integrations: [
    press({
      collections: { docs: { dir: "content" } },
      lastModified: true,
      includeProcessedMarkdown: true,
    }),
  ],
  vite: {
    plugins: [tailwindcss()],
  },
});

The Fumadocs CLI uses the paths alias in the files it copies.

Update package.json

package.json

{
  "type": "module",
  "scripts": {
    "dev": "astro dev",
    "build": "astro build",
    "preview": "astro preview",
    "types:check": "astro sync && tsc --noEmit"
  }
}

Write Your First Page

content/index.mdx

---
title: My Page
description: Hello World
---

## Overview

This is my first document.

Start the Site

npm run dev

Your docs start at /. To keep / for a landing page, give your content a URL prefix.

Manual Installation

SetupCopy Anchor Link

Install DependenciesCopy Anchor Link

Create the Config FilesCopy Anchor Link

Update package.jsonCopy Anchor Link

Write Your First PageCopy Anchor Link