Screen layout mockup
![[Mockup placeholder: Full-screen player annotated from back to front: wallpaper, lyrics, top controls, queue, and bottom player bar]](/uploads/mockups/main-player-layout.png)
[Mockup placeholder: Full-screen player annotated from back to front: wallpaper, lyrics, top controls, queue, and bottom player bar]
The player is built in layers
The page is a full-screen workspace. Wallpaper is the back layer, lyrics are rendered across the main surface, and controls sit above the lyrics so they can be used without leaving the song.
Loading, audio permission, toast messages, and other temporary states appear as overlays. They do not replace the player; they inform you about what the system is doing.
Read the layout from back to front
Wallpaper
The visual background. Change it from Display settings.
Lyrics surface
The main surface for singing. It follows playback timing.
Control surfaces
Search, mixer, queue, and player controls are placed above the visual layer.
Temporary overlays
Loading, permission, countdown, and notifications appear only when their event occurs.