OKF Viewer v0.2.2

OKF Viewer v0.2.2: a big readability release — the graph learns dataviz, the reader breathes on big screens, and the chrome quiets down.

Graph

• Edges carry color. Every link draws in its source concept's color, so cluster fans and hub structure read from the wiring, not just the dots.
• Labels scale with importance. Hubs keep larger labels and hold them longer as you zoom out — a zoomed-out bundle reads as a labeled map instead of anonymous dots — and overlapping labels yield instead of smearing.
• Direction, where you look. Hovering or selecting a concept draws arrowheads on its links, so you can see what cites what; reciprocal links show both ends.
• Cluster gravity. Detected communities gently gather, so the layout agrees with the cluster colors. Tunable via a new "Cluster pull" slider in Controls.
• Fit and zoom glide instead of teleporting (instant under reduced motion), and the advertised + / − / F keyboard shortcuts now actually work.

Reader

• Big displays finally pay off. Prose keeps its comfortable line length, while live examples and token tables break out to the full column width — a design-system preview now renders at near-real page width.
• Section permalinks and the outline work for every bundle. Bodies using OKF's conventional # Section headings now get the outline, scroll-spy, hover permalinks, and working in-page links; the code-copy button on fenced blocks survives too (both existed but never made it to the screen).
• Quieter header. The type/status/tag pill row is now one calm meta line with a single palette dot; status only speaks up when a concept is experimental or deprecated.
• Wide-measure fix. The context rail no longer overlaps the prose when the "Aa" width is set to Wide.

Sidebar & navigation

• The tree follows you. Selecting a concept anywhere — graph, search, a reader link — expands the tree to it and scrolls it into view.
• Folders tell you what's inside: a quiet concept count per directory, and expanding an assets-only folder now says "No concepts in this folder" instead of doing nothing.
• Search dead-ends explain themselves and hand your query to the full-text launcher.

Bundle switcher

• Redesigned rows: labeled "N concepts / M types" meta, last-opened times on recents, and full-path tooltips; the trigger is fixed-width with the app icon as its tile.
• Keyboard fixed: arrow keys no longer skip the first result.

Panels

• The change log is a real timeline — one dot per entry, colored by kind (creation/update/fix/deprecation), and its links now open concepts in-app instead of navigating away.
• Validation issues render as a flat problems list, severity shown once instead of three times per row.

Fixes

• The app can no longer scroll itself out of its own window (a WebKitGTK fractional-scaling quirk let wheel and outline jumps shift the whole chrome).
• Title-bar and graph-toolbar controls no longer overlap at narrow window widths.

Downloads

• Windows: .msi and NSIS .exe
• Ubuntu/Linux: .deb (recommended; uses system libraries) and AppImage (portable)

Unsigned for now, so your OS may show an "unverified publisher" prompt on first launch. Installs of 0.2.1+ can update in place via Settings → Check for updates.

OKF Viewer v0.2.1

OKF Viewer v0.2.1: a new app icon and clearer links in the reader.

Reader

• Links now say where they lead. Before you click, you can tell an in-bundle concept link from a section link (which opens that part of the bundle), an external link (an outbound arrow; opens in your browser), and a broken link (clearly marked and inert). Each carries a hover hint. Section links that previously did nothing now open that part of the bundle.

Brand

• New app icon: a minimal folder with fanned pages, in the app's blue-to-violet on a near-black tile.

Under the hood

• Auto-update is armed. Builds from 0.2.1 onward carry the updater key, so a future release can update them in place (AppImage and Windows).

Downloads

• Windows: .msi and NSIS .exe
• Ubuntu/Linux: .deb (recommended; uses system libraries) and AppImage (portable)

Unsigned for now, so your OS may show an "unverified publisher" prompt on first launch.

OKF Viewer v0.2.0

OKF Viewer v0.2.0 — Design-system rendering, a richer reader, and opt-in auto-update.

The headline change: the reader now renders ODSF design-system bundles. Design tokens show as color swatches, type specimens, and scales; ODSF example assets render as live HTML/CSS previews; token references resolve inline in prose; and the core reads each bundle's companion assets and its odsf_version (shown quietly in the status bar).

Reader

• Syntax highlighting for fenced code blocks (Shiki).
• Bundle images render inline, with click-to-zoom.
• Color swatches inline in prose, not just in code.
• ODSF: design-token swatches, specimens, and scales; live HTML/CSS example previews; resolved token references; linked-stylesheet previews.

App

• Opt-in auto-update via GitHub releases. Install-method aware: AppImage and Windows update in place; .deb users get a hint and a download link, since those updates go through the system package manager.
• Native-feel window controls — flush, full-height caption buttons with pressed states — and a redesigned segmented layout switch.

Core / parsing

• Indentation-aware frontmatter parsing (nested maps and lists).
• An index bullet that links a subdirectory's index.md (foo/index.md) now navigates into that directory, the same as the foo/ form.

Fixes

• Command palette keyboard navigation no longer gets stuck after a press or two.
• Themed scrollbars on dialogs, popovers, and code blocks.

Downloads

• Windows — .msi and NSIS .exe
• Ubuntu/Linux — .deb (recommended; uses system libraries) and AppImage (portable)

Unsigned for now, so your OS may show an "unverified publisher" prompt on first launch.

OKF Viewer v0.1.1

OKF Viewer v0.1.1 — Linux packaging fix.

Same app as v0.1.0; this patch fixes the Linux AppImage, which failed to launch on modern hosts (a glib symbol mismatch and EGL_BAD_PARAMETER) because it was built on an old base and bundled libraries too old for current systems.

• The AppImage is now built on the current Ubuntu LTS, so its bundled libraries match modern systems.
• The .deb continues to build on an older base for the widest compatibility (it links your system libraries — it was already working in 0.1.0).

Downloads

• Windows — .msi and NSIS .exe
• Ubuntu/Linux — .deb (recommended; uses system libraries) and AppImage (portable)

Unsigned for v1, so your OS may show an "unverified publisher" prompt on first launch.

OKF Viewer v0.1.0

OKF Viewer v0.1.0 — first public release.

A local-first desktop app (Tauri 2 + React 19) that points at a folder and renders your Open Knowledge Format bundles as an interactive force-directed graph alongside a reading-first concept reader. Offline, no account, no telemetry — nothing leaves your machine.

Highlights

• Graph view — degree-weighted force layout with Louvain community coloring and a structural-backbone edge filter (so a densely cross-linked bundle reads as clusters, not a hairball), plus an optional GPU (cosmos.gl) renderer and a focus mode.
• Concept Reader — a reading-first pane: centered measure column, a quiet context rail (On-this-page scroll-spy outline, backlinks, relationships, details), GFM callouts, code-copy, and "Aa" reading preferences.
• Native chrome — a custom borderless frame with a left Activity Bar, a window-centered command-center search, and a bottom status bar (quiet conformance indicator, loud only on issues).
• Tolerant OKF consumer — surfaces malformed frontmatter, broken links, and unknown types; never rejects a bundle.

Downloads

Installers are attached below once the release build finishes:

• Windows — .msi and NSIS .exe
• Ubuntu — .deb and AppImage

Unsigned for v1, so your OS may show an "unverified publisher" prompt on first launch.