haleiki 0.0.1

A wiki-like markdown- and git-powered tool for structured knowledge
haleiki-0.0.1 is not a library.

Haleiki

House of Knowledge · For read-only knowledge-sharing

Haleiki (hale "house" + ʻike "knowledge," Hawaiian) is a static-site knowledge base framework — a beautifully designed, searchable, interlinked wiki for structured knowledge. No logins, no edits, no comments. Content goes in as source pages and concept cards; a navigable knowledge base comes out.

Closer to an encyclopedia than a wiki in philosophy. Closer to a wiki than an encyclopedia in navigation.

How It Works

Haleiki has a four-layer pipeline:

  1. Authoring — Write source pages in Markdown. Concept cards are extracted from them (AI-driven, using the NeON-inspired Oxur Fabryk (v3) ontological methodology), merged, and linked.
  2. Pre-build (Rust CLI) — Parses all content, builds a unified relationship graph, validates references, computes derived data (see-also groups, breadcrumbs, prerequisite chains, category indices), and writes graph-derived JSON.
  3. Build (Cobalt) — Reads source pages, concept cards, and graph data. Applies Liquid templates. Outputs a static HTML site.
  4. Runtime — Static files only. HTML, CSS, JS, and a search index. Zero server logic.

Content Model

Two first-class page types, both full wiki citizens:

  • Source Pages — Authored Markdown (guides, tutorials, essays, reference). Published as-is. Also serve as raw material for concept extraction.
  • Concept Cards — Atomic knowledge units with structured frontmatter: typed relationships, provenance, competency questions, aliases, classification.

Quick Start

# Scaffold new content
haleiki new source "Understanding Ownership in Rust"
haleiki new concept "Ownership"

# Build
haleiki build && cobalt build && npx pagefind --site _site

# Dev (serve + watch)
haleiki dev

Design

Warm/cool dual-theme aesthetic built on a semantic design token architecture. DM Sans for headings, Source Serif 4 for body prose, IBM Plex Mono for code. OKLCH color throughout. Fluid typography and Every Layout compositional primitives — zero media queries for layout.

Project Status

Early development. See the architecture document for the full design and phase plan.

License

Licensed under either of Apache License, Version 2.0 or MIT License, at your option.