Fuji Compass

Changelog & versions

Matches the version shown at the bottom of the app (e.g. 2.4.3) and the repo’s CHANGELOG.md.

2.4.3 2026-05-19

Highlights

  • Startup display: dark background from the first paint to reduce white flashes on launch (includes native shell updates).
  • Compass & bearing: improved tilt / magnetic / GPS handling, smoother needle motion, and one-tap Mt. Fuji bearing calibration.
  • Large screens: the starry planetarium background no longer disappears on desktop widths.
  • Distance units: fixed km / m switching.
  • Service Worker: cache v93 (adds startup assets such as critical.css).

2.4.0 2026-05-06

Highlights

  • Celestial calibration anchors: Polaris, Moon, and Venus are now selectable as visible-landmark anchors. Options auto-disable based on visibility (night / twilight / below horizon / southern hemisphere).
  • Celestial markers on the compass: in addition to the Sun, Polaris (gentle twinkle), Moon (with phase emoji), and Venus (warm twinkle) are drawn in real time. Needle and Fuji marker remain the visual priority.
  • Shooting star effect (theme): a brief shooting-star animation plays once when you point exactly at Mt. Fuji (on-target) and on calibration success. Honors prefers-reduced-motion.
  • Subtle Milky Way: a faint band overlays at night (sun altitude ≤ −12°), fades through twilight, and disappears entirely during the day.
  • Eight major meteor showers: Quadrantids, Lyrids, Eta Aquariids, Perseids, Orionids, Leonids, Geminids, Ursids. A small banner appears around the peak; the radiant is shown on the compass when above the horizon.
  • Comet slot: a manual data slot for currently-visible comets shows ☄ outside the rim during their viewing windows (data is empty for now and reflects instantly when added).
  • Venus sign-bug fix: Schlyter’s "Sun apparent orbit" elements were being treated as Earth-heliocentric; corrected so that the maximum elongation now lands near its physical ~47°.
  • Service Worker: cache v61. New modules (polaris/moon/venus-position, shooting-star, celestial-decoration, comet-data, meteor-shower) are added to the precached ASSETS.
  • Deploy Xserver resilience: collapsed should-deploy / deploy into a single job to halve the runner footprint and avoid 15-minute waits when GitHub hosted runners are scarce.
  • All platforms aligned to 2.4.0: Web 2.4.0, Android versionCode 24 / versionName 2.4.0, iOS MARKETING_VERSION 2.4.0.

2.3.14 2026-04-30

Highlights

  • Metronome (hybrid timbre unification): the acoustic family (wood / cowbell / drum / hi-hat) now shares one /audio/metronome/base.wav (Kenney UI Audio · CC0) at different playbackRates; the synth family (click / beep / tick) uses built-in synthesized PCM with no HTTP fetch. WAVs trimmed from 7 to 1.
  • Default volume: bumped from 85 to 100 for users without a saved preference.
  • BPM always starts at 100: BPM is no longer persisted; every load begins at 100 (legacy stored values are cleaned up on first run).
  • Service Worker: cache v53; only audio/metronome/base.wav is precached now.
  • All platforms aligned to 2.3.14: Web 2.3.14, Android versionCode 23 / versionName 2.3.14, iOS MARKETING_VERSION 2.3.14 / CURRENT_PROJECT_VERSION 2.3.3.

2.3.13 2026-04-30

Highlights

  • Metronome: Bundled short WAVs from Kenney “UI Audio” (CC0) under /audio/metronome/, loaded via fetch (falls back to synthesized clicks). Credit line in the panel (JA/EN). File mapping in _docs/metronome-samples.md.
  • Service Worker: cache v51; precache metronome .wav files and serve them from cache when offline.
  • Web version label: 2.3.13 (Android versionCode 22 / 2.3.12 unchanged for Play builds).

2.3.12 2026-04-20

Highlights

  • Android Browser Helper 2.7.0, minSdk 23 for review/Vitals; removed extra setDecorFitsSystemWindows in our launcher.
  • versionCode 22 / app 2.3.12; Service Worker cache v27.

