Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.
description: "Tasks: Nota Remote in Studio, wearing the app's theme"
Tasks: Nota Remote in Studio, wearing the app's theme
Input: Design documents from specs/014-remote-studio/
Prerequisites: plan.md, spec.md, research.md, data-model.md, contracts/
Tests: requested by the spec (FR-020, US4): the smoke test checks the theme message and guards the phone sources.
Format: [ID] [P?] [Story] Description
- [P]: Can run in parallel (different files, no dependencies)
- [Story]: Which user story this task belongs to (US1–US4)
Phase 1: Setup
- T001 Install the phone page's dev dependencies and record the baseline:
npm ci && npm run checkinsrc/web/remote(expect 0 errors) - T002 [P] Write the stand-in Nota for screenshots:
src/web/remote/mock/nota-mock.mjs(SPDX header; no dependencies — static server forsrc/managed/Nota.Remote/wwwrootplus a hand-rolled WebSocket; pairs any code, sendswelcome,themebuilt fromsrc/managed/Nota.App/Theme/Themes/*.jsonper contracts/theme-message.md,projwith a demo project of drum / instrument / audio / group / return tracks, sections and a key,tp,mix,xy,mac,ses; the page URL's?theme=<id>picks the theme the stand-in wears and?pick=<dark>,<light>the picks;?legacy=1sends onlyproj.dark); add"mock": "node mock/nota-mock.mjs"tosrc/web/remote/package.json - T003 Take "before" screenshots of every screen at 390 × 844 in the old Ember dark and light looks using the current bundle and the mock, into the scratchpad (PR material)
Phase 2: Foundational (blocking)
- T004 Add
RemoteTheme(string Id, string Name, bool Dark, IReadOnlyDictionary<string,string> Colors)andRemoteAppearance(RemoteTheme Active, RemoteTheme DarkPick, RemoteTheme LightPick, string InkDark, string InkLight)tosrc/managed/Nota.Remote/RemoteContracts.cs; replacebool DarkThemewithRemoteAppearance AppearanceonIRemoteHost(doc: "the same instance until the worn theme or the choice changes") - T005 [P] Name the two inks in
src/managed/Nota.App/Theme/NotaPalette.cs:InkDark(#17181A) andInkLight(#FFFFFF) used byReadableInkOn - T006 [P] Write
src/web/remote/src/lib/palette.ts(pure, no DOM):cssName(token)(BgApp→--bg-app,SystemAccentLight1→--system-accent-light1,Track1→--track1),inkOn(fill, [dark, light])(WCAG contrast, ties → dark, asNotaPalette.ReadableInkOn),cssVars(colors, ink)returning every token plus--ink-on-accent,--ink-on-mute,--ink-on-solo,--ink-on-record,--ink-on-success - T007 Write
src/web/remote/theme-plugin.ts: a Vite plugin resolvingvirtual:nota-theme.cssto:root{…}fromstudio-dark.jsonand[data-theme='light']{…}fromstudio-light.jsonviacssVars, the ink pair being Studio Dark'sTextOnAccentandShadeUp;addWatchFileboth; register it insrc/web/remote/vite.config.ts
Phase 3: User Story 1 — the phone wears Nota's theme (P1) 🎯 MVP
Goal: Follow Nota shows the desktop's theme and follows changes live.
Independent test: with the mock (?theme= each id) or a real Nota, the phone's
--bg-app, --panel, --text-primary, --accent equal the theme file's values.
- T008 [US1] Implement
IRemoteHost.Appearanceinsrc/managed/Nota.App/MainWindow.Remote.cs: a per-id cache ofRemoteThemebuilt fromNotaThemes.BuiltIn(CSS hex#RRGGBB,#RRGGBBAAwhen alpha < 255), and aRemoteAppearancecached on(NotaPalette.Theme, NotaThemeService.Choice); Active =NotaPalette.Theme ?? NotaThemes.Default, picks fromChoice.Dark/Choice.Light - T009 [US1] Hub: in
src/managed/Nota.Remote/RemoteHub.State.csaddThemeJson(host)(serialise per contracts/theme-message.md —t,on,dark,light,ink,thwith distinct ids; rebuild only when theAppearancereference changed); inPushsend it beforeprojwhen!ReferenceEquals(json, c.SentTheme);proj.darkfromAppearance.Active.Dark; addinternal string? SentTheme;tosrc/managed/Nota.Remote/RemoteClient.cs - T010 [US1] Smoke test: in
tests/Nota.SmokeTest/RemoteTests.csgiveFakeHostanAppearance(two prebuilt appearances, switchable) and check: athememessage arrives withon, both picks,ink,thholding exactly the distinct ids, each with the same full token set andBgApp;proj.darkequalsth[on].dark; a switch sends one newtheme; further ticks send none - T011 [US1] Phone theme module
src/web/remote/src/lib/theme.svelte.ts:Lookwithmsg(storednota-remote:theme),phoneDark(livematchMedialistener),legacyDark;worn(pref);apply()sets every var ondocumentElement.style,data-theme,meta[name=theme-color]=--bg-app, storesnota-remote:vars;inkOn(hex)for track fills - T012 [US1] Wire it:
src/web/remote/src/lib/app.svelte.tshandlest: 'theme'(store + apply), feedsproj.darktolegacyDark, dropsget dark;src/web/remote/src/lib/types.tsaddsThemeMessage;src/web/remote/src/App.sveltereplaces the dark/light effect with an effect that applies the worn theme;src/web/remote/src/main.tsimportsvirtual:nota-theme.cssbeforeapp.css - T013 [US1] First paint: a head script in
src/web/remote/index.htmlthat appliesnota-remote:vars(anddata-theme, theme-color) inside try/catch before the body renders; drop the hard-codedtheme-colorvalue anddata-theme="dark"default stays
Phase 4: User Story 2 — Follow phone uses the picks (P1)
Goal: Follow phone wears the dark-mode or light-mode pick by the phone's scheme, instantly.
Independent test: mock with ?pick=ember-graphite,studio-light, phone menu → Follow
phone, toggle the emulated colour scheme: --bg-app switches between the two picks.
- T014 [US2] In
src/web/remote/src/lib/theme.svelte.tsmakewornfollowprefs.theme === 'phone'→msg.dark/msg.lightbyphoneDark, re-applying on a scheme change, a preference change and a new message (an$effect.rootin the module, readingapp.prefs.theme) - T015 [US2] In
src/web/remote/src/components/Sheets.sveltekeep the Theme segment (Follow Nota / Follow phone) and add the worn theme's name under it as a muted line ("Studio Light · from Nota's light-mode pick")
Phase 5: User Story 3 — every screen reads as Studio (P2)
Goal: the ui-contract applied to every surface.
Independent test: screenshots of every screen in Studio Dark and Studio Light reviewed against DESIGN.md § The rules.
- T016 [US3] Rewrite
src/web/remote/src/app.css: remove the Ember palette blocks and.caps; base type (Geist, 13 px,--text-primaryon--bg-app),.mono,.label(600 · 11,--text-muted),.btn,.seg,.switch(28 × 16 squared),.learnableper contracts/ui-contract.md § Shared - T017 [P] [US3] Restyle
src/web/remote/src/App.svelte(rail, tabs: selected = primary ink + 2 px accent line; seams) - T018 [P] [US3] Restyle
src/web/remote/src/components/Header.svelte(track button, transport keys incl. record disc at rest, position well, link dot; thin space in "12 ms") - T019 [P] [US3] Restyle
src/web/remote/src/components/Banner.svelte - T020 [P] [US3] Restyle
src/web/remote/src/components/Sheets.svelte(popover, rows with accent tick, badges, field, switches, sentence-case heads, Disconnect an ordinary row) - T021 [P] [US3] Restyle
src/web/remote/src/components/Overlays.svelte(covers, steps list, code cells, Connect again, count-in, toast) - T022 [P] [US3] Restyle
src/web/remote/src/screens/Pads.svelte(tiles radius 3; held accent; lit = track colour + derived ink vialook.inkOn; "Full velocity") - T023 [P] [US3] Restyle
src/web/remote/src/screens/Keys.svelte(key-white / key-black, held accent, lit band; tiles; key source "Phone / Project / Default" neutral; numerals neutral) - T024 [P] [US3] Restyle
src/web/remote/src/screens/XY.svelte(graph field, neutral crosshair and point at rest, accent while dragged or tilting, no fill; axis labels; tilt chip; percent with thin space) - T025 [P] [US3] Restyle
src/web/remote/src/screens/Mixer.svelte(strips on seams, cap and pan neutral → accent while dragged, meter zones, M / S / Arm semantic fills with derived ink, "Arm", "Master" label) - T026 [P] [US3] Restyle
src/web/remote/src/screens/Macros.svelte(desktop knob geometry and colours, names as written, automated dot muted, percent with thin space) - T027 [P] [US3] Restyle
src/web/remote/src/screens/Scenes.svelte(clips radius 2, track fills with derived ink, recording solid record, progress in ink, sentence-case states) - T028 [P] [US3] Restyle
src/web/remote/src/screens/BigTransport.svelte(keys, on states, record, sections tick / looping, "Bar 5" / "Looping", tap tempo label) - T029 [P] [US3] Restyle
src/web/remote/src/screens/Empty.svelte
Phase 6: User Story 4 — the theme travels with the build (P3)
- T030 [US4] Phone-source guard
tests/Nota.SmokeTest/DesignTokenCheck.Remote.cs(RunRemote): insrc/web/remote/src(.svelte,.ts,.css, viaFiles()/Rel()) no#hexcolour,rgb(/rgba(/hsl(; noletter-spacingother than 0; notext-transform: uppercase; no.toUpperCase();border-radiusonly 0 / 1 / 2 / 3 / 4 px or 50 %; andtheme-plugin.tsreads the theme files rather than holding values. Register the section intests/Nota.SmokeTest/Program.cs - T031 [US4] Rebuild the bundle (
npm run buildinsrc/web/remote→src/managed/Nota.Remote/wwwroot),npm run checkclean
Phase 7: Polish
- T032 Run
scripts/build.sh(smoke test included); rerun timing-budget checks on an idle machine before calling one real - T033 "After" screenshots of every screen at 390 × 844 in Studio Dark and Studio Light (plus one each in Ember Graphite / Ember Paper and a Follow-phone flip) with the mock; review against DESIGN.md § The rules and fix
- T034 [P]
CHANGELOG.md[Unreleased] entry;FEATURES.mdvia nota-features;DESIGN.md§ Shell note on Nota Remote; user manual's Remote page via nota-docs if the sibling repo is present (it is not checked out here — follow-up) - T035 Commit, push
feat/remote-studio, open a draft PR on chrislaupama/nota intofeat/studio-uiwith before/after screenshots
Dependencies
- T004 → T008, T009, T010. T006 → T007, T011. T011 → T012–T015, T022 (inkOn).
- US1 (T008–T013) before US2 (T014–T015). US3 tasks T017–T029 depend on T016 and are parallel with each other. T030 after US3. T031 after all phone edits. T032–T035 last.
Parallel examples
- T005 ∥ T006 ∥ T002 (different files).
- T017 … T029 (one file each) once T016 lands.
Implementation strategy
MVP = Phases 1–3 (the phone wears Nota's theme live). Then Follow phone, then the restyle, then the guard, then the gate and the PR.
Nota compliance (re-check)
- SPDX header on
palette.ts,theme.svelte.ts,theme-plugin.ts,nota-mock.mjs,DesignTokenCheck.Remote.cs - No new dependency
- No audio-thread code touched
- Smoke test extended (T010, T030)
- CHANGELOG / FEATURES / DESIGN updated (T034)
Phase 8: Convergence
- T036 Set the number in a clip's length ("4 bars", "6 beats") in Geist Mono in
src/web/remote/src/screens/Scenes.svelteper FR-015 (partial) - T037 Drop the
nota-remote-mockentry added to the tracked.claude/launch.json(a local dev convenience outside the plan;npm run mockis the documented way) per plan: structure (unrequested)