mikel-press

mikel-press is a static site generator inspired by Jekyll and built on top of mikel, a Mustache-based templating engine. It allows you to generate static websites from HTML and Markdown files using a flexible plugin system.

Installation

To install mikel-press, ensure you have Node.js installed on your system. Then, add this package as a dependency to your project using yarn:

$ yarn add --dev mikel mikel-press

Or npm:

$ npm install --dev mikel mikel-press

Directory structure

A basic mikel-press directory structure looks like this:

.
├── data
│   └── projects.json
├── partials
│   ├── footer.html
│   └── header.html
├── posts
│   ├── 2025-04-03-introducing-our-new-project.html
│   ├── 2025-04-05-how-to-stay-productive.html
│   └── 2025-04-07-understanding-javascript-closures.html
├── www
├── press.js
├── package.json
├── projects.html
├── blog.html
├── about.html
└── index.html

Configuration

mikel-press can be configured using a config object that accepts the following options:

Here is an example configuration object:

import mikel from "mikel";
import press from "mikel-press";

press({
    source: ".",
    destination: "./www",
    template: mikel.create({
        // define your custom helpers and functions here
    }),
    title: "Hello world",
    description: "My awesome site",
    plugins: [
        press.SourcePlugin({folder: "posts", basePath: "blog"}),
        press.PartialsLoaderPlugin(),
        press.DataLoaderPlugin(),
        press.FrontmatterPlugin(),
        press.ContentPagePlugin(),
    ],
});

Content

Variables

Each HTML file processed by mikel-press will be handled by the mikel templating engine, that will provide the following data variables to each page:

Global variables

Site variables

Page variables

Plugins

mikel-press relies on plugins to handle file reading, transformation, and rendering. The following plugins are built-in:

press.SourcePlugin(options)

This plugin reads content from the specified directory and loads it into the system for processing.

Options:

• options.folder (string): Specifies a custom source directory. If not provided, config.source is used.
• options.extensions (array): Defines the file extensions that should be processed. If not provided, it will use config.extensions.
• options.basePath (string): Specifies the base path for the output files.

press.PartialsPlugin(options)

An alias of press.SourcePlugin that will read all files in the partials folder and process them as a partials. The mikel tag {{>file}} can be used to include the partial in partials/file.html.

This plugin accepts the following options:

• options.folder (string): To change the directory to load the partials files. Default is ./partials.
• options.extensions (array): Defines the file extensions that should be processed. If not provided, it will use config.extensions.

press.LayoutsPlugin(options)

An alias of press.SourcePlugin that will read all files in the layouts folder and include them as layouts. In each page, you can use the attributes.layout field to set the layout to apply to this page.

This plugin accepts the following options:

• options.folder (string): To change the directory to load the layouts files. Default is ./layouts.
• options.extensions (array): Defines the file extensions that should be processed. If not provided, it will use config.extensions.

press.DataPlugin(options)

This plugin loads JSON files from the specified directory and makes them available in the site context. This plugin accepts the following options:

• options.folder (string): Specifies a custom source directory for data files. If not provided, ./data is used.

press.AssetsPlugin(options)

This plugin loads additional files (aka assets) and includes them in the build folder. This plugin accepts the following options:

• options.folder (string): Specifies a custom source directory for assets files. If not provided, ./assets is used.
• options.extensions (array): Defines the file extensions that should be processed. If not provided, it will use "*".
• options.exclude (array): Defines the list of file names to exclude.
• options.basePath (string): Allows to specify a base path for the output files.

press.FrontmatterPlugin()

This plugin processes and parses the frontmatter in each file. The parsed frontmatter content will be available in page.attributes field.

press.ContentPagePlugin()

This plugin processes each page using the mikel templating.

press.CopyAssetsPlugin(options)

This plugin copies static files from the source to the destination.

Options:

• options.patterns (array): List of file patterns to copy. Each pattern should have from and to.

API

mikel-press exposes a single function that triggers the build with the given configuration object provided as an argument.

import press from "mikel-press";

press({...});

License

This project is licensed under the MIT License.