docs: align screen lifecycle docs with single-GenServer navigation - #76

Draft

minibikini wants to merge 293 commits into

GenericJam:masterfrom

minibikini:fix/doc-lifecycle-single-genserver

This pull request is big! We're only showing the most recent 250 commits

Commits on May 14, 2026

issues: #18 expanded to cover Rustler path; verified Rust on iPhone
GenericJam
committed
ad4c3d6
issues: #18 NIF source auto-wiring FIXED (iOS) + Android follow-up
GenericJam
committed
44f2e45
issues: #15 — Zigler 0.16 host-dev fork landed; iPhone path still pending
GenericJam
committed
080e620
issues: #15 — iOS Zigler foundation landed, isysroot blocker documented
GenericJam
committed
42b4879
issues: #15 — Zigler iPhone deploy FIXED via fork (verified end-to-end)
GenericJam
committed
30a796e
issues: file #19 — Android NIF auto-wiring (port the iOS work)
GenericJam
committed
5b2ce5a
nif_future + nif_stub_test: catch up with merged iOS wheel-copy fix
GenericJam
committed
34f50ee
driver_tab_ios.zig: handle emlx_static alongside sqlite_static

GenericJam
and
claude
committed
935e355
deps: add ex_slop Credo check for AI-generated Elixir patterns

GenericJam
and
claude
committed
862d78b
docs(CLAUDE.md): note ExSlop runs alongside mix credo --strict

GenericJam
and
claude
committed
a2f562d
refactor: ex_slop mechanical wins in mob

GenericJam
and
claude
committed
000ff86
AGENTS.md: add "Don't write this slop" — write-time guidance

GenericJam
and
claude
committed
301e90b
bump: erlang 29.0-rc3 → 29.0, elixir 1.20.0-rc.4 → 1.20.0-rc.5

