PocketFuji Family — UI Normalization Release

PocketFuji (Atari) build 107 · PocketFuji II (Apple II) build 103 · PocketFujiCoco build 106
July 2026

This release brings all three PocketFuji apps into a single visual family. The
CoCo app’s HUD was chosen as the design reference and extracted into a shared
component kit (FujiKitUI) now vendored into all three codebases. Keyboards
are untouched — every platform keeps its own authentic key set and layout.

Shared across all three apps

The family HUD

A consistent top control bar on every app:

Chip-style buttons — icon over a small monospaced label, translucent
rounded chips with color-coded borders: white for neutral controls, green
for input/active, red for reset, pink for quit. All chips keep a 44pt
minimum tap target.
Consistent layout — app version (v1.0 / b###) · machine badge
(COCO3 / APPLE IIE / 800XL etc.) · then the controls.
Overflow “peek” — if the HUD is wider than the screen, it does a
one-time smooth scroll to the end and back shortly after launch, so you
discover the off-screen buttons. Runs once per launch, and only when the
bar actually overflows.
Consistent reset gesture — tap RESET for a warm reset; press and hold
(0.6s, with a heavy haptic) for a full cold reset including a FujiNet-PC
restart.
QUIT chip — pink power button with a confirmation alert; gracefully
stops the emulator and FujiNet before exiting.

FujiNet web configuration (FN chip)

Every app now has an FN button in the HUD that opens the FujiNet-PC
configuration web page (served by the built-in web server on the device).
The web view:

displays in light appearance — the white FujiNet page is never
force-darkened, even though the apps themselves run dark;
closes with the standard sheet swipe (drag indicator shown);
recovers automatically if iOS kills the web content process in the
background (no more frozen white page on return).

Status & diagnostics

The tiny FujiNet status badge was removed from the HUD to reduce clutter —
FujiNet status and console logs live in Settings / the FN panel instead.

Consistent theming

All three apps now run fully dark (black chrome, light status bar) with the
same toast styling for transient messages.

PocketFuji (Atari 8-bit) — build 107

Toolbar replaced with the family HUD: version · machine+RAM badge · SETT ·
GAME/KBD · PAD (when a controller is connected) · PAUSE · MUTE · FN ·
RESET · QUIT.
Reset is now tap = warm / hold = cold — the old reset confirmation
dialog is gone. “Shutdown” moved to the QUIT chip’s confirmation.
The FN web-UI button is now available in release builds (was
debug-only).
The keyboard/joystick toggle is now in the HUD (GAME/KBD chip); the
in-panel toggle still works.
Dark mode is now enforced at the system level, matching the sibling apps.
“Restart Required” banner and cold-reset progress toast restyled to the
family toast look.
Controller fullscreen gameplay layout (landscape) is unchanged.

PocketFuji II (Apple II) — build 103

The minimal top bar (title + three icons) replaced with the full family
HUD: version · APPLE IIE badge · SETT · GAME/KBD · FN · RESET · QUIT.
HUD now shows the real build number — previously stuck at “b1” due to
a version-key wiring bug in the project configuration.
New: QUIT — the app previously had no way to exit cleanly.
Fixed: crash on quit (two distinct crashes):
the audio engine’s realtime thread read a freed native buffer during
teardown (EXC_BAD_ACCESS on AURemoteIO) — audio is now stopped first;
C++ static destructors crashed during exit() (Connection thread join)
— the app now terminates without running them, after the graceful stop.
FN chip opens the FujiNet config web page directly (same view as the
other apps); the FujiNet console log moved to Settings → FujiNet Log.
The keyboard/joystick toggle is now also in the HUD (GAME/KBD chip); the
keyboard’s own JOY key still works. Tap-screen-to-pause is unchanged.

PocketFujiCoco (Color Computer) — build 106

HUD rebuilt on the shared FujiKitUI components (no visual change — this
app is the family design reference).
New: FN chip opens the FujiNet-PC configuration web page — the CoCo
app previously had no way to reach it. The web UI page assets are now
bundled and installed to existing devices automatically on next launch.
FujiNet status badge removed from the HUD (still shown in Settings →
FujiNet Diagnostics, alongside the console log).
Includes the CM–8 monitor bezel display option (settings toggle +
bezel artwork).

For developers

Shared UI lives in __PocketFuji__/FujiKitUI/ (canonical) and is vendored
into each repo via ./sync-fujikit.sh; each repo still builds standalone.
Edit the canonical copy, sync, then xcodegen generate per app.
Version numbers: Apple II and CoCo drive CFBundleVersion from
CURRENT_PROJECT_VERSION in project.yml; Atari uses the literal value
in iOS/PocketFuji/Info.plist.
Full normalization plan and decisions: __PocketFuji__/ui-normalization-plan.md.
Deferred to a future release: sharing the CoCo FujiNet log viewer across
all three apps; wiring Atari’s version to $(CURRENT_PROJECT_VERSION).

PocketFuji – The UI Reunion