docs: bring README to v2.1 (Pilo design, partial-economy estimate, fonts)

[aashir-athar]

Updates the README to match the merged v2.1 release: the bold dark+lime Pilo design language, the Manjari + Inter type system, the honest partial-tank economy estimate (odometer ÷ litres, capacity-bounded, confidence band), the robustness pass (migrate seams, debounced reminders, geofence dwell), and the corrected test count (18). Docs-only — no app code changes.

Summary by CodeRabbit

• Documentation
  • Added v2.1 "Pilo" design pass documentation with updated visual and robustness details
  • Enhanced partial-tank economy documentation with confidence metrics
  • Expanded fuel algorithm validation references and analytics descriptions
  • Refreshed Tech Stack table with typography information and Design System section
  • Updated setup, contributing guidelines, and OS-scheduled notification documentation

[coderabbitai]

Lost in the diff? Review this PR in Change Stack to follow the change map from intent to exact ranges.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c821bb45-3873-4f9d-b7b4-b27abaadf19a

📥 Commits

Reviewing files that changed from the base of the PR and between b5d71e6 and 3c6556c.

📒 Files selected for processing (1)

• README.md

---

📝 Walkthrough

Walkthrough

README.md documentation is updated across multiple sections: release notes now include v2.1 "Pilo" design pass details and consistently document an 18-case fuel-algorithm test harness; partial-tank economy receives expanded explanation of capacity-bounded confidence-band estimates; design system section adds typography rules and fonts table; service reminders documentation describes km/day-derived calendar estimation; build and contributing guidelines are refreshed.

Changes

README Documentation and Feature Specification Updates

Layer / File(s)	Summary
Fuel algorithm validation and release notes README.md	Release notes now include v2.1 "Pilo" design pass section with expanded bullet points. Fuel-algorithm test harness documentation is updated from 13-case to 18-case across release notes section, validation reference, and quality gates description.
Partial-tank economy and confidence bands README.md	Partial-tank economy documentation is expanded with capacity-bounded estimate explanation, confidence chips/bands, and tightening bounds as distance grows. Analytics description is updated to mention confidence-band estimated economy for partial-only drivers. FAQ answer elaborates on capacity-bounded behavior when users never brim the tank.
Design system and typography specifications README.md	Tech Stack table gains a dedicated Fonts row specifying Manjari/Inter. Design System section is expanded with clearer visual-language description, font-loading via "hydration gate," and display/body variant typography rules.
Service reminders estimation approach README.md	OS-scheduled notifications documentation is updated to describe calendar-date estimation derived from vehicle km/day rate over the real calendar span, with debounced signature-keyed rescheduling to prevent duplicate alerts.
Build and contributing process updates README.md	Build notes update the app.json bullet to remove the stated version-detail mention, retaining only package/plugin information. Contributing instructions change the base branch from main to master in the branch-off step.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

A rabbit hops through the README ✨
With Pilo's design pass so clean,
Eighteen test cases now, fonts refined,
Confidence bands and km/day aligned— ✓
Fine-tuning docs, one branch at a time! 🐰

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly and concisely summarizes the main change: updating README documentation for v2.1 release, specifically highlighting the three key features (Pilo design, partial-economy estimate, and fonts).
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fuelio-readme-2.1-2026-06-06

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}