GenericJam
and
claude
committed
69acd76
Mob.VendorUsb: port the Android NIF surface to Zig (closes mob#6)
GenericJam
committed
5d0a52d
lint: clang-format pass on native sources
GenericJam
committed
3016bb7
0.6.0
GenericJam
committed
e7f362f
guides/native_extensions.md: summary of mob.enable + mob.add_nif
GenericJam
committed
67471f8
Mob.DNS.configure_pure_beam/1 — pure-BEAM DNS as default for iOS
GenericJam
committed
2ba1cad
0.6.1
GenericJam
committed
b48d993
docs(permissions): new guide + per-module cross-refs; iOS location honest
GenericJam
committed
79bd96a
Merge docs/permissions-guide — permissions guide + honest iOS location
GenericJam
committed
577bc42

Commits on May 15, 2026

Mob.Camera: live frame stream + shared AVCaptureSession
GenericJam
committed
7d3f315
Mob.Bt: Bluetooth Classic peripheral (HFP/SPP/HID)
HeroesLament
committed
8ce0c42
Merge pull request #10 from GenericJam/live-camera-frames
GenericJam
authored
31d2e99
0.6.2
GenericJam
committed
6e1e122
camera: rotate session to portrait so YOLO sees an upright scene
GenericJam
committed
928a8dc
Merge pull request #11 from GenericJam/camera-portrait-rotation
GenericJam
authored
e9796f8
0.6.3
GenericJam
committed
ba82c87
Mob.Bt review fixes: drop Jason runtime dep, dedupe encoders, add tests
GenericJam
committed
3398c4e
Merge pull request #9 from HeroesLament: Mob.Bt — Bluetooth Classic peripheral
GenericJam
committed
c8e95c4

Commits on May 16, 2026

0.6.4
GenericJam
committed
9c93d24
Mob.GpuView: Metal fragment-shader surface (iOS)
GenericJam
committed
c0eefbf
MobGpuView: wrap long swiftlint line in the fragment_main error message
GenericJam
committed
fb1ddfc
Mob.GpuView: whitelist <GpuView> tag for Android
GenericJam
committed
9857a94
Merge gpuview-ios-rebase: Mob.GpuView (iOS Metal fragment-shader surface)
GenericJam
committed
6be1ce6
mob_nif.zig: use enif_make_list_from_array for empty BT paired list
GenericJam
committed
def5378
PLAN.md: add CI + integration-test plan (3 layers)
GenericJam
committed
a80408e
ci+docs: add tests + release workflows, CHANGELOG.md, fix HexDocs source links
GenericJam
committed
edf0299
0.6.5
GenericJam
committed
e237b7c
release.yml: add hex_publish job gated on HEX_API_KEY secret
GenericJam
committed
0f1997a
ci: unblock test.yml — credo + mix_audit fixes
GenericJam
committed
9276e84
ci: run erlfmt under MIX_ENV=dev (the dep's only: :dev)
GenericJam
committed
b863964
ci: remove onboarding.yml — running these locally instead
GenericJam
committed
bba3b5d
release.yml: fix tag pattern — glob, not regex
GenericJam
committed
59338d2
release.yml: drive from mix.exs version, drop the manual tag step
GenericJam
committed
2c4c769
ci: per-step idempotency so re-runs back-fill missing pieces

GenericJam
and
claude
committed
3c89222
Mob.Camera: Android frame stream — CameraX ImageAnalysis path
GenericJam
committed
bc0f24f
Release flow standardisation: RELEASE.md + pre-push hook

GenericJam
and
claude
committed
d297fe0
Bump to 0.6.6 — release-flow docs + when-to-bump policy

GenericJam
and
claude
committed
6129f29
RELEASE.md: document mix docs preview + automatic hexdocs publish

GenericJam
and
claude
committed
848014e

Commits on May 17, 2026

Mob.Canvas: document the viewport-scaling contract
GenericJam
committed
a88135e
MOB_PLUGINS.md: plugin manifest schema spec

GenericJam
and
claude
committed
e7b6402
Bump to 0.6.7 — Mobile Surface Matrix + plugin spec ride-along

GenericJam
and
claude
committed
b974398

Commits on May 18, 2026

Fix: button tap target now covers the full padded area (iOS)

GenericJam
and
claude
committed
8d8db15
Merge: Android camera frame stream + canvas viewport docs
GenericJam
committed
c408e00
Bump to 0.6.9 — unblock CI so 0.6.8's camera/canvas work ships to Hex

GenericJam
and
claude
committed
bf79d65
ios mob_beam.m: honour MOB_NODE_SUFFIX env var

GenericJam
and
claude
committed
150281c
Bump to 0.6.10 — iOS BEAM honours MOB_NODE_SUFFIX
GenericJam
committed
6ef6986

Commits on May 19, 2026

Mob.Sigil: utf8_string preserves non-ASCII bytes in templates

GenericJam
and
claude
committed
5a0a5eb
Merge: ~MOB sigil UTF-8 fix
GenericJam
committed
e671f15
Bump to 0.6.11 — ~MOB sigil UTF-8 round-trip fix

GenericJam
and
claude
committed
d582584
Mob.Theme: glass flag + Liquid Glass on iOS 26

GenericJam
and
claude
committed
fac4564
Merge: Mob.Theme glass flag + Liquid Glass on iOS 26
GenericJam
committed
251428f
Bump to 0.6.12 — Mob.Theme glass flag + Liquid Glass on iOS

GenericJam
and
claude
committed
9911729
Glass: use Glass.clear for cards (vs Glass.regular)

GenericJam
and
claude
committed
439bb5c
Merge: Glass.clear for floating-card translucency
GenericJam
committed
e7d05fb
Bump to 0.6.13 — Glass.clear default for cards

GenericJam
and
claude
committed
ac17cc1
Mob.Theme: push resolved palette to native via :mob_nif.set_theme/1

GenericJam
and
claude
committed
e1e3031
Merge: BEAM-driven theme push for Compose MaterialTheme
GenericJam
committed
44da397
Bump to 0.6.14 — Mob.Theme.set/1 pushes resolved palette to native

GenericJam
and
claude
committed
0905223
docs: iOS sim BEAM dies on adb host-port collision
GenericJam
committed
6fed5ab
design: plugin + style + security specs
GenericJam
committed
a8a40dc
plan: complete the plugin extraction plan + add rustler test brief
GenericJam
committed
94e9577

Commits on May 20, 2026

design: broaden plugin examples beyond Ash

GenericJam
and
claude
committed
f8f137b
Fix: Column honours fill_height: true (iOS)

C-Sinclair
authored and
GenericJam
committed
27c9442
text_field: secure: true for masked password input

C-Sinclair
authored and
GenericJam
committed
290254b
iOS: file-only :inet_db lookup by default in Mob.App.start/0

C-Sinclair
authored and
GenericJam
committed
11752a4
Bump to 0.6.15 — Conor's iOS polish trio + plugin epic design corpus

GenericJam
and
claude
committed
0eff5c9
docs: document background execution model
dl-alexandre
committed
e1bfa29

Commits on May 21, 2026

Commits on May 22, 2026

feat: support collocated screen templates
dl-alexandre
committed
97e1618
docs: update Android runtime support matrix
dl-alexandre
committed
7e6235f
docs: explain background execution limits
dl-alexandre
committed
cf9c9d0

Commits on May 25, 2026

removed .DS_Store
clsource
committed
4a9ce5e
docs: improved readme with mermaid and logo
clsource
committed
de87430
docs: add decision log (decisions/ + CLAUDE.md convention)

GenericJam
and
claude
committed
fbcd444
added warning label
clsource
committed
158d17a

Commits on May 26, 2026

Add Mob.data_dir/0 — the writable per-app dir (not MOB_BEAMS_DIR)

GenericJam
and
claude
committed
e2b085c

Commits on May 27, 2026

DNS: document preresolve as the robust iOS path (cellular-safe)

GenericJam
and
claude
committed
9fe6bc1
Merge pull request #32 from GenericJam/dns-system-ns
GenericJam
authored
13cd621
docs: mark build_system_migration as a historical record (#33)

GenericJam
and
claude
authored
2d98417
Add Mob.Speech text-to-speech capability (#34)

GenericJam
and
claude
authored
6d105e8
Merge pull request #30 from NinjasCL-labs/delete-ds-store
GenericJam
authored
6910cbe
Merge pull request #23 from dl-alexandre/docs/android-x86-runtime-support
GenericJam
authored
1592c47
Merge pull request #31 from NinjasCL-labs/mermaid
GenericJam
authored
1d72d99
Merge pull request #19 from dl-alexandre/docs/background-execution
GenericJam
authored
024bc85
Merge pull request #24 from dl-alexandre/docs/background-execution-guide
GenericJam
authored
6fdaa6c
0.6.19
GenericJam
committed
05b7116
docs: fix hexdocs rendering — logo + mermaid diagrams

GenericJam
and
claude
committed
f5337ef
0.6.20
GenericJam
committed
b7a517d
design: resolve the two UI-kit-evaluation open items

GenericJam
and
claude
committed
527cd46
decision: Phase 1 plugin host is a new mob_plugin_demo repo

GenericJam
and
claude
committed
f04784e

Commits on May 28, 2026

spec: tier-1 nif :module is a C-token, not an Elixir module

GenericJam
and
claude
committed
9622486
Mob.DNS: in-process IPv4 resolution on Android via Bionic getaddrinfo NIF

GenericJam
and
claude
committed
07fa82c
Merge pull request #36 from GenericJam/dns-android-getaddrinfo
GenericJam
authored
43d1906
Release 0.6.21 — Android in-process DNS via Bionic getaddrinfo NIF

GenericJam
and
claude
committed
2469a38
Mob.Certs: load CA certificates on Android (where :public_key.cacerts_load/0 can't)

GenericJam
and
claude
committed
7857f0b
mob_beam.zig: optional escript/erl/erlexec/beam.smp symlinks for runtime rebar3

GenericJam
and
claude
committed
5c7c4d9
mix format test/mob/certs_test.exs
GenericJam
committed
3163029
Merge pull request #38 from GenericJam/android-cacerts-and-rebar3
GenericJam
authored
436b3d9
mix.exs: collapse duplicate before_closing_body_tag/1 clauses
GenericJam
committed
37d7acd
Release 0.6.22 — Mob.Certs + escript symlinks (#38) + body_tag dedupe
GenericJam
committed
b8828a8
spec: tighten tier-1 nif :module regex to lowercase-letter-start
GenericJam
committed
68c1a4c
spec: fix tier-2 example to use C-token nif :module
GenericJam
committed
3bb7d32
docs: update CLAUDE.md to reflect Android node-name fix in mob_dev
GenericJam
committed
08df2e0

Commits on May 29, 2026

Phase 1: Mob.Theme.Material3 token plumbing (no visual changes)

GenericJam
and
claude
committed
7031739
Remove Mob.Bt — extracted to standalone mob_bluetooth plugin
GenericJam
committed
132f1bd
Test harness: screenshot, scroll control, and element frames over dist (#40)

GenericJam
and
claude
authored
452dc4c
docs: zig plugin NIFs + Android bridge classes; dist-port note fix

GenericJam
and
claude
committed
6723ea3
Release 0.6.23 — agent-driving test harness + Mob.Bt extraction

GenericJam
and
claude
committed
a71d979

Commits on May 30, 2026

Remove bt native from core — extracted to mob_bluetooth tier-1 plugin (Session B)

GenericJam
and
claude
committed
cc2700f
Remove orphaned iOS bt stubs from core (extraction completeness)

GenericJam
and
claude
committed
2be683a

Commits on May 31, 2026

iOS: default to a 128 MB literal super-carrier (-MIscs 128)

GenericJam
and
claude
committed
e9b4473
Release 0.6.25: "open with" — Mob.Files.take_opened_document/0

GenericJam
and
claude
committed
d2de8af
clang-format the open-with native additions

GenericJam
and
claude
committed
2221856

Commits on Jun 1, 2026

Release 0.6.26: remove the hardcoded iOS -MIscs 10 literal cap

GenericJam
and
claude
committed
147b53b
CHANGELOG: Mob.Bt native removal complete (Wave 1 done)

GenericJam
and
claude
committed
fea1e0d
Merge Wave 1: remove Bluetooth from core (extracted to mob_bluetooth)

GenericJam
and
claude
committed
e246de8

Commits on Jun 4, 2026

Update deps for Elixir 1.20.0

GenericJam
and
claude
committed
a6ba093

Commits on Jun 5, 2026

permissions: extensible registry — iOS runtime table + relaxed Elixir guard

GenericJam
and
claude
committed
48e24a2
Wave 2: extract location from core into the mob_location plugin

GenericJam
and
claude
committed
d790252

Commits on Jun 6, 2026

Plugin tiers 3/4 — Phase 0 core: Mob.Plugins runtime-manifest loader

GenericJam
and
claude
committed
457404d
Plugin tier 3 — register plugin screens at boot (Phase 1, screens)

GenericJam
and
claude
committed
56ff945
Plugin tier 3 — core plugin:// image resolver (Phase 1)

GenericJam
and
claude
committed
e6c03fd
Plugin tier 4 — lifecycle, settings, notifications, supervision (Phase 2)

GenericJam
and
claude
committed
a882f1c
Plugin tier 3 — capture host app name at compile time (device fix)

GenericJam
and
claude
committed
d840290
Plugin tier 4 — start lifecycle before host on_start (iOS device fix)

GenericJam
and
claude
committed
d3fb92a
Docs: plugin tiers 3/4 built — ADR, CHANGELOG, MOB_PLUGINS status

GenericJam
and
claude
committed
408ddc2
Plugin tiers 3/4 — notification central delivery + plugin:// image rendering

GenericJam
and
claude
committed
333b476
Docs: narrow remaining tier-3/4 work to font bundling

GenericJam
and
claude
committed
1cf9884
Docs: custom fonts built — CHANGELOG + MOB_PLUGINS status

GenericJam
and
claude
committed
6698e43
Merge branch 'plugin-tiers-3-4'
GenericJam
committed
e7920f6
fix(plugins): harden runtime against malformed plugin manifests

GenericJam
and
claude
committed
9adc00b
Merge bughunt-iter1: plugin-system bug-hunt iteration 1 safe fixes
GenericJam
committed
bb3c374

Commits on Jun 7, 2026

fix(plugins): log malformed-settings-schema fallbacks instead of silent skips

GenericJam
and
claude
committed
9eeeea3
fix(plugins): crash-isolate notification dispatch (handler + predicate)

GenericJam
and
claude
committed
8ab1cff
Merge bughunt-iter1-hv: high-value flagged plugin bug fixes
GenericJam
committed
8c458b6

Commits on Jun 9, 2026

Commits on Jun 10, 2026

feat(plugins): load plugin NIF modules at boot so iOS permission handlers register

GenericJam
and
claude
committed
e66eccb

Commits on Jun 11, 2026

Commits on Jun 12, 2026

docs(plugins): spec-v2 lane realized — mob_ash verified on device
GenericJam
committed
ba75075
feat(styles): tokens-only style packages — runtime manifest + boot apply

GenericJam
and
claude
committed
e8cbcf4
Merge styles-mvp: tokens-only style packages (core half)
GenericJam
committed
5eed142
strip citrus theme (mob_theme_citrus style package supplies it) — Wave 4 opens

GenericJam
and
claude
committed
52244be
Merge strip-theme-citrus: Wave 4 opens
GenericJam
committed
0e81068
test: decouple the boot-apply fixture from the extracted citrus theme

GenericJam
and
claude
committed
d53264f
docs(plugins): styles lane realized (tokens-only) — mob_theme_citrus verified
GenericJam
committed
5b1b61b
feat(composite): the third expansion pass — pure-Elixir composites by tag

GenericJam
and
claude
committed
35df613
Merge composite-expansion: pure-Elixir composite components
GenericJam
committed
396e2c3
docs(plugins): expand: form honored — composite expansion pass ADR
GenericJam
committed
3b13d81
strip obsidian/birch/obsidian_glass/material3 themes (mob_themes package supplies them)

GenericJam
and
claude
committed
0cd0e8d
Merge strip-themes: Wave 4 theme consolidation
GenericJam
committed
477496b
docs(plugins): Wave 4 consolidated into mob_themes
GenericJam
committed
48d1999
docs(styles): implementation status — tokens-only tier shipped, native tier design-only
GenericJam
committed
f2f5e49
changelog: draft the 0.7.0 breaking-major entry (unreleased)
GenericJam
committed
19cc808
release plan: 0.7.0 sequence, package table, open items, Kevin's checklist
GenericJam
committed
1d0146e
docs: guides catch up with the 0.7.0 plugin extractions

GenericJam
and
claude
committed
8c74e88
docs: ship the full guide set + MOB_STYLES.md on HexDocs

GenericJam
and
claude
committed
07cdf67
docs: fix wrong-name references + dead intra-doc links

GenericJam
and
claude
committed
b3f3572
docs: First-Party Packages catalog — the 'fully featured, pull in libs' index

GenericJam
and
claude
committed
186e7ae
docs(plugins guide): catch up with the cycle — tests, composites, host_requirements, style packages

GenericJam
and
claude
committed
c7b702b
Release 0.7.0 — the plugin-extraction major (BREAKING)

GenericJam
and
claude
committed
a8c5b37
README: install constraint ~> 0.7

GenericJam
and
claude
committed
aa33e92

Commits on Jun 16, 2026

Add 'mix setup' to activate git hooks on a fresh clone

GenericJam
and
claude
committed
4b4bcd3

Commits on Jun 17, 2026

Commits on Jun 18, 2026

docs: drop the production warning from the README

GenericJam
and
claude
committed
acb8d30

Commits on Jun 19, 2026

Mob.ScreenCase: blessed in-BEAM screen testing (+ contract check, device backend) (#44)

GenericJam
and
claude
authored
eb66568
Release 0.7.2 — Mob.ScreenCase in-BEAM screen testing (#44)

GenericJam
and
claude
committed
36ad6bd
docs: record that Igniter tasks (incl. mob.adopt) live in mob_dev, not the mob_new archive

GenericJam
and
claude
committed
a932c16
mob 0.7.3: extract Mob.Background into the mob_background plugin (BREAKING)

GenericJam
and
claude
committed
c32abc0

Commits on Jun 20, 2026

fix(nif): double-buffer the tap-handle registry (Android + iOS) (#45)

GenericJam
and
claude
authored
37dd02d
Release 0.7.4: double-buffer the tap-handle registry (#45)

GenericJam
and
claude
committed
0451c69

Commits on Jun 21, 2026

fix(ios): deliver canvas finger-drag (on_drag) — parity with Android

GenericJam
and
claude
committed
128b208
fix(ios): polish canvas drag — guard drag flag, document minimumDistance, test on_drag wiring

GenericJam
and
claude
committed
a033f15
Release 0.7.5: iOS canvas finger-drag (on_drag) (#47)

GenericJam
and
claude
committed
d4d0717

Commits on Jun 25, 2026

Add device orientation: detect + lock (Mob.Device) (#49)

GenericJam
and
claude
authored
b5a2bc4
Release 0.7.6: device orientation detect + lock (#49)

GenericJam
and
claude
committed
a26c824
Release 0.7.7: fix boot crash from missing -nifs declaration (0.7.6 regression)

GenericJam
and
claude
committed
641cdaa
Add Mob.Device.open_settings/1: open OS settings from a screen (#50)

GenericJam
and
claude
authored
ceb1b99
Release 0.7.8: Mob.Device.open_settings/1 (#50)

GenericJam
and
claude
committed
3ccc1b4

Commits on Jun 26, 2026

Release 0.7.9: iOS non-glass box fill honors corner_radius

GenericJam
and
claude
committed
e90fe6f

Commits on Jun 27, 2026

Release 0.7.10: iOS row align "baseline" -> .lastTextBaseline

GenericJam
and
claude
committed
f14c0ef
Add LiveView-style ergonomics: :if/:for, @assigns sugar, Socket helpers

GenericJam
and
claude
committed
d5e38f2
docs: cover :if/:for/@assigns and Socket helpers in guides

GenericJam
and
claude
committed
df70504
Merge pull request #52 from GenericJam/feat/liveview-ergonomics
GenericJam
authored
5a133f5
Release 0.7.11: LiveView-style sigil ergonomics + Socket helpers

GenericJam
and
claude
committed
22c9bd7

Commits on Jul 1, 2026

MOB-5: ~MOB @foo raises a clear error when assigns is not in scope

GenericJam
and
claude
committed
a70ce0d
docs: add worked component-authoring examples to components guide

GenericJam
and
claude
committed
239a9f4
docs: keep #pure-elixir-composite-components anchor after section rename

GenericJam
and
claude
committed
34ad6ad
Merge pull request #56 from GenericJam/mob-5-sigil-assigns-guard
GenericJam
authored
fccd1c4
Merge pull request #57 from GenericJam/docs/component-authoring-examples
GenericJam
authored
e4d829d
Release 0.7.12: clear ~MOB @foo error + component-authoring guide

GenericJam
and
claude
committed
0b41866

Commits on Jul 3, 2026

Commits on Jul 4, 2026

MOB-6: magnetometer / compass support in Mob.Motion (#59)

GenericJam
and
claude
authored
f9556c5
Release 0.7.14: magnetometer / compass support in Mob.Motion

GenericJam
and
claude
committed
e4a6c8e

Commits on Jul 5, 2026

MOB-30: refresh mobile_surface_matrix.md — magnetometer/compass/orientation-lock/BLE (#60)

GenericJam
and
claude
authored
f071e0f
MOB-15: torch / flashlight support in core (Mob.Torch) (#61)

GenericJam
and
claude
authored
3d6219e
Release 0.7.15: torch / flashlight support (Mob.Torch)

GenericJam
and
claude
committed
467000b
docs: fix undefined tap/1 in getting_started "first screen" example (#63)

GenericJam
and
claude
authored
aef9917
docs: make the 0xAARRGGBB color format explicit (vs CSS hex) (#64)

GenericJam
and
claude
authored
f6c6308
MOB-14: network / connectivity state in Mob.Device (query + events) (#62)

GenericJam
and
claude
authored
7809905
Release 0.7.16: network / connectivity state (Mob.Device.network_state)

GenericJam
and
claude
committed
0cb5dd1
MOB-20: keep-awake / idle-timer support in Mob.Device (#66)

GenericJam
and
claude
authored
ef86ecb
Release 0.7.17: keep-awake / idle-timer (Mob.Device.keep_awake)

GenericJam
and
claude
committed
32498c6

Commits on Jul 7, 2026

MOB-35: Mob.Audio input-level metering (agent "ears") — contract + host tests (#67)

GenericJam
and
claude
authored
ec39679
Mob.Audio output probes: verify sound is actually working (#54)

GenericJam
and
claude
authored
b316a3c
Remove errant deps symlink committed via #54

GenericJam
and
claude
committed
6842e3c
Release 0.7.18: Mob.Audio output probes + input-level metering (#69)

GenericJam
and
claude
authored
d06ddbc

Commits on Jul 11, 2026

Commits on Aug 8, 2026

docs: align screen lifecycle docs with single-GenServer navigation
minibikini
committed
30faaac