From f355effcf992b0d0883dcd4bbcc9df5b374a386c Mon Sep 17 00:00:00 2001
From: Wells Riley <884715+wr@users.noreply.github.com>
Date: Sat, 17 Oct 2026 23:25:02 -0400
Subject: [PATCH 01/14] First-run setup: the Wi-Fi network is a dropdown, Cloud
is Recommended, and the phone setup asks one thing at a time (W-1073)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- The kit's setup portal shows the networks as one dropdown, strongest
first, with "Other…" for a hidden network, instead of a list that could
run off the screen plus a separate Network field. An open network hides
the password. Save waits for a network to be chosen. A frame that knows
its network has it chosen already.
- Under Server, Featherframe Cloud is tagged Recommended and Self-hosted
Advanced.
- Cloud's "Set up your frame" page is three steps: detection source, then a
BirdWeather station (skipped for a BirdNET-Pi or BirdNET-Go), then the
email. Still one form and one POST; a page shown again for an error opens
on that error's step. Without its script, every step shows at once.
Refs: W-1073
---
firmware/src/ff_portal.h | 63 ++++++++++---------
hosted/src/pages.ts | 124 +++++++++++++++++++++++++++-----------
hosted/src/setup.ts | 8 +--
hosted/test/setup.test.ts | 21 ++++++-
4 files changed, 145 insertions(+), 71 deletions(-)
diff --git a/firmware/src/ff_portal.h b/firmware/src/ff_portal.h
index 234bf5ea..8000cb4f 100644
--- a/firmware/src/ff_portal.h
+++ b/firmware/src/ff_portal.h
@@ -45,11 +45,12 @@
// - Every page: one card under the wordmark. WiFiManager's status line goes to
// the top of it, said plainly after a failed join, and not at all when no
// network is saved yet ("No AP set").
-// - The Wi-Fi page: a heading with Refresh beside it, the networks as one list
-// (the webapp's Wi-Fi glyph for signal, a lock where a password is needed),
-// Network and Password (Show inside the field), then the server as a choice:
-// Featherframe Cloud or self-hosted, whichever this build starts on marked
-// (default), the frame's own current server chosen. Self-hosted takes an
+// - The Wi-Fi page: a heading with Refresh beside it, then the networks as a
+// dropdown (W-1073, strongest first, as the scan sorts them; "Other…" shows
+// a Network name field for a hidden network), Password (Show inside the
+// field; gone for an open network), then the server as a choice: Featherframe
+// Cloud (Recommended) or Self-hosted (Advanced), the frame's own current
+// server chosen, else the one this build starts on. Self-hosted takes an
// address, or blank to find the server on the network (posted as "find").
// Under Save, what the frame shows next for that choice: its picture again
// for a frame already set up that stays on its server (W-903).
@@ -96,27 +97,34 @@ var NAMES={'/wifi':'Connect to Wi-Fi','/0wifi':'Connect to Wi-Fi','/info':'Info'
var fs=qa('form',card);for(var i=0;i';return s+'';}
var hd=el('div','ffhead');txt(hd.appendChild(el('h2')),'Connect to Wi-Fi');card.insertBefore(hd,card.firstChild);
-var as=qa('a[data-ssid]',card),list=null;
-if(as.length){list=el('div','ffnets');card.insertBefore(list,as[0].parentNode);
-for(i=0;i0;
+ls.style.display=ssid.style.display=oth?'':'none';ssid.required=oth;if(!oth)ssid.value=op.value;
+var open=on&&!oth&&!lk[op.value];if(pw){pb.style.display=lp.style.display=open?'none':'';if(open)pw.value='';}
+if(oth&&list._u)ssid.focus();list._u=1;}
+list.onchange=net;net();}
+var rf=q('form[action*="refresh"]',card);if(rf){var rb=q('button',rf);rb.className='ffbtn';if(!list)rb.textContent='Show networks';hd.appendChild(rf);}
var inp=q('#server');if(!inp)return;var f=inp.form,cur=inp.value.replace(/\/+$/,'');
var pick=cur==CLOUD?'cloud':(cur?'self':DEF),box=el('div','ffserver');
-function opt(v,name){return '';}
-box.innerHTML='