OBC OpenBikeComputer / log
← Expedition log

The site has a log now

· 1 min read

The docs explain how OpenBikeComputer works. What they can't hold is the story of building it — the milestones, the detours, the parts that arrived bent. That's what this log is for: short entries from the workbench, written as things happen.

A route over contour lines — the demo art for this first entry

What an entry can do

Entries are plain markdown files in the repo, one folder per post with its images sitting right next to the text. The renderer is the same tiny stdlib-only Python that builds the docs, so nothing about publishing changed — push to main and CI ships it.

Every image opens in a lightbox (click the map above — scroll zooms, drag pans). And for the kind of change that's hard to describe in words, there's a slider:

Rev ARev B
Drag the handle — placeholder art standing in for a real before/after.

CAD parts you can grab

The bit I'm most pleased with: entries can embed models straight from the CAD export. A small host-side tool converts a STEP file to GLB once, and the page gets an orbit viewer — hand-rolled WebGL, a few KB, no engine dependency.

drag to orbit · click + scroll to zoom · double-click to reset
A placeholder case, standing in until the real enclosure is ready to show.

When there's a real enclosure to show, the same block will carry a Download STEP button next to it, so you can pull the part into your own CAD.

Following along

There's an Atom feed if you want entries delivered, and the docs remain the place where the concepts live. See you out there.