A review of the phone experience (the issue) found a desktop page made
smaller. What changes:
feat:
- The player bar is one row on a phone (cover, title, play and next, a thin
line of progress) and is not there while nothing plays. A tap or a swipe up
on it opens the full-screen player.
- The Back gesture closes the full-screen player instead of leaving the page
under it; a swipe down closes it too. The full queue is listed on a phone.
- The queue is kept in the browser: a reload, or a tab that Android throws
away, comes back paused on the same song at the same second. It belongs to
the person signed in and is forgotten on sign-out.
- Tabs have icons; the page starts at its top on a new route and back goes to
where the list was; a swipe on the page no longer reloads it.
fix:
- The player now knows when the system pauses the audio (another app, a
headset), so the button and the lock screen no longer say it plays.
- The lock screen has a working seek bar and the right play/pause state.
- The player bar was not hidden by max-sm:hidden: its grid rules were outside
the Tailwind layers and won. They are in the components layer now.
- Song rows give the title the room on a phone (no number column).
- The album header is centred and the greeting is smaller on a phone; recent
songs on Home show the artist.
- Thumbnails ask for the small cover (300 px) and not the 1000 px one.
- Pages use dvh, the viewport covers the notch, and the tabs keep clear of
the gesture bar; the update notice no longer sits on the bar.
- No grey tap flash, no double-tap delay, no image menu on a long press.
- the favicon and the four PNG icons are in the colours of the current theme (#08161d ground, #37e0c2 wave)
- IT: Rimuovi for every remove, Elimina where a file is deleted
- EN: Create (not Make) for an invite, a playlist and a token; '{{genre}} mix' in lower case
- phone tabs: the Friends bar is amber only when Friends is the open tab
- README: songs in the prose, tracks only in paths and fields
- a short description in the page head
The first piece of the new look of the web app.
- The Sonda theme takes the new palette (a deep blue ground, a lighter tone
for panels instead of shadows, teal for the action). Every theme gets a
--friend colour for what comes from another Sonda server, checked for
contrast on the page and on a panel and for a hue that is not the primary
one.
- Figtree is the only font; Fraunces is gone, also from the full-screen
player.
- The menu is words and a dot: the dot of the open page is the colour of this
server, and the dot of Friends is always the colour of what comes from
elsewhere. There is nothing to fold, so the fold button and its setting are
removed.
- The shell is flat: the menu has a line on its right, the page has no panel
around it, the player is a band under everything.
- A missing cover is the rings of Sonda on a colour taken from the album, the
same one every time; a friend's album gets another colour than this
server's album with the same id.
- The switch is a pill with a round knob and the outline button is a line.
- A web app manifest with the name, the colours, the display mode and the icons (also a maskable one), so a browser offers to install it; Settings has an Install button where the browser lets the page ask.
- A service worker keeps the files of the app (the page, its scripts and styles, the manifest and the icons) so it opens at once, and shows its own page when the server cannot be reached. It never touches /api/: nothing from the API is kept, answered from a cache, or asked for by the worker. Files that failed, and anything that is not a file of the app, are not kept; the scripts it keeps are capped.
- A new version waits until the page says it may take over: a line says a new version is ready and its button reloads the page after the new worker took over.
- The server gives the manifest its type (application/manifest+json); the worker and the manifest are asked again every time, and the policy of the page needs no change.
- The logo, sONDA with an O that is a sea wave, traced to vector paths: the s in the text colour and the rest in the accent colour of the theme, in the sidebar and on the sign-in page; folded, the sidebar shows the wave alone. The favicon, the touch icon and the 192 and 512 icons are the wave on the blue of the logo (the old favicon was left by the build tool).
- Touch targets: buttons, fields, icon buttons and small links are 44 pixels tall; the time of the player is 13 pixels; the seek bar has a taller hit area.
- A phone: the menu is one row that scrolls sideways and the player is two lines (what is playing and the controls, then the position), so the page keeps the screen.
- Cards that are links lift a little and their pictures grow inside the frame on hover, unless less motion is asked for.
- The provider cards have a ground of their own.
- Vite, React 19 and TypeScript in web/, Vitest with jsdom and Testing Library
- Tailwind v4 and shadcn/ui, with Figtree and Fraunces bundled locally
- npm run gen:api builds src/api/schema.d.ts from the OpenAPI spec
- dev server proxies /api to sondad (SONDA_URL, default 127.0.0.1:8080)
- mockFetch test helper that refuses unmatched requests