diff --git a/CHANGELOG.md b/CHANGELOG.md
index ad686dc..b82da52 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
### Added
- **Studio: WiFi token memory** — Studio now remembers the agent token per discovered device (keyed by Bonjour instance name) in localStorage. After a successful WiFi connect, subsequent mDNS-discovered sessions for that device prefill the token automatically and show a "🔑 saved" tag. Each remembered device gets a small "✕" button to forget the token.
+- **Studio: workspace settings overlay** — new ⚙ button in the toolbar opens a small form for `agent.port`, `defaults.timeout`, `device.ios_device_id`, and `device.android_device_id`. Save writes back to `probe.yaml` in the active workspace. Other keys you've set in `probe.yaml` are preserved on save (loaded as a raw map; only the four managed keys are mutated).
## [0.7.0] - 2026-05-02
diff --git a/studio/frontend/index.html b/studio/frontend/index.html
index 15d7315..16c1ff0 100644
--- a/studio/frontend/index.html
+++ b/studio/frontend/index.html
@@ -25,6 +25,8 @@
+
+
@@ -86,6 +88,42 @@
+
+
+
+
Workspace settings
+
+
+
+ Edit probe.yaml in the current workspace. Other fields you've set in probe.yaml are preserved on save.
+
+
+ Pick a workspace first (📂 in the file pane).
+
+
+
+
+
diff --git a/studio/frontend/src/main.ts b/studio/frontend/src/main.ts
index 50fe8da..fa82e01 100644
--- a/studio/frontend/src/main.ts
+++ b/studio/frontend/src/main.ts
@@ -12,14 +12,17 @@ import {
Lint,
ListDevices,
ListDir,
+ LoadWorkspaceSettings,
PickWorkspace,
ReadFile,
RunFile,
+ SaveWorkspaceSettings,
StartWiFiDiscovery,
Status,
StopWiFiDiscovery,
WriteFile,
} from "../wailsjs/go/main/App";
+import { main } from "../wailsjs/go/models";
import { EventsOn } from "../wailsjs/runtime/runtime";
const WORKSPACE_KEY = "fp.studio.workspace";
@@ -259,6 +262,8 @@ window.addEventListener("keydown", (e) => {
if (e.key === "Escape") {
closeHelpOverlay();
+ closeSettingsOverlay();
+ closeWiFiOverlay();
return;
}
if (e.key === "?" && !mod) {
@@ -305,6 +310,66 @@ $("help-overlay").addEventListener("click", (e) => {
if ((e.target as HTMLElement).id === "help-overlay") closeHelpOverlay();
});
+// ---- Workspace settings overlay ----------------------------------------
+
+async function openSettingsOverlay() {
+ const overlay = $("settings-overlay");
+ const noWorkspace = $("settings-no-workspace") as HTMLElement;
+ const form = $("settings-form") as HTMLFormElement;
+ overlay.hidden = false;
+
+ if (!currentDir || currentDir === "tests" || currentDir === ".") {
+ noWorkspace.hidden = false;
+ form.hidden = true;
+ return;
+ }
+ noWorkspace.hidden = true;
+ form.hidden = false;
+
+ try {
+ const s = await LoadWorkspaceSettings(currentDir);
+ ($("settings-port") as HTMLInputElement).value = s.agentPort ? String(s.agentPort) : "";
+ ($("settings-timeout") as HTMLInputElement).value = s.defaultsTimeout ?? "";
+ ($("settings-ios") as HTMLInputElement).value = s.iosDeviceId ?? "";
+ ($("settings-android") as HTMLInputElement).value = s.androidDeviceId ?? "";
+ } catch (err) {
+ toast(`Cannot load settings: ${err}`, "error");
+ }
+}
+
+function closeSettingsOverlay() {
+ $("settings-overlay").hidden = true;
+}
+
+$("btn-settings").addEventListener("click", openSettingsOverlay);
+$("btn-settings-close").addEventListener("click", closeSettingsOverlay);
+$("settings-overlay").addEventListener("click", (e) => {
+ if ((e.target as HTMLElement).id === "settings-overlay") closeSettingsOverlay();
+});
+
+$("btn-settings-save").addEventListener("click", async () => {
+ if (!currentDir) return;
+ const portRaw = ($("settings-port") as HTMLInputElement).value.trim();
+ const port = portRaw === "" ? 0 : Number(portRaw);
+ if (Number.isNaN(port)) {
+ toast("Agent port must be a number.", "error");
+ return;
+ }
+ const settings = main.WorkspaceSettings.createFrom({
+ agentPort: port,
+ defaultsTimeout: ($("settings-timeout") as HTMLInputElement).value.trim(),
+ iosDeviceId: ($("settings-ios") as HTMLInputElement).value.trim(),
+ androidDeviceId: ($("settings-android") as HTMLInputElement).value.trim(),
+ });
+ try {
+ await SaveWorkspaceSettings(currentDir, settings);
+ toast(`Saved probe.yaml in ${currentDir}`, "success", 2200);
+ closeSettingsOverlay();
+ } catch (err) {
+ toast(`Save failed: ${err}`, "error");
+ }
+});
+
// ---- WiFi discovery overlay --------------------------------------------
type WiFiDevice = { name: string; host: string; port: number; version: string };
diff --git a/studio/frontend/src/style.css b/studio/frontend/src/style.css
index 8aab4c4..69227c4 100644
--- a/studio/frontend/src/style.css
+++ b/studio/frontend/src/style.css
@@ -389,6 +389,21 @@ body { display: flex; flex-direction: column; overflow: hidden; }
.wifi-saved-tag { color: var(--fg-dim); font-size: 10px; margin-left: 8px; padding: 1px 6px; background: var(--bg-1); border-radius: var(--radius-sm); }
.wifi-device-list .btn-mini.wifi-forget { float: right; opacity: 0.5; padding: 0 6px; font-size: 11px; }
.wifi-device-list .btn-mini.wifi-forget:hover { opacity: 1; }
+
+/* Workspace settings form */
+.settings-form { display: flex; flex-direction: column; gap: 10px; margin-top: 8px; }
+.settings-row {
+ display: grid; grid-template-columns: 160px 1fr; align-items: center; gap: 10px;
+ font-size: 12px;
+}
+.settings-row > span { color: var(--fg-dim); }
+.settings-row input {
+ padding: 6px 10px; box-sizing: border-box;
+ background: var(--bg-1); border: 1px solid var(--border-strong);
+ border-radius: var(--radius); color: var(--fg-strong);
+ font-family: ui-monospace, SF Mono, Menlo, monospace; font-size: 12px;
+}
+.settings-actions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 8px; }
kbd {
display: inline-block;
padding: 1px 6px;
diff --git a/studio/frontend/wailsjs/go/main/App.d.ts b/studio/frontend/wailsjs/go/main/App.d.ts
index a025ad9..ba97a3f 100755
--- a/studio/frontend/wailsjs/go/main/App.d.ts
+++ b/studio/frontend/wailsjs/go/main/App.d.ts
@@ -16,12 +16,16 @@ export function ListDevices():Promise>;
export function ListDir(arg1:string):Promise>;
+export function LoadWorkspaceSettings(arg1:string):Promise;
+
export function PickWorkspace():Promise;
export function ReadFile(arg1:string):Promise;
export function RunFile(arg1:string):Promise>;
+export function SaveWorkspaceSettings(arg1:string,arg2:main.WorkspaceSettings):Promise;
+
export function StartWiFiDiscovery():Promise;
export function Status():Promise;
diff --git a/studio/frontend/wailsjs/go/main/App.js b/studio/frontend/wailsjs/go/main/App.js
index a4cd948..bde0a43 100755
--- a/studio/frontend/wailsjs/go/main/App.js
+++ b/studio/frontend/wailsjs/go/main/App.js
@@ -30,6 +30,10 @@ export function ListDir(arg1) {
return window['go']['main']['App']['ListDir'](arg1);
}
+export function LoadWorkspaceSettings(arg1) {
+ return window['go']['main']['App']['LoadWorkspaceSettings'](arg1);
+}
+
export function PickWorkspace() {
return window['go']['main']['App']['PickWorkspace']();
}
@@ -42,6 +46,10 @@ export function RunFile(arg1) {
return window['go']['main']['App']['RunFile'](arg1);
}
+export function SaveWorkspaceSettings(arg1, arg2) {
+ return window['go']['main']['App']['SaveWorkspaceSettings'](arg1, arg2);
+}
+
export function StartWiFiDiscovery() {
return window['go']['main']['App']['StartWiFiDiscovery']();
}
diff --git a/studio/frontend/wailsjs/go/models.ts b/studio/frontend/wailsjs/go/models.ts
index 073ae7b..c2fad99 100755
--- a/studio/frontend/wailsjs/go/models.ts
+++ b/studio/frontend/wailsjs/go/models.ts
@@ -102,6 +102,24 @@ export namespace main {
this.error = source["error"];
}
}
+ export class WorkspaceSettings {
+ agentPort: number;
+ defaultsTimeout: string;
+ iosDeviceId: string;
+ androidDeviceId: string;
+
+ static createFrom(source: any = {}) {
+ return new WorkspaceSettings(source);
+ }
+
+ constructor(source: any = {}) {
+ if ('string' === typeof source) source = JSON.parse(source);
+ this.agentPort = source["agentPort"];
+ this.defaultsTimeout = source["defaultsTimeout"];
+ this.iosDeviceId = source["iosDeviceId"];
+ this.androidDeviceId = source["androidDeviceId"];
+ }
+ }
}
diff --git a/studio/workspace_settings.go b/studio/workspace_settings.go
new file mode 100644
index 0000000..e8b14e8
--- /dev/null
+++ b/studio/workspace_settings.go
@@ -0,0 +1,141 @@
+package main
+
+import (
+ "fmt"
+ "os"
+ "path/filepath"
+ "strings"
+ "time"
+
+ "gopkg.in/yaml.v3"
+
+ "github.com/alphawavesystems/flutter-probe/internal/config"
+)
+
+// WorkspaceSettings is the JSON shape the Studio settings form binds to.
+// It exposes a deliberately small subset of probe.yaml — the four knobs
+// most users actually touch. Other probe.yaml fields are preserved on
+// save (loaded as raw map, only the managed keys are overwritten), so a
+// power user with complex config doesn't lose anything by using the UI.
+type WorkspaceSettings struct {
+ AgentPort int `json:"agentPort"` // probe.yaml: agent.port
+ DefaultsTimeout string `json:"defaultsTimeout"` // probe.yaml: defaults.timeout (Go duration string, e.g. "30s")
+ IOSDeviceID string `json:"iosDeviceId"` // probe.yaml: device.ios_device_id
+ AndroidDeviceID string `json:"androidDeviceId"` // probe.yaml: device.android_device_id
+}
+
+// LoadWorkspaceSettings reads probe.yaml from the workspace and returns
+// the four managed fields. Missing file → all zeros, so the UI form
+// shows the user "this workspace has no probe.yaml yet" via empty state.
+func (a *App) LoadWorkspaceSettings(workspace string) (WorkspaceSettings, error) {
+ if workspace == "" {
+ return WorkspaceSettings{}, fmt.Errorf("workspace path is required")
+ }
+ cfg, err := config.Load(workspace)
+ if err != nil {
+ return WorkspaceSettings{}, fmt.Errorf("loading probe.yaml: %w", err)
+ }
+ return WorkspaceSettings{
+ AgentPort: cfg.Agent.Port,
+ DefaultsTimeout: cfg.Defaults.Timeout.String(),
+ IOSDeviceID: cfg.Device.IOSDeviceID,
+ AndroidDeviceID: cfg.Device.AndroidDeviceID,
+ }, nil
+}
+
+// SaveWorkspaceSettings writes the four managed fields back to probe.yaml.
+// Reads the existing file as a raw map so other keys (recipes_folder,
+// cloud, plugins, etc.) survive untouched. Creates the file if missing.
+func (a *App) SaveWorkspaceSettings(workspace string, s WorkspaceSettings) error {
+ if workspace == "" {
+ return fmt.Errorf("workspace path is required")
+ }
+
+ // Validate the duration string round-trips before touching disk.
+ if s.DefaultsTimeout != "" {
+ if _, err := time.ParseDuration(s.DefaultsTimeout); err != nil {
+ return fmt.Errorf("defaultsTimeout %q is not a valid Go duration: %w", s.DefaultsTimeout, err)
+ }
+ }
+ if s.AgentPort < 0 || s.AgentPort > 65535 {
+ return fmt.Errorf("agentPort %d is outside the valid TCP port range", s.AgentPort)
+ }
+
+ path := filepath.Join(workspace, "probe.yaml")
+ raw := map[string]any{}
+ existing, err := os.ReadFile(path)
+ if err == nil {
+ if err := yaml.Unmarshal(existing, &raw); err != nil {
+ return fmt.Errorf("parsing existing probe.yaml: %w", err)
+ }
+ } else if !os.IsNotExist(err) {
+ return fmt.Errorf("reading probe.yaml: %w", err)
+ }
+
+ // Mutate only the keys we manage; leave the rest of the user's YAML alone.
+ setNestedString(raw, "agent", "port", "") // ensure parent map exists
+ setNestedString(raw, "device", "ios_device_id", "") // ensure parent map exists
+ setNestedString(raw, "defaults", "timeout", "") // ensure parent map exists
+
+ mergeKey(raw, "agent", "port", s.AgentPort)
+ mergeKey(raw, "defaults", "timeout", s.DefaultsTimeout)
+ mergeKey(raw, "device", "ios_device_id", s.IOSDeviceID)
+ mergeKey(raw, "device", "android_device_id", s.AndroidDeviceID)
+
+ out, err := yaml.Marshal(raw)
+ if err != nil {
+ return fmt.Errorf("encoding probe.yaml: %w", err)
+ }
+ if err := os.WriteFile(path, out, 0o644); err != nil {
+ return fmt.Errorf("writing probe.yaml: %w", err)
+ }
+ return nil
+}
+
+// mergeKey writes value at raw[parent][key]. If value is the zero value
+// for its type, the key is removed instead — preserving the convention
+// that probe.yaml only lists fields the user has explicitly set.
+func mergeKey(raw map[string]any, parent, key string, value any) {
+ parentMap := ensureMap(raw, parent)
+ if isZero(value) {
+ delete(parentMap, key)
+ // Drop the empty parent map too so we don't litter probe.yaml with
+ // `agent: {}` when the user clears every field under it.
+ if len(parentMap) == 0 {
+ delete(raw, parent)
+ }
+ return
+ }
+ parentMap[key] = value
+}
+
+func ensureMap(raw map[string]any, key string) map[string]any {
+ if existing, ok := raw[key].(map[string]any); ok {
+ return existing
+ }
+ // yaml.v3 Unmarshal produces map[string]interface{} for object values,
+ // but Marshal accepts both shapes. Coerce to keep the writeback path
+ // consistent.
+ m := map[string]any{}
+ raw[key] = m
+ return m
+}
+
+// setNestedString is a no-op nudge that ensures the parent map exists
+// without overriding any value the user already set there. Useful as
+// a defensive prelude before mergeKey when we're about to delete keys.
+func setNestedString(raw map[string]any, parent, _, _ string) {
+ ensureMap(raw, parent)
+}
+
+func isZero(v any) bool {
+ switch x := v.(type) {
+ case string:
+ return strings.TrimSpace(x) == ""
+ case int:
+ return x == 0
+ case bool:
+ return !x
+ }
+ return v == nil
+}