Skip to content

Deck Mode: an optional retro-modern look (draft, asking first) - #117

Draft
iconscious wants to merge 11 commits into
asivery:masterfrom
iconscious:deck-mode
Draft

iconscious wants to merge 11 commits into
asivery:masterfrom
iconscious:deck-mode

Conversation

@iconscious

@iconscious iconscious commented Nov 11, 2026 •

Copy link
Copy Markdown

Would you want a new optional theme in Web MiniDisc? This is a draft to ask before you spend review time on it. If it isn't something you want to maintain, a "no" is completely fine.

Builds on #116 (About this device): the Deck device card uses its rows. Until that one is merged, this PR also shows its commits; please look at that one first.

deck-01-welcome-n1 deck-02-main-n1 deck-03-menu-n1

What it is

Deck Mode is an opt-in look, switched from the main menu next to Retro Mode. It is off by default, and the two are exclusive: turning one on turns the other off. With it off, nothing changes. Stock components change only an import line, and those imports draw the original Material icons and MUI spinner unless Deck Mode is on.

It covers every screen: Welcome, the main screen (device card, disc card with a capacity meter and free time per mode, track table, transport bar with an LCD-style ticker), every dialog, Settings, and the Homebrew view (framed, with its colour coding kept).

It also adds:

  • Keyboard support to WCAG 2.1 AA (2.1.1, 2.1.2, 2.4.3, 2.4.7). Tab reaches every key on the page in order. The track list counts as a single stop, so Tab enters it once instead of visiting every row. Inside it, Up/Down/Home/End move between rows, Space selects (Shift extends), Enter plays, Shift+F10 opens the row menu, and Alt+Up/Down moves a track the same way dragging does. Tab again moves on past the list. Focus rings are visible everywhere.
  • Small windows (half a laptop screen, short windows): a compact layout that scrolls.

What it would cost you

  • A new dependency: lucide-react, for the icons.
  • About 240 KB of fonts: Space Grotesk (variable) and JetBrains Mono 500/700, both SIL Open Font License, with the licence texts beside the files. Browsers only download them when Deck Mode is on.
  • About 18 KB more JavaScript (gzipped) for everyone: the build goes from about 322 KB to 341 KB gzipped, because Deck's components are imported statically. They could be lazy-loaded if you prefer.
  • About 3,500 new lines, about 3,000 of them in src/components/deck/ and src/themes/. Changes to existing files are small branches, like the win95 ones.

Commits

  1. Theme, fonts and menu toggle
  2. Building blocks, Lucide icons and the MiniDisc loader
  3. Main screen, track table and transport bar
  4. Welcome screen and footer
  5. Settings section labels and recognition status captions
  6. Comments follow the panel's rename to "About this device"
  7. Device name as a real button inside its heading (screen readers keep the heading), JetBrains Mono weights that exist, spelling

Each commit builds on its own. The meter's "used" figure is worked out as total minus free, in the same units as the remaining time, rather than read from disc.used, which is still reported in raw units (fixed separately in #115). So this PR doesn't depend on that one.

No new images: the MiniDisc glyph and loader are drawn in code, and the existing minidisclogo.svg and md_lock.svg are recoloured with CSS under Deck Mode. The only new binary files are the three fonts.

Tested on a Sony MZ-N1 over USB (connect, About this device, playback with the ticker and seek strip, keyboard in the track list, rename, upload, a half-width window, Deck off and on) and on MockMD (1280×900 and 720×640, 18 tracks, every dialog, the Homebrew view, Exit and reconnect, Retro on and off). The MZ-N1 drops USB when its disc is ejected, so the "no disc" state was checked in code only.

Deck finds parts of the stock track rows by their tss class names (rowClass, indexCell, formatBadge and a few others), so renaming those rules would need a matching change in src/components/deck/.

🤖 Generated with Claude Code

iconscious and others added 11 commits November 10, 2026 23:45
… track modes

