Cactus

screenshot of Cactus

A composable static site generator

Overview

Cactus is a unique composable static site generator that aims to provide flexibility through its minimalistic approach. Unlike many other static site generators that impose strict structures, Cactus allows users to control their projects with ease. Just by placing a cactus-project file in the root directory, Cactus automatically identifies site files and compiles them into a structured website. The simplicity of this tool makes it an appealing choice for both new and experienced developers who want to craft their websites without unnecessary complications.

The process of getting started with Cactus is refreshingly straightforward. It efficiently compiles Markdown into HTML and allows for a clear directory structure, making it easy to manage and serve content. Whether you plan to deploy on platforms like S3, GCS, or GitHub Pages, Cactus offers the flexibility to support various hosting solutions.

Features

  • Minimal Setup: Just create a cactus-project file in the root directory to get started; Cactus will handle the rest.
  • Automatic Site File Detection: Cactus scans the project folder for site files, enabling quick compilation into a website without manual configuration.
  • Easy Templating: Customize your site by specifying a template in your site file, which can wrap all Markdown files with common HTML elements.
  • Asset Management: Utilize the (assets...) rule to automatically copy supporting files into your compiled site, streamlining the management of assets.
  • Simple Folder Structure: The compiled website maintains the original tree structure under a _public folder for ease of deployment.
  • Flexibility in Deployment: Supports various hosting options, allowing you to upload your site wherever you prefer.
  • Example Folder: An included example folder showcases all features effectively, serving as a helpful resource for new users.