Modbot Docs

Appearance

The light and dark themes, Desk and Headset, the spacing at a desk, and how Modbot works on a phone.

Modbot's appearance is set per browser, not per account. Change it on your laptop and your phone keeps its own setting. Nothing here is a permission and nothing here changes what anybody else sees.

The controls are at the top right of every page: Desk and Headset, and a button that swaps the theme. On a phone and in a headset they are at the foot of the Menu. The spacing at a desk is in Your account.

They are also in the command palette. Press Ctrl + K (or ⌘ K) and type "theme", "headset", "desk" or "spacing".

Theme

Dark and light. Dark is the default.

Desk and Headset

Where you are reading Modbot. A phone is picked out on its own, so it is not one of the choices.

DeskThe default. The sidebar on the left, and your choice of spacing.
HeadsetFor the web app seen through a VR headset, whichever theme you use.

Spacing at a desk

In Your account, under Spacing at a desk. It changes row heights, control sizes and text size together, and only at a desk: a headset and a phone have their own sizes.

DenseThe default. The most rows on screen at once, for scanning a member list of tens of thousands.
ComfortableTaller rows and larger text. Easier over a long session.

Until September 2026 this was a three-way switch in the top bar, with VR as the third choice. A browser that had VR picked opens on Headset.

What Headset changes

Headset is not "Comfortable, but more". A headset shows a desktop through a virtual panel at a low effective resolution, and a laser pointer is much less precise than a mouse, so it changes the layout as well as the sizes.

The layout:

  • One column, and no sidebar. The sidebar's labels do not fit at a headset's text size, so the pages are behind Menu in a bar at the foot of the screen, as on a phone, whatever the size of the window. The bar's buttons are larger than a phone's.
  • No keyboard hints. The keys beside each page and in the search box are left out, because in a headset the keyboard is not to hand.
  • Modbot opens on Live, which is what a moderator in VR is there to watch. Members is still one tap away in the menu, and a link somebody pasted opens where it points.
  • Live stacks each instance's picture above its list of people, one instance under another.

The sizes:

DenseHeadset
Row height34px56px
Height of a button or a box you type in30px48px
Text13px, with 12px for small print18px, with 16px for small print
Lines and borders1px2px
Lines on a chart2px3px

It also pulls the colours back from the extremes: the darkest background is lifted off black and the lightest off white, because a headset panel blooms around a hard edge, and grey text is lightened so it is still readable at that resolution.

Corners are rounded a little more, which is the one change that is only there to keep everything looking of a piece at the larger size.

Nothing else changes. Every page, every column and every button is the same one; there is no separate headset version of a screen to get out of step.

If your choice does not stick

Modbot remembers all three in your browser's own storage. A private window, a browser set to clear site data when it closes, or one that blocks storage for the site, all forget it and start again at dark, Desk and Dense the next time. Nothing else about Modbot is affected.

On a phone

The whole app works on a phone. There is no separate mobile version and no page you can reach on a laptop that you cannot reach on a phone.

Three differences from a wide screen:

  • The sidebar becomes a sheet. Tap Menu at the foot of the screen for the pages, your account, Desk and Headset, the theme, and sign out.
  • There is a bar at the foot, not more controls at the top, so the things you use most are where your thumb already is: Menu, Search and Actions.
  • Tap targets are larger, by the same reasoning as Headset. Dense and Comfortable are both raised to a size a fingertip can hit; Headset keeps its own sizes, which are already larger.

Actions

Actions lists everything the screen you are on can do, and each row does it when you tap it. It is the same list as the keyboard shortcuts — on the audit log it holds Open the person the selected row is about, which has no other control — so nothing in Modbot is reachable only from a keyboard.

Tables

A members row has a name, a Discord account, roles and two dates, and Modbot does not drop any of them to make the row fit. The table scrolls sideways instead, and the name column stays put while the rest of the row moves under it, so you always know whose row you are reading.

Tap a row to open the person, where everything in it is written out in full.

Popups

A person, world or instance popup fills the whole screen on a phone, with the identity at the top and the tabs under it. Everything else works as it does on a laptop — see Popups.

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.

On this page