Dashboard themes
Make your own dashboard theme (colours, wallpaper, a dock or a desktop of apps), wear one from the gallery, or list yours for free or for a price.
Where: Dashboard → Themes · Settings → Appearance
A dashboard theme changes the place you use yumu from, not your public page. Only you see the theme you wear. Open Themes from the sidebar (or Settings → Appearance → open themes) to make one, try one on, or wear one from the gallery.
- 1Press make a theme. The studio opens and the dashboard around you becomes the preview: every change shows as you make it.
- 2Pick a layout (sidebar, dock or desktop), your colours, a wallpaper and the type.
- 3Optional: rename tabs and pick their icons, fill the slots, add CSS extras.
- 4Got a theme file (a
.jsonsomeone shared)? Press open a theme file in the studio and it fills everything in. - 5Press save and wear. To share it, press list: link only, or in the gallery, free or with a price.
Layouts (chrome)
| Layout | What you get | On a phone |
|---|---|---|
| Sidebar | The usual list down the side, in your colours. Side: left or right. | The usual menu. |
| Floating | The same sidebar, lifted off the edge as a glassy card over your wallpaper. Side: left or right. | The usual menu. |
| Icon rail | A slim strip of app tiles, grouped, with names on hover. Search and settings at the foot. Side: left or right. | The usual menu. |
| Top bar | A menu bar across the top: one menu per group (your people, your page, play, the store, your account), each opening its apps in a grid. | The usual menu. |
| Dock | A dock of app tiles. Edge: bottom, left or right. Icons: a folder per group (each opens its apps in a grid) or every tab. Size: small, medium, large. Names: on hover or always. | The usual menu. |
| Desktop | Every tab is an app icon on your wallpaper; the tab you open is a window. Windows: one window, or a real desktop (see below). Icons: small, medium, large, in one to three columns. Title bar: soft (with window dots), classic (a bar in your accent) or plain. Taskbar: bottom or top, with search, settings, the listen chip and a clock. | The usual menu, so every tab stays easy to tap. |
A real desktop
Set a desktop theme’s windows to a real desktop and the dashboard works like a computer. Click an app and it opens in its own window. Drag the title bar to move a window, pull an edge or corner to resize it, double-click the title bar to make it fill the screen, and use its buttons to minimize, maximize or close it. The taskbar shows every open window (click one to bring it forward, click it again to tuck it away), and the yumu button in the corner lists every app. Windows stay where you left them next time you open yumu on that browser.
- Only the window in front shows the page live. The others keep a picture of what they last showed; click one and it comes back to life.
- The terminal is an app too: on the desktop, in the app list, or press Ctrl `. Type
helpto see what it can do:open messagesorcd closetopens an app,lslists them,whoami,theme,clearand more. A few commands aren’t on the list. Have a look around. - The terminal is pretend: nothing you type runs anywhere or leaves the page.
- In CSS extras, style windows with
.yen-desk-window(itsheaderis the title bar) and their buttons with.yen-desk-btn.
Colours and other settings
accent
any colour
--dash-accent.background, sidebar and bars, panels
any colour
--dash-bg, --dash-side, --dash-panel: the page, the chrome, every card, and the listen bar. On a desktop theme you can minimize Listen into the taskbar next to the clock; style that chip with .yen-listen-tray and the floating bar with .yen-listen-mini.text, quiet text
any colour
--dash-ink and --dash-muted. If either is too faint on your background or panels, a readable colour is used instead (text needs 7:1 contrast, quiet text 4.5:1).lines
any colour
--dash-hairline, for borders you add yourself (the desktop window uses it too).corners
0–32px
Default: 22px
--dash-radius, the roundness of panels and the desktop window.wallpaper
the café, a gradient, or a picture (https)
type
Geist, Yen Display, Geist Mono, Caveat
Default: Geist
tab names and icons
an icon from yumu’s set, a name up to 18 characters
"house" or "floppy".window title, caption
up to 400 characters
clock
on or off
Default: on
panels
solid, glass, outline, paper
Default: solid
shadows
none, soft, deep
Default: soft
app icons
coloured tiles, glass, outline, just the icon
Default: coloured tiles
group colours
five colours
pattern
none, dots, grid, stripes, grain, stars; strength 0–60%
Default: none
CSS extras
Up to 8,000 characters of CSS, for the details the settings don’t cover. It goes through the same cleaner as page CSS and is scoped to the dashboard, so .bg-dash-panel { … } means panels in your dashboard and nothing else.
- No
@import, and links only tohttps://pictures ordata:image. !importantis removed,z-indexis capped at 40, and anythingposition: fixedmust also bepointer-events: none(decoration, not a fake button).- Rules for
:root,htmlorbodyare dropped: a theme styles the dashboard, not the sign-in, your public page, or the rest of the site. - yumu’s own search, settings, your account menu and sign-out, the phone header, the dock’s and taskbar’s buttons, and call controls always keep their own size, place and visibility, whatever the CSS says.
- No JavaScript, anywhere. Themes are data: colours, a picture, some text, some CSS.
Worked example: Desk
The official Desk theme in the gallery is a desktop-of-apps theme made only with the settings above, no CSS: try it on, then press make a theme to build your own the same way.
| Setting | Value |
|---|---|
| layout | desktop, windows: a real desktop |
| colours | accent #ffd38a, background #1a130f, sidebar and bars #221916, panels #2b201b, text #fff8ef, quiet text #d8c8b8, lines #4d3a30 |
| corners | 14px |
| wallpaper | picture https://yumu.gg/postcards/library.jpg, brightness 60%, blur 4px |
| panels and shadows | glass, deep |
| pattern | grain at 12% |
| group colours | #ffb38a, #e6b8ff, #ffd38a, #a8d8a0, #a9c4e0 |
| tab icons | house for home, message for messages, telescope for explore, headphones for listen, brush for customize (named “my page”), shirt for closet, bag for momo’s shop, settings for settings |
| window title | <b>yumu</b> desk |
| caption | rainy night, lamp on <i>♡</i> |
Sharing and selling
- Link only: anyone with the link can try it on and wear it.
- In the gallery: listed for everyone under Themes, free or with a price. Prices work like paid templates: the buyer pays you directly in crypto, and you need a payout wallet in Settings first.
- Wearing a theme gives you your own copy: it keeps working if the author edits, unlists or deletes it (wear it again to get their latest).
- Themes can be reported. Three reports hide one until staff look at it.
How do I go back to a normal colour?
Pick any colour in Settings → Appearance, or press take my theme off under Themes.
Do other people see my dashboard theme?
No. It’s your dashboard. Your public page has its own look in Customize.
related
Still stuck?Ask in our Discord