2.3.9 2026-04-17

Highlights

  • Restored minSdk 21 and ABH 2.6.2 to reduce Play’s “fewer supported devices” warning (reverts 2.3.8’s ABH 2.7 / min 23).
  • versionCode 21 / app 2.3.9.

2.3.8 2026-04-17

Highlights

  • Android Browser Helper 2.7.0 (Vitals edge-to-edge / WebView fallback improvements). minSdk 23.
  • Edge-to-edge via WindowCompat. androidx.browser 1.10.0.
  • versionCode 20 / app 2.3.8; Service Worker cache bumped.

2.3.7 2026-04-17

Highlights

  • Play stability: WindowCompat.setDecorFitsSystemWindows only on API 35+.
  • Notification delegation off; POST_NOTIFICATIONS removed. Align Data safety in Console.
  • ProGuard keep rules for androidx.core.
  • versionCode 19 / app version 2.3.7; web version label and Service Worker cache name updated.

2.3.6 2026-04-16

Highlights

  • Play review: TWA SCREEN_ORIENTATION set to default to avoid API 26 orientation crashes with translucent activities (Bubblewrap #496). Web manifest stays orientation: any.
  • versionCode 18 / app version 2.3.6; aligned web version label and Service Worker cache name.

2.3.5 2026-04-15

Highlights

  • Play review: ProGuard keep rules for the TWA release build so R8 does not strip Android Browser Helper classes (launch crash fix).
  • Android 8.0 and below: avoid setting screen orientation from code below API 27 (known crash with transparent splash).
  • versionCode 17 / app version 2.3.5; aligned web version label and Service Worker cache name.

2.3.4 2026-03-30

Highlights

  • Bumped Android TWA for Google Play resubmission; aligned displayed app version.
  • Developer checklist for Play Console “recommended” items: _docs/google-play-resubmit-checklist.md in the repo.

2.3.0 2026-03-30

Highlights

  • Japanese / English toggle in the header; first visit follows browser languages (Japanese wins if any ja-* entry exists); choice stored in localStorage. If you have not chosen manually, we may adjust the default using an approximate country code from hosting infrastructure (production on Vercel: /api/locale-hint).
  • English privacy, terms, and this changelog at /privacy/en/, /terms/en/, /changelog/en/. Nav/footer links follow the active language.
  • Noto Sans for English; compass ring and panorama bar tuned for English labels.
  • Service worker precaches i18n bundles and English pages; cache name bumped.

Background

Easier App Review and English-first users for permission copy and legal pages.

2.2.1 2026-03-30

Highlights

  • First visit starts location from an explicit “Start with location” button; return visits can auto-start after opt-in. Shows accuracy and time, with a refresh action.

Background

Web geolocation permission timing varies; we made the flow easier to start and retry.

2.2.0 2026-03-30

Highlights

  • Design tokens for spacing, type, and color. Neutral card borders; compass and bearing bar carry the main hue. Primary CTAs use orange.
  • Cursor rules expanded with UI/UX structure notes.
  • Service Worker cache name updated.

Background

Clarify hierarchy and reduce visual fatigue while keeping the dark PWA baseline.

2.1.0 2026-03-30

Highlights

  • Parallel fast (cacheable) and high-accuracy location reads for quicker first fixes.
  • True-north needle preview until compass is ready; then device-relative motion. Label “True north” when in preview.
  • Modular needle targets, unit tests, and E2E.

Background

Web has stricter permission timing than native apps; we prioritized meaningful bearing first and let compass catch up.

2.0.0 2026-03-30

Highlights

  • Panorama bearing bar (HUD), elevation gauge, Fuji silhouette and sun, Diamond Fuji hints.
  • Split calculation modules with tests; collapsible “how to use” with mascot bubbles.

Background

Richer compass-style info on the web for photography and observation, without crowding the first view.

1.0.0

Scope

Initial major release: bearing, distance, compass, multiple destinations, PWA, privacy policy and terms.