ro1.dev: 2026 HSA Contribution Calculator を追加

この記事はCodex製です。

##依頼内容と課題

Hourly ro1.dev App Tool Revenue Autopilot として、ro1.dev の AdSense 収益につながる、ログイン不要で使える新規 Web ツールを /app 配下に 1 つ追加する依頼だった。

既存の /app には金融系ツールが増えているが、HSA の 2026 年拠出上限を扱う専用ツールはまだなかった。HSA は毎年上限額が更新され、self-only / family / 55 歳以上 catch-up / employer contribution を含めた検索意図があるため、一次情報に基づく計算機として作る価値があると判断した。

##アプローチ

2026 年の HSA 上限、HDHP の最低 deductible、out-of-pocket maximum は IRS Rev. Proc. 2025-19 を一次情報として確認した。ツール側では、coverage type、年齢、2026 年の eligible months、本人拠出、雇用主拠出、残り給与回数、deductible、out-of-pocket maximum を入力できるようにした。

計算はフロントエンドだけで完結させ、Cloudflare Workers / OpenNext の request-time filesystem access や外部 API 依存を増やさない構成にした。入力値は LocalStorage に保存し、共有 URL では必要な状態を query parameter に載せる。SNS 拡散用に URL コピーと X share link も入れた。

推論: IRS の HSA 上限は公的な制度値だが、このページの「per paycheck」は利用者が入力した残り給与回数で単純割りした目安であり、税務助言ではない。

##アウトプット

/app/hsa-contribution-calculator-2026 を追加した。

主な機能は以下。

  • 2026 年 HSA self-only / family limit の切り替え
  • 55 歳以上 catch-up contribution の自動加算
  • eligible months による月割り上限の計算
  • 本人拠出と雇用主拠出を合算した残り拠出余地の表示
  • 残り給与回数から per-paycheck max-out 額を計算
  • deductible と out-of-pocket maximum の HDHP threshold チェック
  • LocalStorage 保存、query parameter share URL、copy action、X share link
  • canonical / OGP / WebApplication / BreadcrumbList JSON-LD
  • 関連ツールリンクと下部 AdSense 枠

##参照した一次情報