[dylanjeffers]

Summary

Community feature request from Discord #feature-requests (toby / remixify, Jun 2-3, 2026): "add options to configure the embed a little more ... size, light/dark modes".

Sizes already exist (flavor=card|compact|tiny). This adds a dark color option:

• Embed player: new theme query param. theme=dark swaps the artwork-tinted background for neutral dark surfaces (Harmony default-dark surface1 for the card, surface2 for collection rows). Anything else, or no param, keeps today's artwork color, so existing embed codes are unchanged.
• Web embed modal: new Player Color control (Artwork / Dark) that writes &theme=dark into the embed code and updates the preview. Hidden for the Tiny size, which has no background.
• Small hexToRgb util so the dark colors use the rgb() form that Card and shadeColor parse.

Test plan

• jest for hexToRgb
• eslint clean for packages/embed; tsc and eslint clean for packages/web
• Manually: open the embed modal for a track and an album, toggle Player Color, confirm the preview and copied code; load /embed/track/<id>?flavor=card&theme=dark and ?flavor=compact&theme=dark

Open questions

• The request also asked for a light mode. That needs dark text, a different play button treatment and scrubber colors on a white card, which is a design call, so I left it out.
• Harmony's default-dark surface1 and surface2 are very close (#0F0F0F / #141414), so collection rows are subtle on the dark card. Happy to pick different tokens.

---

Generated by Claude Code

[changeset-bot]

⚠️ No Changeset found

Latest commit: 21dac04

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR