Fumapress is a highly customizable and composable site generator designed to help users build feature-rich content sites, blogs, and API documentation with minimal effort. It is built upon the robust foundations of Fumadocs and Waku, combining powerful content management features with the performance and developer-friendly environment of a modern React-based framework. By offering a structured yet flexible approach, Fumapress allows developers to transition seamlessly from simple content projects to full-scale applications without requiring extensive migration efforts. The tool manages routing and content structure in an opinionated fashion while remaining accessible to those who prefer configuration-driven workflows over complex boilerplate code. At its core, Fumapress follows an everything-is-a-plugin architecture, ensuring that the application footprint remains lightweight and only grows as specific features are integrated.

The functionality of Fumapress centers on turning Markdown and MDX content into professional, performant websites. It provides built-in support for essential documentation features, including automatic sidebar generation, page trees, and navigation. Because it is powered by the Waku framework, it leverages modern React server components and Vite, ensuring fast build times and a smooth development experience. Users can define site-wide layouts, internationalization settings, and metadata through a type-safe TypeScript configuration file, making it easy to maintain consistent design and behavior across various content sections. The system handles both static and dynamic routes, and can be configured to produce entirely static builds suitable for deployment on global content delivery networks.

Some of the key features are:

• Plugin Ecosystem: Easily add capabilities like search, blog support, LLM content indexing, and Open Graph image generation via a composable plugin system.
• Flexible Layouts: Choose from built-in Docs, Notebook, and Home layouts, or create custom renderers that switch layouts based on page paths.
• Internationalization (i18n): Built-in support for multilingual content through easy-to-configure language packs and file-based localization.
• TypeScript-first Configuration: Benefit from a strictly typed configuration system that simplifies site management and provides great IDE support.
• Waku Integration: Leverage Waku's high-performance routing and server components for seamless page generation and optimized performance.
• Styling Customization: Full control over Tailwind CSS integration, allowing for easy color, typography, and layout adjustments to match brand requirements.
• File-based Routing: Utilize both file-system-based routing for custom pages and content-based routing for documentation documentation, providing the best of both worlds.

Fumapress is operated through a standard Node.js environment, allowing users to initialize new projects quickly via CLI commands. Once the application is generated, developers define the site behavior and plugins in a central configuration file. Content is then authored in Markdown or MDX files stored within a dedicated directory structure. The integration with Vite ensures that hot module replacement is available during local development, while production builds are optimized for high-speed delivery. Customization is handled by modifying configuration files or creating dedicated UI layouts that wrap content pages, and developers can further extend the system by implementing custom middleware or server-side functions using the underlying Waku router.

Some common use cases include:

• Documentation Hubs: Creating technical documentation sites that require navigation, search, and table of contents.
• Personal Blogs: Building polished, performant blog platforms with support for tagging and content collections.
• API Documentation: Leveraging the platform to showcase technical APIs and integration guides with specialized layouts.
• Marketing Sites: Deploying content-heavy marketing pages that share the same design language as technical documentation.