v0.1.0

Highlights

Initial release of Alloy, a fast, extensible static site generator written in Go.

Features

  • Config: Customize your project structure, build output, content formats, and plugin settings in YAML, TOML, or JSON

    title: "My Site" baseURL: "https://example.com" structure: content: "src/content" layouts: "src/layouts" templates: engine: "liquid"

  • Content: Write pages in Markdown or plain HTML with YAML frontmatter

  • Data: Load YAML, JSON, and CSV data files, available globally in templates as site.data

    data: files: authors: "data/authors.json"

  • Cascade: Inherit layout, metadata, and configuration down the directory tree via _data.yaml files with deep merge

  • Permalinks: Control output URLs per-collection with token-based patterns

    permalinks: blog: "/:year/:month/:slug/"

  • Collections: Group content and generate taxonomy pages

    taxonomies: tags: permalink: "/tags/:slug/" collections: blog: sortBy: "date" order: "desc"

  • Templates: Liquid and Go html/template engines with shortcodes, filters, and composable layouts

  • Output: Generate sitemaps, feeds, and multiple output formats per page

  • Assets: Process assets through the build pipeline with built-in cache-busting support

  • Static: Copy static files with passthrough mappings and glob-based exclude patterns

    passthrough: - from: "node_modules/@rhds/elements" to: "assets/vendor/rhds" exclude: ["*.map"]

  • Pagination: Paginate collections with configurable page size and custom permalink patterns

  • i18n: Build multilingual sites with per-language content directories, URL prefixing, and translation strings

    languages: en: title: "English Site" root: true fr: title: "Site Français"

  • Pipeline: Incremental rebuilds that only reprocess changed files

  • Plugins (QuickJS): Drop a JS file in plugins/ for in-process filters, hooks, and shortcodes. No Node.js required

    export default function(alloy) { alloy.shortcode("greeting", (args) => { return `<p>Hello, ${args[0]}!</p>`; }); }

  • Plugins (WASM): Compile filters from Rust, TinyGo, or AssemblyScript for near-native performance

  • Plugins (Node): Opt into a full Node.js subprocess runtime for plugins that need npm packages or filesystem access

  • Hooks: React to build lifecycle events and inject virtual pages

    alloy.hook("onContentLoaded", { pages: true }, (pages) => { // inject virtual pages, transform content, etc. });

  • CLI: alloy build, alloy dev (development server with file watcher and live reload), alloy serve, alloy init, and alloy version