fddl

1 min read

Getting Started with fddl

From zero to deployed in under five minutes.

Getting Started

Welcome to the documentation for fddl. This guide will help you set up your first static site.

Installation

Currently, fddl is distributed as a Swift package. You can build it from source:

git clone https://github.com/aviatorcards/fddl.git
cd fddl
swift build -c release

The executable will be located in .build/release/fddl.

Project Structure

A typical fddl project looks like this:

  • contents/: Your markdown files.

  • templates/: Your HTML views and configurations.

  • output/: The generated static files (don’t edit these!).

Your First Build

To generate your site using the default template, simply run:

./fddl

Or specify a template:

./fddl --template default

Build System & Versioning

Every site generation is automatically trackable. fddl generates a unique Build ID and captures the current Git Commit Hash to ensure you always know exactly which version of your code produced which version of your site.

These variables are exposed via:

  • 09A486B3-9D5B-4E8E-8C24-61507010C9C9

  • 1709cb6

  • Jan 17, 2026 at 10:42 PM

Next Steps