Clicking the device name, or the new "About this Walkman" menu item, opens a
panel describing the connected recorder: model, manufacturer and USB vendor
and product IDs, the disc's size, free space and protection, and how many
tracks are recorded in each mode (SP, MONO, LP2, LP4).

The device name is a button inside the heading, so it can also be reached
and opened from the keyboard. The panel works in the standard look and in
Retro Mode. The manufacturer and USB ID rows appear for NetMD devices
connected over USB; other services show the model, disc and tracks.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds an optional "Deck Mode" look, switched from the main menu. It is off by
default and is exclusive with Retro Mode: turning one on turns the other off.

This commit adds the theme (amber on charcoal, always dark) and its fonts,
bundled locally: Space Grotesk (variable) and JetBrains Mono 500/700, both
under the SIL Open Font License (licence texts beside the font files). The
shared MUI defaults move from app.tsx to src/themes/commons.ts unchanged, so
the standard themes and the Deck theme use the same base.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds the pieces the Deck screens are built from (src/components/deck/common.tsx:
panel, key, LCD window, labels, notice, the shared type scale and the
compact-window breakpoint), Lucide glyphs for the menus, and a MiniDisc loader
that stands in for MUI's spinner.

Stock files change only an import line: their Material icons and spinner now
come from deck/icons.tsx and deck/loader.tsx, which draw the Lucide glyph or the
MiniDisc loader under Deck Mode and the original Material icon or MUI spinner
otherwise, so the standard look is unchanged.

New dependency: lucide-react.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Deck main screen: a device card (model and the About this Walkman rows,
the heading opens the panel), a disc card with a capacity meter and free time
per recording mode, the track table, and a transport bar with a two-line LCD
ticker and a seek strip. The Homebrew view is framed in a Deck panel.

Keyboard: the track list is one Tab stop with a roving focus; Up/Down/Home/End
move, Space selects (Shift+arrows extends), Enter plays a selected track,
Shift+F10 or the Menu key opens the row menu, and Alt+Up/Down moves a track
through the same path as dragging. Focus rings are visible on every control.

Small windows (under 1024px wide or 760px tall) fold the device card into one
line and tighten the layout; the screen then scrolls.

The meter's "used" figure is worked out as total minus free, the same units as
the remaining time on every service.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Deck Welcome screen (service picker, connect key with the MiniDisc loader,
browser notices) and a full-width footer that keeps the copyright credits and
links to the guide, About, Changelog, GitHub and Donate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Under Deck Mode, Settings section headers become mono labels over a hairline
and a note explains that colour theme and stretch settings apply to the
standard look only (Deck is always dark and fills the window). Song
Recognition's status text becomes a one-line mono caption.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Not every MiniDisc recorder is a Walkman: the panel also appears for decks
and other brands. The menu item, the tooltip on the device name and the
Retro menu item now say "About this device".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Follows the panel's rename; comments only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…and in the model name

Adds the USB vendor IDs netmd-js knows for Panasonic (04DA), Kenwood (0B28)
and Buffalo (0411). Some players report another maker's vendor ID (Aiwa's use
Sony's), so a brand at the start of the model name now wins over the vendor ID.
Every device in netmd-js's list now shows the brand its name starts with.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…n file

The mode-name comment now says how it differs from the track list's badge
(mono shows as SP there). The Retro dialog imports DeviceInfoRow from
device-info-rows.ts, so the two dialog files no longer import each other.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…spelling

- The device card's heading keeps heading semantics, with a real button
  inside it (instead of role="button" on the h2), so screen readers hear the
  device name as a heading and a button. The button takes the theme's amber
  focus ring; the heading no longer clips it.
- JetBrains Mono labels asked for weight 600, which isn't bundled (500 and
  700 are), so browsers already drew 700; they now say 700. Space Grotesk is
  variable and keeps its 600s.
- Settings note: "color theme", matching the setting's own label.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant