Skip to content

Vefna v1.0.0

Choose a tag to compare

@torvik-lang torvik-lang released this 19 Jul 00:23
· 11 commits to main since this release
Immutable release. Only release title and notes can be modified.
41c637e

Vefna is a static site generator written entirely in Torvik — Markdown in, HTML out, one compiled binary with no runtime and no dependencies. This is its first release, built with Torvik v1.3.0, and it's also the flagship showcase for what v1.3.0's concurrency can do.

(VEF-nah — coined from the Old Norse vefa*, "to weave," and* vefr*, "web." The Norns weave the threads of fate; Vefna weaves only web pages, which is safer.)*

🕸 What it does

vefna new myblog
cd myblog
vefna build

Your site is in site/ — plain files, ready for GitHub Pages, Cloudflare Pages, Netlify, or any web server.

  • A pragmatic Markdown subset — headings, paragraphs, bold/italic/inline code, links, images, ordered and unordered lists, blockquotes, fenced code blocks with language classes, horizontal rules. All output HTML-escaped.
  • Front matter — title, description, author, date, template between --- fences, with site-wide fallbacks from one vefna.site config.
  • Plain HTML templates with {{slot}} placeholders and per-page template selection.
  • Incremental builds — a page reweaves only when its source, a template, or the config is newer than its output. --clean rebuilds everything.
  • Deterministic output — the same inputs produce a byte-identical site, every build, on every platform.
  • static/ assets copied binary-safe with the same incremental logic, folder structure carried straight through.

🐦‍⬛ Woven in parallel

Pages render on eight raven worker threads fed by typed bridge channels — Torvik v1.3.0's concurrency, doing real work. On modest hardware Vefna weaves 500+ pages in ~60 milliseconds. Safe by construction: the workers share no mutable state, so there is no way to write a data race in the build pipeline.

✅ Tested

A 21-case suite runs on both platforms: CLI surface, golden-file output comparison, incremental rebuild behavior, determinism (two clean builds diff byte-identical), a binary round-trip fixture containing all 256 byte values, and error paths. Green on Linux and Windows before this release was cut.

Install

Linux

curl -fsSL https://raw.githubusercontent.com/torvik-lang/vefna/main/linux/install.sh | sh

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/torvik-lang/vefna/main/windows/install.ps1 | iex

Or grab a binary below and put it on your PATH — Vefna is a single file. Pin a version with VEFNA_VERSION=1.0.0 (Linux) or $env:VEFNA_VERSION = "1.0.0" (Windows) before running the installer.

See it woven

The Torvik website is built with Vefna — the tool's own homepage is its demo. Full command reference, template slots, Markdown notes, and hosting tips are in the README; what's coming next (a vefna serve preview server, collections, tags, feeds) is in the ROADMAP.

Binaries for Linux x86-64 and Windows x86-64 are attached below.

One binary. Markdown in, site out, in parallel — written in Torvik, proving Torvik.