biketools.cc

Changelog

Reverse-chronological. Dates are when changes shipped to production.

2026-05-20 — Frame Geometry Comparator shipped

The third tool is live. Overlay up to three frame geometries as side-view technical drawings on a single shared coordinate system, with every measurement and delta in a comparison table below.

  • Live tool: Frame Geometry Comparator
  • Methodology at /docs/methodology/geometry-comparator.md — pinned conventions for the contested measurements (effective vs. actual STA, top tube; BB drop vs. height; standover) plus the Trail / front-center / wheelbase derivations
  • Curated 3-frame seed database (Tarmac SL8, Roubaix SL8, 3T Exploro Race), each with 4 sizes and a cited manufacturer source. Contributors extend via PR — see /docs/contributing-frame-data.md
  • Pan, zoom (wheel + buttons + pinch), hover thickening, click a dimension label to flash the matching table row
  • Inputs per slot: pick from the database, or enter geometry manually. Edit toggle keeps cards calm by default
  • Copy CSV / Copy Markdown exports the comparison table
  • ADR-007 adds --color-tertiary (muted steel blue) for the third comparison item — constrained to this use case

2026-05-20 — Gear Ratio Calculator — compact two-zone layout

Layout rework on top of yesterday's comparison redesign. The page is now two zones: a full-width gear ladder at the top that overlays every drivetrain on a single shared gain-ratio axis, and a wrapping grid of self-contained drivetrain cards below. Each card carries its own inputs (behind an Edit toggle), summary chips, jump chart, and per-gear details — no more separate inputs sidebar or comparison-summary table.

  • Updated tool: Gear Ratio Calculator
  • New gear-ladder visualization makes "which drivetrain gives me the easiest climbing gear / the highest top speed / the closest match to my current ratios?" answerable at a glance
  • ToolLayout gains a layout="stacked" mode; Tire Pressure unchanged
  • URL schema unchanged

2026-05-19 — Gear Ratio Calculator redesigned for comparison shopping

Real-world usage is drivetrain shopping: "should I upgrade, and which option is better?" The tool now compares up to four drivetrains side by side, focused on the three questions that drive the call — easier climbing gear, hardest gear (top speed), and the smoothness of cassette progression. The per-gear detail is still one click away in a <details> per drivetrain.

  • Updated tool: Gear Ratio Calculator
  • Replaces the cadence-vs-speed line chart with a summary table on top plus a per-drivetrain horizontal bar chart of cassette cog-to-cog jumps. Big jumps (>12%) render in the vermillion accent
  • New math: cassetteJumps(cogs) and summarizeDrivetrain(d) with 9 new unit tests (suite total 158)
  • URL-schema change — share links use dn, d{i}_cr, d{i}_cs, d{i}_w, d{i}_cl, d{i}_n. Older a_* / b_* / cmp links no longer hydrate

2026-05-19 — Silca method added to Tire Pressure

A fifth method joins the Tire Pressure Calculator: Silca, a reverse-engineered implementation of the Silca Pro Tire Pressure Calculator. Where our existing "Impedance" method is a generic Berto-baseline approximation of Silca's published principle, this one is the actual closed-form derivation.

  • Updated tool: Tire Pressure Calculator
  • Methodology: /docs/methodology/tire-pressure.md §5 Silca with the full constant tables and the derivation rules for our existing inputs (speed and wheel diameter are defaulted; the rest mapped directly)
  • Surfaces Silca's pinch-flat energy balance as a note on the row when risky, plus its 70 psi hookless caution
  • 25 new unit tests

2026-05-19 — ENVE method added to Tire Pressure

A fourth method joins the Tire Pressure Calculator: ENVE, based on the published 2026 ENVE tire-pressure charts (Road / Gravel / Mountain). Unlike the proprietary brand calculators we deliberately don't reproduce, ENVE publishes their full tables — so we encode them verbatim and look up values directly. Tubeless only.

  • Updated tool: Tire Pressure Calculator
  • Methodology: /docs/methodology/tire-pressure.md §ENVE, with the three 2026 chart image URLs cited as the source
  • 24 new unit tests, ~50 chart columns encoded
  • Lookup snaps to the nearest rim/tire bucket; out-of-chart inputs flagged as extrapolated

2026-05-19 — Tire Pressure Calculator shipped

The second tool is live. Configure rider, bike, tire, rim, surface, and tubeless/hookless state; see front and rear pressures computed under three published methods (Berto, Modern impedance-aware, Heine philosophy). Hand-coded tire cross-sections show the deformation difference between front and rear; analog pressure gauges display the recommended values. Hookless rims are capped at the 72.5 psi / 5 bar ETRTO ceiling with visible warnings.

  • Live tool: Tire Pressure Calculator
  • Methodology: /docs/methodology/tire-pressure.md on GitHub — three methods, each honestly attributed to published research; no brand calculator reverse engineering
  • 28 new unit tests, 4 worked examples encoded as test fixtures

2026-05-19 — Gear Ratio Calculator shipped

The first tool is live. Configure one or two drivetrains, see every gear's ratio, gain ratio, development, gear inches, and speed at a reference cadence. The cadence-vs-speed chart is interactive — hover or tap to see exact values at any cadence across every gear. URL captures the full configuration for sharing.

  • Live tool: Gear Ratio Calculator
  • Methodology: /docs/methodology/gear-ratio.md on GitHub
  • 43 new unit tests, 7 drivetrain presets, 14-entry curated cassette database, 25-entry wheel circumference table
  • Hand-coded responsive SVG chart with vertical-cursor hover and per-gear floating labels

2026-05-19 — Foundation launched

The site itself. Design system, layout primitives, UI primitives, brand mark, tool registry, content pages, command palette, dark mode. Seven tool placeholders registered — each currently renders a Coming Soon page linking back here.

  • Design system: Fraunces / Inter / JetBrains Mono, paper-and-ink palette with vermillion accent, hairlines instead of shadows
  • Layout primitives: Stack, Cluster, Center, Sidebar, Switcher, Frame, Cover (every-layout.dev style)
  • UI primitives: Button, Input, NumberInput, Select, Field, Card, Table, Tag, Kbd, ThemeToggle
  • Command palette: cmdk + Radix Dialog, ⌘K binding, recents in localStorage
  • Documentation: project constitution (CLAUDE.md federation), /docs (brand, design system, voice, architecture, methodology, adding-a-tool), six ADRs
  • Open source: MIT, contribution guidelines, issue and PR templates, CI on every push

Coming next

In planned order:

  • Frame Geometry Comparator — overlay any two geometries.
  • Tire & Rim Compatibility — ETRTO compliance, hookless ceilings.
  • Chainline & Q-factor Calculator — drivetrain alignment.
  • Fit Finder — body measurements → recommended geometry.
  • Fit Translator — transfer a known fit between bikes.

Parked (v2 ideas)

  • Spoke Length Calculator
  • Drivetrain Compatibility Checker
  • Climb Time Estimator