Siphon is still in an early stage of development.

Overview

Siphon is a simple web bundler that reads HTML documents and resolves their assets into fewer files for production.

Quick Start

To get started, install Siphon with the node command:

npm install -g siphon-cli

Once it is installed, you can cd into a project folder with an index.html file and run the command:

siphon-cli -bundle index.html

This command will read the file, determine all its required assets, and bundle them up into an index.html file in a build folder.

Watch Mode

Running Siphon in watch mode will set it to automatically bundle up your project whenever changes are made to the base file or its assets.

By default, Siphon assumes your base file is src/index.html, and all your assets are stored in the src folder.

To run Siphon in watch mode, cd to the root of your project and run the command:

siphon-cli -bundle --w

Configuration

You can reconfigure the behavior of the bundler by including a siphon.config.js file in the root of your project.

For example, to change the output directory, create the config file and add:

module.exports = {
  outDir: "./dist",
};

When the bundler is run, it will bundle files into a dist folder, rather than the default build.

For more on configuration, see Siphon Configs.