# Theme editor

> Every color, key shape, gradient, corner and animation knob for a single custom theme.

URL: https://wmkeyboard.pages.dev/themes/editor/
Section: Themes & appearance

The theme editor is where a single custom theme gets built: every color, the key shape, optional gradients, corner-radius overrides, and a live-animated background if you want one. Every field here applies and saves the instant you touch it. There's no separate save step.

  ![The theme editor, with the live preview pinned above the color and shape controls.](@assets/screens/themes/editor-live-preview.webp)

## Creating a theme

Appearance / Keyboard themes

A custom theme's card opens the editor from its pencil, and the card's miniature grows into the editor's own preview on the way. The editor is headed with the theme's name rather than with the words "Edit theme", so the card you tapped and the page it opened read as one thing. Rename the theme and the heading follows.

Every change saves as you make it. Once you have changed something, the undo arrow under the preview lights up, and after an undo the redo arrow beside it does too. They cover everything on the page, the theme's looks included: adding or deleting a variant is a step too. Changes made within about a second of each other undo together, so a slider's drag or a name typed out is one step rather than dozens. The history holds 30 steps and lasts until you leave the editor. A photo is the one thing an undo can't always bring back, because picking a new background deletes the old picture's file.

**Create theme** on the gallery screen makes a new custom theme called "My theme". It's seeded from a blue swatch and generated light or dark to match whatever the phone is set to right now. The new theme becomes the active keyboard theme, then the editor opens on it.

Built-in themes can't be edited in place. Their card shows a pencil instead, which copies the built-in into a new custom theme named "*(theme) copy*", makes the copy active, and opens the editor on the copy. The original built-in is untouched. The **Default (system)** card has no pencil at all. It's generated live from your device's Material You color scheme rather than stored anywhere, so there's nothing for this editor to open. See [Theming overview](https://wmkeyboard.pages.dev/themes/overview/) for the gallery itself and how Default, Material You, and the built-in set fit together.

Importing a `.wmtheme.json` file (from the gallery's Import button or by opening the file itself) adds it to Your themes and switches the keyboard to it immediately, without opening this editor. See [Sharing themes](https://wmkeyboard.pages.dev/themes/sharing/) for both ways to import.

## The Looks row

Straight under the preview, before the name field, sits a **Looks** row: one chip per look this theme carries, an **Add look** chip, and (while you have a look other than the first one open) a bin icon that deletes the one you're editing. Everything below that row edits the open look and nothing else, so a theme with four looks is four full colour sets, switched between with a chip.

A theme starts as one look, and the row is just the one chip until you press Add look. Add a second and a **Group name** field appears below the chips: that's the label the gallery card shows over the dots. Add look copies the look you have open, so the new one starts where the old one left off, and it greys out after twelve extras (thirteen looks in all).

[Theme families and looks](https://wmkeyboard.pages.dev/themes/families/) is the full story: what a family card looks like in the gallery, the Grouped/Separate choice, and what happens to a family when you copy, export or delete it.

## Starting from a color

At the top of the editor, a **Dark theme** switch and a row of swatches let you regenerate every color at once from a single seed:

  ![Start from a color: the Dark theme switch and seed swatch row.](@assets/screens/themes/editor-seed-swatches.webp)

Tapping a swatch, or flipping Dark theme, recomputes the board, key, accent, and popup colors from that seed and shade. It preserves everything that isn't seed-derived, so a reseed doesn't erase work you've done elsewhere in the editor. Your background image and its opacity/blur, both gradients, the key shape, the key border color and width, the gesture-trail color, all three corner-radius overrides, and the animation type and speed all carry over untouched. Anything you hand-picked that *is* seed-derived (a manually recolored key-text or popup color, say) gets overwritten, since there's no way to tell "kept the default" apart from "picked to match."

## Following your wallpaper

Under the seed swatches, **Follow wallpaper colors** makes the theme change color with your wallpaper, the way the Default theme does with Material You on. It's off for a theme you make, and it needs Android 12 or later, because older phones have no wallpaper palette to read.

The theme keeps its own colors. The keyboard moves them onto your wallpaper's palette as it draws them, so turning the switch off gives you the stored colors back, and the color rows in the editor always show the stored ones. How the colors move depends on where the theme came from:

- **Most themes** (your own, copies of built-ins, Gboard, Rboard and HeliBoard imports) keep how light or dark each color is and take the wallpaper's hue. Greys go to the wallpaper's neutral tones, colors go to its main accent, and a color on the far side of the color wheel from the theme's accent goes to the wallpaper's third accent, so a two-color theme stays two colors. Because the lightness stays put, text that was easy to read stays easy to read. Pure black and pure white stay as they are.
- **FlorisBoard themes written in Material You colors**, such as FloriStyle and Gboardish, remember which Material You color each part used. They follow the wallpaper exactly as they would in FlorisBoard, and the switch is already on when you import one. A color you change in the editor stays the color you picked.

Tapping a seed swatch or flipping **Dark theme** keeps the switch as it is.

## Options

Appearance / Keyboard themes / (edit a theme)

The rest of the editor is grouped into sections, each opening the color picker when you tap a row.

### The color picker

Every color row in the app opens the same dialog, here and over in the tool screens:

- A **wheel** for hue and saturation. Hue runs around it, saturation runs outward from the middle, and the ring follows your finger from the moment you touch it.
- A **Brightness** bar, plus an **Opacity** bar on the fields that support translucency. Each bar is painted in the colors it's about to hand you, and the opacity one sits on a checkerboard so you can see how much is showing through.
- A **preview strip** across the top, split down the middle: the color you opened with on the left, the color you have now on the right. Tap the left half to throw away the change and start again.
- A **Hex** field taking three, six or eight digits, with or without the `#`. Six digits keeps whatever opacity you already set rather than resetting it to solid.
- A row of **presets**, the same seeds as the swatch row above. Tapping one changes the color and leaves your opacity alone, so a scrim you've already made translucent stays that way.

The button in the dialog's title swaps the wheel for **Hue** and **Saturation** bars, for when you'd rather read exact numbers or move one channel at a time. Those bars are also the ones TalkBack can set. In landscape the wheel sits beside the bars instead of above them.

From Android 12 the dialog has two tabs. **Custom** is everything above. **Palette** offers your wallpaper's Material You colors: five swatches for its Primary, Secondary, Tertiary, Neutral and Neutral variant palettes, and a **Tone** bar from 0 (black) to 100 (white) that sets how light all five are. A theme that follows the wallpaper opens on this tab. The shade you pick is saved as a plain color and keeps your opacity. On a theme that follows the wallpaper the keyboard draws that exact shade, rather than moving it onto whichever palette and tone its other colors would take. A new wallpaper moves it with everything else.

### What's what

Every row in the editor paints one part of the keyboard, and the names are only obvious once you know which part is which. The two drawings below put a number on each part. The tables under them say which row colours it.

![A dark keyboard with numbered markers on the board, the toolbar row, the suggestion strip, a letter key and its hint, a pressed key, a bordered key, a modifier key, the enter key, the space bar and the navigation bar.](@assets/themes/anatomy-keyboard.svg)

| | Part | Rows that paint it |
|---|---|---|
| 1 | **Board**: everything behind the keys, including the gaps between them | Board › Background, Gradient background, Background image |
| 2 | **Toolbar row**: the tools, each on its own circle | Toolbar, strip and popups › Toolbar: Toolbar background, Tool circles, Tool icons, Active tool circle, Active tool icon, Tool outline; shape and size under Tool background shape and Corners |
| 3 | **Suggestion strip**: the word candidates. The middle one is the primary, the others the runner-ups | Toolbar, strip and popups › Suggestion strip: Suggestion strip (the fill), Suggestion text (the primary), Other suggestions and Other suggestions size (the rest), Suggestion pills and Main suggestion pill (the boxes behind the words, with Coloured suggestions on); Panels & suggestions › Dividers (the hairlines between them) |
| 4 | **Letter key** and its label | Keys › Letter keys, Key text; the sheen under Key gradient; the picture under Key textures › Letter keys |
| 5 | **Key hint**: the small alternate in the corner | Keys › Key hint text; its size under Layout › Key hint font size |
| 6 | **Pressed key**: the flash while a key is held | Keys › Pressed key; the picture under Key textures › Pressed keys |
| 7 | **Key border** | Keys › Key border and Border width |
| 8 | **Modifier key**: shift, delete, `?123`, the globe | Keys › Modifier keys, Modifier key text |
| 9 | **Enter key** | Keys › Enter key, Enter key icon |
| 10 | **Space bar** | Takes the letter-key colour and texture; give it its own under Single-key styles › Space |
| 11 | **Navigation bar**: the band the phone's gesture bar sits on | Board › Navigation bar |
| 12 | **Key shape and corners** | Keys › Key shape; Corners › Key corner radius; the lift under Key shadow |

![Three popups: the key preview bubble rising out of a pressed key, the press-and-hold alternates popup with one character highlighted, and a list menu with one row selected. Numbered markers point at the fill, text, outline, shape, highlight, spacing and shadow.](@assets/themes/anatomy-popups.svg)

| | Part | Rows that paint it |
|---|---|---|
| 1 | **Popup fill**: the bubble that rises out of a pressed key, and the sheet the press-and-hold alternates sit on | Popups › Popup background; the picture under Key textures › Key preview popup |
| 2 | **Popup text**: the character in the bubble, and every alternate that isn't under your finger | Popups › Popup text |
| 3 | **Popup outline** | Popups › Popup outline and its width row |
| 4 | **Popup shape and corners** | Popups › Popup shape; Corners › Popup corner radius |
| 5 | **Popup height**: how tall the bubble is | Layout › Popup height; where it sits is Popup placement |
| 6 | **Selected highlight**: the alternate your finger is on, and the selected row of a menu | Panels & suggestions › Selected highlight |
| 7 | **Selected text**: the character or row on that highlight | Panels & suggestions › Selected text |
| 8 | **Spacing between alternates**: the room around each character, which is also the gap between the highlight and the popup's edge | Not a theme field. It's Key press / Alternate keys / Alternate key spacing, and the characters' size is **Alternate key size** beside it |
| 9 | **Popup shadow** | Panels & suggestions › Popup shadow |
| 10 | **Menu shape**: the list menus' own outline | Popups › Menu shape |

The popup rows do nothing to a bubble you have coloured by hand under Key press / Key popup: **Popup color** and **Popup text color** there win over the theme, and their reset controls hand the bubble back to it. A [single-key style](#single-key-styles) wins over both, for its one key.

### Board

- **Background** is the board's base color. It supports alpha, which starts to matter once a background image is set. See [Image backgrounds](https://wmkeyboard.pages.dev/themes/backgrounds/) for the image picker, crop, opacity, and blur controls that live in this same section.
- **Gradient background** is covered under [Gradients](#gradients) below.
- **Navigation bar** fills the band below the bottom key row, where the phone's own gesture bar or navigation buttons sit. Auto leaves it on the board, the same as the [suggestion strip](#toolbar-strip-and-popups). Only the system's own band is painted. The extra space that **Bottom padding** (under Layout & size / Size and position) adds above it belongs to the keyboard and stays on the board. On a phone with hardware navigation keys there is no band at all, so the color has nothing to paint and nothing changes.

  On Android 15 and later the keyboard draws that band itself, so a gradient, image or animation carries through it. On Android 14 and earlier the keyboard window stops short of the bar and can only hand the system one flat color, which it does: the **Navigation bar** color if you set one, otherwise the far end of the gradient, otherwise the board color. Either way the bar follows the theme instead of staying whatever color the phone picked, and the system's hide-keyboard and language-switch glyphs flip between dark and light to stay readable on it.

### Glass

Appearance / Keyboard themes / (edit a theme) / Glass

**Frosted glass** turns the theme's surfaces into see-through panes over a blurred backdrop, with a rim of light and a little grain. The section opens with a **Presets** row (Frosted, Clear, Mica, Smoked, Liquid), **Kind of glass** (Frosted, or Liquid with its **Refraction** and **Color split** sliders), then **Blur behind the keyboard** (Android 12 and later; the app under the keyboard shows through the board blurred), **Blur strength**, **Board opacity without blur**, a row of **Glass surfaces** chips, **Behind the glass** (Auto, Image, Wallpaper or Nothing) with **Part of the wallpaper** and, on Android 12 and below, a **Use your real wallpaper** permission row, the three backdrop sliders (**Backdrop blur**, **Backdrop saturation**, **Backdrop brightness**), **Rim**, **Rim color** and **Grain**. [Frosted glass](https://wmkeyboard.pages.dev/themes/glass/) explains what each does, what the phone has to support, and how the built-in Frost family uses them.

### Keys

- **Key shape**: a row that opens a picker with **None** and all twelve shapes listed by name, each drawn beside its name at key proportions and at this theme's own corner radius, so you can see what you're choosing before you choose it. The full list, and which shapes react to the radius slider, is under [Key shapes](#key-shapes) below.
- **Letter keys** sets their color, and carries an optional **Key gradient**, a subtle sheen painted over letter keys only (see [Gradients](#gradients)).
- **Key text**, **Modifier keys**, **Modifier key text** (falls back to Key text when left on Auto), **Key hint text** (the small long-press alternate in a key's corner; Auto draws the key's own text color at 55% opacity, and this one keeps alpha so you can pick a translucent hint in another hue), **Enter key**, **Enter key icon**.
- **Make every key match the letter keys** gives the modifier keys (Shift, delete, `?123`, the globe, the emoji and tool keys) and Enter the letter keys' background and text colours in one step, for a board where every key looks the same. It is one undo step, and each colour stays editable afterwards.
- **Pressed key** is the color a key flashes while held. Auto derives it from Letter keys.
- **Key border** stays off (Auto, no visible border) until you pick a color. A **Border width** slider (0–3dp) then appears, starting at 0dp. Picking a border color on its own shows nothing until you raise the width too.

#### See-through keys

Keys don't need a separate opacity slider: the colour itself carries it. **Letter keys**, **Modifier keys** and **Enter key** all open the picker with the **Opacity** bar, and the hex field takes eight digits, so `#80303338` is the stock key at half strength. Pull the opacity down and the board shows through the key, gradient, photo or animation included, and the gap between keys stops being a gap. Setting a background image does the first step for you: it drops opaque key and modifier colours to about 62%. A key you can see through casts no [shadow](#key-shadow), whatever Key shadow says.

That is a translucent face. For no face at all, pick **None** under [Key shape](#no-key-shape): the labels then sit straight on the board, and only a pressed or latched key draws anything behind its label.

### Key shapes

The picker lists **None** first, then the twelve shapes in this order. The five simple ones come first, then the seven decorative ones:

| Shape | What it looks like | Reads the radius slider? |
|---|---|---|
| None | No shape at all, just the labels on the board. See [No key shape](#no-key-shape) below | Only for the flash while a key is pressed |
| Rounded *(default)* | The ordinary rounded rectangle | Yes, 0–28dp |
| Square | Four sharp corners, no rounding at all | No |
| Pill | A full stadium, rounded to half the key's height | No |
| Cut | Corners chamfered off at 45° | Yes, but clamped to 2–14dp |
| Squircle | A superellipse, the same curve family as an iOS app icon | No |
| Arch | Round across the top, nearly square at the bottom | No |
| Leaf | Top-left and bottom-right fully round, the other two nearly square | No |
| Slanted | A parallelogram, both vertical sides leaning right | No |
| Hexagon | Points at the left and right, flat top and bottom | No |
| Scalloped | A rim of even bumps, like the edge of a biscuit | No |
| Ticket | Corners bitten inwards by a circle, like a cinema ticket | No |
| Circle | A round cap centred in the key, like a typewriter's; wide keys (space, enter) keep a stadium | No |

The shapes that ignore the slider aren't being lazy about it. Their whole look is a proportion of the key rather than a corner size, so they measure themselves off the key's own width and height. The arch is always half the key's height. The hexagon's points are always a sixth of its width. The scallops count out at roughly the same size whether it's a letter key or a spacebar, up to 64 along a side; a box only a few pixels tall, such as a panel sliding open, is drawn as a plain rectangle until it is big enough for bumps. Wire them to a 0–28dp slider instead and one end of it flattens them into plain rectangles.

Only the drawing changes. Touch targets stay rectangular for every shape, so the gap between two hexagons still belongs to one key or the other, and nothing gets harder to hit.

Slanted is the one shape that draws slightly outside its key. A parallelogram kept inside the key would lose about a third of the width at the top and the bottom, which on a phone-sized key reads as a row of thin straps. So it leans half its slant into the gap on each side instead. Every key stays exactly as wide as it would be with any other shape, and the gap between two keys keeps its width. The gap just runs on a diagonal. Where there is no gap to lean into, the lean is trimmed to fit.

#### Key shadow

**Key shadow** lifts every key off the board, 0 to 16 dp. It's drawn by the platform from the key's own outline, so it follows whatever shape you picked.

**Key shadow colour** shows up once there is a shadow. Unset, it's the usual black; pick any colour, and lower its opacity for a soft glow rather than a hard edge. Themes imported from Gboard and FlorisBoard bring their own. Android 8 and older draw every shadow black whatever this says.

Two shapes stay flat however far you push it. Scallop and Ticket are concave, and Android tessellates a concave shadow through a path that pins the render thread hard enough for the system to kill the keyboard, so they keep the shape and lose the shadow. A key you can see through at all stays flat too, even at 90% opacity: the shadow fills the key's whole outline, and through a translucent face it reads as a lighter box inset in every key. That's what keeps a borderless theme looking borderless.

#### No key shape

**None** takes the shape away completely, which isn't quite the same as a see-through key color. A key at rest draws no fill, no border and no texture, so every label sits straight on the board, Enter and the space bar included. The Enter icon switches to your **Modifier key text** color while it has no fill of its own, since **Enter key icon** is picked to read on the Enter key's fill.

The keys still answer your finger. A pressed key flashes a rounded shape at your key corner radius, and an armed or locked modifier still lights up. A key you give its own face color under [Single-key styles](#single-key-styles) keeps that face, so a colored Enter key on an otherwise bare board is one style away. The keypads in the tool panels, like the calculator and the voice and handwriting rails, follow the same rule as the main keys.

**High contrast keys** and **Key outlines** in [Accessibility](https://wmkeyboard.pages.dev/accessibility/overview/) both bring rounded keys back while they're on. Keys without visible edges are exactly what those two settings are there to fix.

Only Rounded, Pill, Cut and Squircle shipped with the first version of the format. The other eight, Square among them, came later, and so did None. A theme exported with one of them won't import into a version of the app that predates it: the importer drops a theme whose shape name it doesn't recognise rather than guessing. Stick to Rounded, Pill, Cut, or Squircle in a theme you plan to share widely.

### Key textures

Keys can wear an image instead of a flat color. One picture for the letter keys is enough to theme the whole board. The modifier keys, the enter key, the space bar, the pressed state and the key-preview popup each take an optional image of their own, and each falls back sensibly when you don't set one: space reuses the letter texture, pressed draws the press tint over it, and the popup draws color-only rather than borrowing a key's image.

- Each texture row picks an image from your gallery. It's stored downscaled to 512px, so a camera photo won't bloat the theme file. Rows that have an image show it as a small thumbnail, the same way the background and press-effect image rows do.
- **Crop / Stretch / Tile** decides how the image fits a key. Crop keeps its proportions, stretch fills the key exactly, and tile repeats it at its natural size. Tile is the one you want for pixel-art.
- **Texture opacity** blends the image over the key color underneath. That color stays the base coat, and it's what high-contrast accessibility falls back to, since textures don't draw there at all.

Textures travel inside the theme file when you export it. An older app version imports the same file as a plain color theme and loses nothing else.

To find out how big to draw each texture, open **Image sizes and templates** in the **Board** section. It measures your keyboard and saves templates to draw on. See [Image sizes and templates](https://wmkeyboard.pages.dev/themes/backgrounds/#image-sizes-and-templates).

### Single-key styles

One key can carry a style of its own. The quickest way to choose it is **Pick on keyboard**: the preview stops typing, and pressing any key on it opens that key's style. A row of chips above the preview switches it between the letters, the two symbol pages, the Fn page when your layout has one, and every panel that is a grid of keys (text editing, numpad, clipboard, emoji, GIF, sticker, trackpad and handwriting), so a key on any of them can be picked the same way. **Done** or Back returns the preview to typing. **Add a key** still takes a letter typed by hand, or one of the special keys (Enter, Space, Shift, Delete, Symbols…), for a key the preview isn't showing.

A letter's style follows that letter onto every layout that has it. A key that does one particular thing gets a style for that thing alone: each arrow, Home and End on the text-editing pad, each tool key, each page key. That is how the arrows of the text-editing pad go red while Home and End stay dark. A style an older theme or an imported one gave the whole family (every text-editing key at once, say) keeps applying to every key that has no style of its own.

The key's style opens on the page straight under the preview, which stays pinned above it, so every change shows on the key as you make it. Back or the × beside its title closes it. Set any of these. Everything you leave alone keeps following the theme, so a key that only recolors its hint carries exactly that.

- **Colors**: its face, its label, its hint, its border, and the two colors of the popup bubble it shows.
- **Key image**: a picture for this one key, drawn with the same Crop/Stretch/Tile fit and opacity the board's [key textures](#key-textures) use, so a dressed key still reads as part of the set. It beats the class texture it would otherwise wear, and a key image works on a board with no class textures at all.
- **Press effect**: the burst this key throws: Stars, Hearts, Sparkle, Confetti, or Emoji with its own field for the emoji. It overrides the board's [key press effect](#key-press-effect) for this key alone, and a board whose only effect is one key's still bursts on that key. The board's Intensity, Colour and the physics sliders shape every burst; a single-key style picks what is thrown, not how. Images aren't offered per key.
- **Key shape**: this one key's outline. Automatic follows the board's shape; pick one to make a single key round, pill, cut or anything else in the list, including None. The board's corner radius still decides how round a rounded key is, and the shapes that measure themselves off the key (circle, pill, hexagon and the rest) ignore it as they always do. This is how a round Enter key on a grid of soft rectangles is made, and it is what carries over from an imported FlorisBoard theme built that way.
- **Bold label** and **Label size**: how the label is drawn. Bold is a three-way choice: Automatic follows the board, On and Off answer for this key. Label size replaces the automatic rule rather than scaling it, which is how you get a `?123` drawn at full letter size. A size the *layout* gave the key in the [layout editor](https://wmkeyboard.pages.dev/languages/custom-layouts/#editing-a-key) wins over the theme's, since the layout is the more specific answer.

An armed or locked modifier still shows the accent or pressed face whatever color you gave it, because state has to stay visible. A key image and a press effect travel inside the exported theme the same way the board's do. High-contrast accessibility drops single-key styles with the rest of the decoration, and a press effect never plays under reduce motion or power saving.

### Stickers

Up to six images laid over the keys, purely for decoration: typing goes straight through them. Transparent PNGs work best. Each sticker has position, size, rotation and opacity sliders, adjusted over a live miniature preview so what you drag is what the keyboard shows. Stickers travel with the exported theme the same way textures do.

### Key press effect

A small particle burst under every key press. Pick **Stars**, **Hearts**, **Sparkle**, **Confetti**, **Emoji** with a field for the emoji to throw (each one becomes its own particle kind), or **Images**, which takes up to six of your own pictures from the gallery, each a particle kind the same way. Transparent PNGs look best. They're stored small and keep their proportions in flight. An **Intensity** slider scales how many particles a press throws.

Six more controls shape every particle at the moment it spawns: a **Colour** picker (Natural, Key text, Accent, Trail, Custom, or Random) and five sliders, **Size**, **Speed**, **Spread**, **Gravity** (how fast particles fall; zero leaves them drifting, and below zero they float upward), and **Duration** (200-2500 ms). The effect never plays under reduce motion or power saving, and high-contrast accessibility drops it with the rest of the decoration.

### Key material

What the keys look like they're made of. Pick **Key cap** (a raised cap on a darker skirt that sinks when pressed), **Metal**, **Wood**, **Stone**, **Stitched cloth**, **Leather**, **Carbon fibre**, **Paper cut-out**, **Letterpress**, **Neon**, **Holographic**, **Terminal**, **Cartoon**, **Art glass**, **Candy**, **Ceramic**, **Resin**, **Arcade button**, **Typewriter**, **Instrument panel** or **Molten**. **Custom** starts from a flat key.

Each material is a preset of the same few parts, and every part has its own control under it: **Key cap height**, **Top face inset** and **Cap side shade** for the raised cap; **Gloss** and **Light direction** for the highlight; **Surface texture** (grain, linen, dots, scan lines, brushed, wood grain, stone, paper, carbon weave or leather) and its strength; **Edge** (stitching, a glow, an ink outline, a glazed rim, a pressed-in top edge or a double ring) with its colour and width; **Label effect** (glow, pressed in, raised or a shadow); and **Rainbow sheen**. Picking another material starts its preset afresh. The textures are drawn in greys, so they take each key's own colour.

### Moving background

Something moving on the board behind the keys: **Snow**, **Rain**, **Code rain**, **Bokeh**, **Stars**, **Warp speed**, **Fireflies**, **Dust**, **Embers**, **Bubbles**, **Confetti**, **Fireworks**, **Aurora**, **Nebula**, **Lava lamp**, **Waves**, **Smoke**, **Dot grid**, **Contour lines**, **Equaliser**, **Scanner**, **Sheen** or **Ripples**. **Amount**, **Speed**, **Brightness** and **Size** shape it, and two colour pickers set its colours (the accent and the label colour when left on Auto).

**Reacts to typing** makes each key press push the effect: it speeds up and glows brighter, then settles back as the typing stops. **Ripples** and **Dot grid** also send a ring out from each key you press. Under reduce motion or power saving the background stays as a still picture.

The last nine effects are splashes. Instead of moving all the time, each one lands on the keys when you press one and is gone a moment later:

- **Paint splash**: a splat of paint with flung drops, and drips that run down the keys.
- **Ink blot**: a soft, uneven blot that spreads and fades.
- **Light pool**: a round pool of soft light a few keys wide.
- **Colour flood**: a wash of colour that spreads from the key across the whole keyboard.
- **Smoke puff**: a puff of smoke that drifts up and thins out.
- **Glint**: a four-point star of light on the key.
- **Pop**: a ring that pops outward and throws small bits.
- **Swoosh**: short curved strokes that sweep round the key.
- **Specks**: a scatter of tiny dots round the key.

Splashes are drawn over the keys, so they show on solid keys too, and **Brightness** keeps the labels readable through them. If you leave both colours on Auto, each press picks a colour of its own; choose a colour to use only that one, or two to alternate. **Speed** sets how fast a splash plays out and **Size** how big it is. **Reacts to typing** is hidden for splashes, because they already answer every press. A splash has no still picture, so under reduce motion or power saving there is none. In the effect list, each splash has a small tile that plays it in your theme's colours. While Reduce motion is on, or the phone is set to remove animations, the editor says so above **Moving background**, with a button that turns Reduce motion off.

### Key lighting

Light on the keys, the way a backlit keyboard has it. **Steady**, **Breathe**, **Wave**, **Sweep**, **Twinkle** and **Heartbeat** run on their own. **Pressed key**, **Ripple**, **Echo**, **Splash**, **Cross** and **Rain** start from the key you press and go dark again when you stop. **Light on** puts it on the key faces, round the key edges, or behind the keys, where it shows in the gaps. **Filled key** colours the whole key with the label showing through, **Two-tone fill** fills it with two colours running corner to corner, and **Glitter** scatters twinkling specks over it. **Rainbow spread** turns the colour across the keyboard (360° shows the whole rainbow), and **Fade time** sets how long a press stays lit. Lighting is off under reduce motion and power saving.

**Colour choice** sets where the colour comes from. **Light colour** uses the one colour above. **Bright, each press** and **Pastel, each press** give every press a different colour, bright or soft; on a pattern that runs on its own, each key gets its own colour instead. **Pressed key** with **Filled key** and **Bright, each press** colours each key you press in a new colour that fades as you move on. When **Light on** or **Colour choice** opens as a list, each option has a small key beside it that lights up the way your keys will.

### Touch bloom

The keyboard answers your finger itself. Turn on **Touch bloom** and a soft light spreads out from where you touch, across the background behind the keys, while the keys near your finger sink a little and spring back when you lift, with a small wobble. Keys further away stay still. When you glide, the light and the dip travel with your finger, and the bubble over a pressed key lights up in the same colour.

**Key motion** sets how the keys move. **Sink** is the dip described above, and moves every key near your finger. The others move only the key under your finger: **Grow** makes it larger, **Shrink** makes it smaller, **Rise** lifts it up off the keyboard, **Tilt** tips it toward the side your finger landed on, and **Jelly** squashes it flat and wide. When the options open as a list, each one has a small key beside it that plays the motion.

**Light colour** is the theme's accent unless you pick one. **Light strength** sets how bright the bloom is (0% leaves only the key motion), **Reach** how far from your finger the light spreads and, with **Sink**, the keys move, **Key dip** how far the keys move (0% leaves only the light), and **Wobble** how much they bounce on the way back. A grown or risen key that bounces goes a little past its resting size or place before it settles. Touch bloom is off under reduce motion and power saving.

### Key art

Hand-drawn keys from a file. **Load key art from a file** reads a skin: each kind of key (letters, special keys, enter, space, delete, shift, the mode key, punctuation, emoji, the globe) drawn as layers of vector shapes, plus an optional picture for the board. The colours in it are names of the theme's own colours, such as the key's face or the accent, made lighter, darker or more see-through, so the art takes whatever palette the theme has. Layers can move, fade, grow or turn while a key is held. A key with no drawing of its own uses its group's, then the letter key's. Key art replaces the key colours, material and border on the keys it draws. A file can also draw the popups: the bubble over a pressed key, the alternates and the language list then wear that drawing.

The file layout is the one the Kyng keyboard uses for its skins, so a skin document in that layout loads as it is. High contrast drops key art, materials, the moving background, lighting and touch bloom with the rest of the decoration.

### Font and sound

The theme can bring its own key font and key sound. You pick both from what's on the device: the styles the app ships, plus anything installed from the font and sound libraries. The sound list holds your installed sounds *and* your installed sound packs, each as its own row, so picking one is picking the sound itself rather than a category. They're referenced by name and never copied into the theme file. If someone imports your theme without that font or sound installed, their keyboard quietly uses their own global choice instead. Someone who has picked a key font of their own under [Keyboard fonts](https://wmkeyboard.pages.dev/themes/fonts/) keeps it too: the theme's font only applies while that setting is left on System default. Publish the font and sound as their own add-ons and list them under the theme's `requires` in a [repository manifest](https://wmkeyboard.pages.dev/development/addon-repos/repo-format/), so the install screen offers to fetch them together.

**Key font** covers Latin, Cyrillic and Greek. Every other script keeps its own face, because a Latin-only display font draws a Bengali board as empty boxes.

**Add a font for a script** is how a theme keeps its look on those boards anyway. Pick a script, pick a face that actually carries its glyphs, and that script uses it instead of its automatic Noto face. Add as many as you have fonts for; the scripts you skip are unaffected. A pixel theme usually needs one file per script, since a single pixel font almost never covers Latin and Bengali and Arabic at once. Each of these is another add-on to publish and list under `requires`.

Your own pick in Appearance → Fonts still beats the theme's, the English one included. You chose that font on purpose, and a theme doesn't get to overrule it.

For a theme you plan to share, use the forms that travel. Google Font ids (`google:Caveat`) resolve the same on every device, and an installed sound or font can be named by its catalogue name: "Typewriter" for a sound, `installed:Bloxat` for a font. The ids the libraries mint locally differ from phone to phone.

A theme's sound is only ever a sound it can actually make. A theme whose sound is missing on this device (never installed, or since deleted) falls back to the global **Key press → Sound style** pick, and so does a theme file whose `soundStyle` is `CUSTOM` or `PACK` with no `soundCustomId` beside it. Those two styles name something installed rather than a waveform of their own, so without a name there is nothing to play, and overriding your own pick with silence-turned-system-click would leave the whole keyboard clicking with nothing on screen to say why.

### Accent

- **Accent** paints the shift-on tint, the patch behind a locked Shift, the active-tool color, the buttons across the panels, and the [smart chips](https://wmkeyboard.pages.dev/smart/chips/) on the suggestion strip, the contact chip among them. Those chips stay in Accent rather than the suggestion text color, so they read as answers rather than words.
- **Gesture trail** is the color of the swipe-typing trail. Auto falls back to Accent, and the field supports alpha.

### Popups

The popups have a section of their own: open it from the **Popups** row under [Toolbar, strip and popups](#toolbar-strip-and-popups), or from the **Popups** chip while picking on the keyboard. At its top is a drawing of the two popups in the theme you are editing, the bubble over a pressed key and the press-and-hold alternates with one lit, on a patch of the board's own fill, so a colour, the shape, the outline and the shadow can be judged without holding a key down. The bubble is left out while key popups are off under Key press, since the keyboard never draws it then.

- **Popup background** and **Popup text** color the bubble that appears above a key on press, and the press-and-hold alternates with it: the sheet the alternates sit on is Popup background, and every alternate not under your finger is Popup text. Both support Auto fallbacks, deriving from the board and key colors and from Key text respectively. Popup background supports alpha. The highlight that follows your finger across the alternates is **Selected highlight** under [Panels & suggestions](#panels--suggestions), and the character on it is **Selected text**, so the gap between that highlight and the sheet's edge is the alternates' spacing, which is Key press / Alternate keys / Alternate key spacing rather than a theme field. See [What's what](#whats-what) for a drawing of each part.
- **Popup shape** sets the outline of every popup surface the keyboard draws: the character bubble, the long-press alternates, the language list, the panel menus. It's the same picker and the same twelve shapes as Key shape, drawn at this theme's popup radius. Until you pick one, the theme follows Key press / Key popup / Popup shape.
- **Popup placement** decides whether the character bubble grows out of the pressed key (the stock style) or floats detached above it. **Default** leaves the choice to Key press. The other two make it part of the theme, so a bubble-popup theme looks right on every phone it lands on.
- **Popup outline** and its width row draw a border around the bubble, off until you pick a color, exactly like the key border. It draws on every popup surface the keyboard opens: the character bubble, the long-press alternates, the spacebar language picker, the clipboard and emoji menus, and the small pickers inside the tool panels.
- The popup can also wear an image: the **Key preview popup** row under [Key textures](#key-textures) paints one inside the bubble, clipped to the popup shape, using the same Crop/Stretch/Tile mode and opacity as the key textures.
- A theme with a [key material](#key-material) draws its popups in the same material: the bubble, the alternates and the language list of a wooden board are wood too. [Key art](#key-art) with a drawing for popups uses that drawing instead.
- **Menu shape** exists because the list menus (the spacebar language picker, the clipboard and emoji menus) don't blindly follow the popup shape. On **Automatic** they take a safe derivative: the plain outlines (Rounded, Square, Cut, Squircle) pass through, and the decorative ones fall back to Rounded. A slanted character bubble is fine. A slanted menu clips its own rows. Pick a shape here only to overrule that judgement.

### Toolbar, strip and popups

The bar above the keys is either the toolbar or the suggestion strip, and each has a section of its own rather than a long group on this page, as do the [popups](#popups). Open them from the **Toolbar**, **Suggestion strip** and **Popups** rows in this group, or pick the part itself: with **Tap a part to style it** (the button under the preview), pressing a tool opens the toolbar's section and pressing a suggestion opens the strip's, and the chip row above the preview carries all three as well. The section opens on the page straight under the preview, which stays pinned above it however far you scroll, and while the strip's section is open the preview puts a few words on the strip so there is something to look at. Only one part is open at a time; Back or the × beside its title closes it.

The **Toolbar** section:

- **Toolbar background** fills the bar behind the tools: their own row, when Appearance / Toolbar gives them one, and the suggestion strip while it is showing the tools instead of words. On Auto it matches **Suggestion strip** in the strip's section, which in turn matches the board, so the bars stay one colour until you pull this one apart. Alpha works here, so a half-transparent fill tints the strip's own colour rather than covering it. The strip takes its own colour back the moment words arrive, so a bar that flips between words and tools flips colour with them; if that reads as a flicker, leave the two the same and use the tools' own row instead.
- **Tool background shape** is the outline of the background behind each toolbar tool, from the same twelve shapes. It follows Appearance / Toolbar / Tool background shape until you pick one here. Nothing draws at all while the tool radius is 0, which is the setting for bare icons.
- **Tool icons** sets the toolbar's icon color, Auto by default.
- **Tool circles** and **Active tool circle** paint the background behind a toolbar icon, at rest and while pressed or active. Both support alpha.
- **Tool shadow** lifts that background off the bar.
- **Active tool icon** colors the glyph sitting on an active tool. Auto picks whichever of black or white reads on the active circle, which is what this was before the row existed. Set it when the automatic pick is technically legible but not the colour you want.
- **Tool outline** and **Tool outline width** put a border around that background, off until you pick a color, exactly like the key border in [Keys](#keys). The width row appears once a color is set, and nothing draws until it's above 0. A theme that sets one keeps it even with the accessibility **Key outlines** toggle on.

The **Suggestion strip** section:

- **Suggestion strip** fills the bar the word candidates sit on, and every other bar around the keys with it: the toolbar row, the emoji row, the symbol row, the dictionary bar, the fancy text bar and the selection macros. Those rows stack straight against each other, so one color across all of them is the only thing that reads as deliberate. It sits on Auto until you pick a color, and Auto means the bars carry the board straight through, gradient, image, animation and all. Alpha works here, so a half-transparent fill tints the board rather than covering it. One thing to watch: the words on the strip take their color from the board, not from this fill, so if you paint the bars a long way from the board color, set **Suggestion text** just below to match.
- **Suggestion text** colors the suggestion strip and the panels' body text. Auto falls back to Key text, contrast-guarded against the board, so a theme whose keys invert against its board (dark ink on cream keys over a near-black board) still gets a legible strip. An explicit choice here is honoured as written.
- **Other suggestions** colors the strip's suggestions other than the primary one: the runner-up on its left and the rest on its right, when the primary sits in the middle, or everything after the first word when it doesn't. Auto draws them in Suggestion text, which is what they always were. The primary keeps Suggestion text (and its bold), and the word autocorrect has settled on keeps the colour **Autocorrect word color** under Appearance / Toolbar gives it, so a strip that colours its runner-ups quieter never hides the one word a space is about to type. A word no list knows yet keeps **New word color** from the same screen in the same way.
- **Other suggestions size** draws those words at a share of the primary's size, 50% to 120% in 5% steps, 100% being the same size. It's a ratio, not a size, so it rides on the suggestion-size slider under Typing the way the primary does, and a word squeezed to fit its slot shrinks from this size rather than from the primary's. The conversion candidates of the CJK layouts and Avro's candidate list are one row of equals and ignore it.
- **Suggestion pills** colors the rounded box behind each word, which the strip draws only while **Coloured suggestions** is on under Typing / Suggestions. Auto is the theme's accent made faint (16% on a dark theme, 10% on a light one), so the pills follow the accent the way they always did; pick a color here to set them apart from it. Alpha counts, so a half-clear pill lets the strip show through.
- **Main suggestion pill** colors the pill behind the primary word, the one a space puts in. Auto lays the Suggestion pills color over itself, so the main word still reads a step deeper without a second pick; with both on Auto it's the accent at 34% on a dark theme and 24% on a light one.

### Panels & suggestions

- **Cards & search bar** is the `chipBackground` field. It covers suggestion chips and the search-bar surface across the tool panels. Auto falls back to Modifier keys, and the field supports alpha.
- **Popup shadow** lifts the key preview and the long-press alternates off the board.
- **Selected highlight** and **Selected text** color the letter your finger is on while you hold a key, and the selected row of the language list. Auto uses the accent, which is what these were before they had rows of their own.
- **One-handed rail** and **One-handed rail icons** color the strip beside the keyboard in one-handed mode. It used to draw in the settings app's colors and ignore your keyboard theme entirely.
- **Secondary text** colors the quieter text beside the main text: the second word of a suggestion, and the kind and time on a clipboard entry. Auto draws Suggestion text at 65% alpha, which is what it was before the row existed. Alpha works here.
- **Dividers** colors the hairlines between the parts of a panel and between suggestions. Auto draws Suggestion text at 25% alpha. Alpha works here too, so you can keep the rule faint in a hue of its own.
- **Card shadow** lifts the panel cards off the panel.

### Chips & buttons

Chips are the small tappable surfaces inside the tool panels: style pickers, tab strips, converter controls, dictionary suggestions, search bars, the cards in the clipboard, snippet, weather, calendar, grammar and plugin lists, and the buttons and fields a [plugin](https://wmkeyboard.pages.dev/plugins/overview/) draws. They take the card color above as their background, and this group styles the rest. The panels' own keypads (calculator, numpad, the converters, the text-editing pad, the handwriting and voice rails) count as keys rather than chips. They follow the theme's key shape and key border, so a circle-key theme gets circular calculator keys for free.

- **Chip text** and **Selected chip** / **Selected chip text** cover the resting label, plus the fill and label of the chip that's currently active. Auto derives all three from the theme, and the selected fill follows the active tool circle.
- **Chip outline** and its width row draw a border around every chip, off until you pick a color.
- **Chip shape** and **Chip corner radius** use the same twelve-shape picker as everywhere else. The default is the 12dp soft rectangle chips have always drawn.
- **Card shape** governs the bigger surfaces: clipboard and snippet cards, plugin rows, search bars, the converters' displays. They follow the chip shape through the same safety rule as the menu shape, so plain outlines pass through, decorative ones fall back to Rounded, and an explicit pick here overrules both.

Any row left on Auto shows an "Automatic" label under its name instead of a fixed value. Once you've overridden it, that row's color picker gains an **Automatic** button (next to Apply) that clears the override and puts the row back on Auto. On a row that is still on Auto, the picker opens on the colour Auto stands for, and pressing Apply without changing it leaves the row on Auto. A strip or toolbar on Auto paints nothing over the board, so writing the board's own colour over it would draw a lighter band.

### Gradients

Both **Board** and **Keys** can carry an optional gradient, painted over their solid color and toggled on with a switch next to each. Turning one on seeds it with a sensible default that you can then reshape. The board gradient starts as a 135° linear blend from Background to Accent, and the key gradient as a subtle 90° white sheen.

  ![A board gradient turned on: type, angle, and color-stop controls.](@assets/screens/themes/editor-gradient.webp)

- **Type**: Linear, Radial, or Sweep.
- **Angle**: 0–360°, shown for Linear and Sweep only (Radial ignores it).
- **Color stops**: 2 to 4, each with its own color and alpha. **Add color** and **Remove color** grow and shrink the list.

### Corners

Off by default, so keys everywhere follow the global sliders (two under Appearance, one under Key press). Turning on **Corner radii for this theme** seeds three independent sliders for this theme alone, each starting at whatever its global counterpart is set to:

  ![Corner radii for this theme, with the Key, Popup, and Tool circle sliders.](@assets/screens/themes/editor-corners-animation.webp)

- **Key corner radius**: 0–28dp, seeded from the global Key corner radius slider (default 8dp) when you turn the switch on.
- **Popup corner radius**: 0–40dp, seeded from the global **Popup corner radius** slider under Key press (default 12dp).
- **Tool circle radius**: 0–20dp, where 0 draws no background behind the icon at all (the slider reads "Off" there), seeded from the global Tool circle radius slider (default 20dp).

### Layout

A second opt-in group, **Layout for this theme**, works the same way: one switch seeds a set of size overrides from your current global settings, and turning it off clears them all again. Tool background width, toolbar height, popup height, key height, key gap, left and right padding, key label size, bold labels, corner hint size, and the gesture trail's width and opacity all live here. Screen-specific sizes from Layout settings (folded, unfolded, landscape) still win over a theme's own.

Popup height is the height of the key-preview bubble. The global slider under Key press keeps one value for the on-key bubble and another for the floating one, and the theme keeps the same pair. The slider here shows and edits the height of the style the theme is drawing, its own placement if it names one and otherwise the global one, and the other style's height stays as it was. An on-key bubble is also never drawn shorter than the key plus its label, whatever height it is given, so it cannot vanish under your finger.

### Animation

Adds continuous motion to the board while the keyboard is on screen:

- **None** (default), **Flow**, or **Hue cycle**, as a segmented picker.
- Flow drifts the board gradient along its own axis (or orbits its center, for a radial gradient). Hue cycle slowly rotates the hue of the board gradient, or the solid board color if no gradient is set.
- A **Speed** slider (0.25×–3×, default 1×) appears once animation is on.

Only three built-in themes ship with animation turned on: Sunset drift and Cyberpunk use Flow, Aurora uses Hue cycle. Every other built-in, and every fresh custom theme, starts on None.

## Live preview while you edit

The keyboard itself is pinned at the top of the editor, drawn small enough to leave room for the controls but at the proportions it has on screen. It is the real keyboard, not a picture of one: press a key and it flashes, the popup rises, the key effect fires, the strip shows the word, and a Flow or Hue cycle animation moves. Every change you make below redraws it at once, and switching looks or themes crossfades the way the keyboard does. The preview always draws the theme you are editing, panels included: a layout or panel that names a theme of its own keeps that pairing on the keyboard, but here the Numpad, the emoji panel and the rest show your draft. When one does, a notice above the editor says which and what theme it uses, and **Clear** lets it follow the theme you picked again.

Typing goes into the preview alone. Nothing you type there reaches an app, is learned, or is saved. The keys work the way they do when you type: shift and caps lock, the `?123` and `ABC` keys, the globe key cycling your enabled languages, and the emoji key and the toolbar tools opening their panels in the theme. Tools that need something the editor does not have, a microphone or your clipboard history for example, open their panel and stop there.

The keyboard runs edge to edge across the screen. **Tap a part to style it**, the button under the preview, or **Pick on the keyboard** under [Toolbar, strip and popups](#toolbar-strip-and-popups), turns the preview from something you type on into something you pick from. Press a key and its [single-key style](#single-key-styles) opens; press a tool and the toolbar's section opens; press a suggestion and the strip's does. The chips above the preview switch it between the typing pages and the panels, since the keys that would normally get you there are being picked too, and swipe typing is off for as long as you are picking so a finger sliding to a key isn't read as a word. **Done** or Back puts the preview back to typing, and opening the docked keyboard does too.

To give several keys the same style, such as a whole number row in one color, turn on the **Several keys** chip at the start of the chip row. A press then adds a key to the group, or takes it back out, and the line above the chips lists the keys you have so far. **Style** opens one [single-key style](#single-key-styles) section for all of them. Whatever you change there reaches every key in the group, and only that: a key that already had a border of its own keeps it when you change the fill for all of them. Turning the chip off or leaving picking forgets the group.

When the preview takes too much of a small screen, drag either of the two corner marks under it inward or up. The whole keyboard shrinks at its own proportions, text and icons included, down to 35% of its full size, and stays centred. Drag outward or down to grow it again, or double-tap a mark to go back to full size. The editor remembers the size on this phone, and the docked keyboard opened by the button below is always full size.

The floating keyboard button at the bottom right opens the same keyboard at full size, docked along the bottom of the screen with the sections scrolling above it, the way an app sits over the keyboard. A line above the keys shows what you type, with a button to clear it. Tap the button again, press Back, or use the keyboard's own hide tool to put it away.

## Duplicating and deleting

There's no Save or Apply button anywhere in this screen: every field write goes straight to storage, so closing the editor (or the app) never loses anything or asks you to confirm.

**Duplicating** an existing custom theme isn't available from inside the editor itself; the copy-then-edit flow described in [Creating a theme](#creating-a-theme) only applies to built-ins, from the gallery.

**Deleting** a custom theme is a gallery action too: tap the trash icon on its card. A confirmation dialog asks "Delete this theme?" with a note that it will be removed permanently. The theme's image files (background, textures, stickers, particles) are not deleted with it. A housekeeping pass clears them once nothing in any theme still points at them, and only after they have been unreferenced for a day, because looks in the same family share their files:

  themes/editor-delete-confirm — Deleting a custom theme asks for confirmation before removing it.

After a delete, an **Undo** bar shows at the bottom of the screen for a few seconds. It puts the theme back as it was, with all its looks and pictures, and switches back to it if it was the theme in use.

To delete several at once, long-press a card in Your themes. The cards there turn into checkboxes: tap more of them to tick them, or use **Select all** in the bar at the bottom, then the trash icon in that bar. It asks once for all of them, and the same Undo bar brings back every theme it deleted. While picking, a tap ticks a card instead of switching the keyboard to it; the close button or Back stops picking. The upload icon in the same bar saves every ticked card in one `.zip` of `.wmtheme.json` files, one per theme, the way each card's own export writes it: a family card as the whole family, a card in the flat gallery as its one look. **Import** reads that zip straight back. See [Several files at once](https://wmkeyboard.pages.dev/themes/sharing/#several-files-at-once).

The same bar regroups themes. With two or more cards ticked, **Group into one theme** makes them looks of a single theme, named after the first card, with the look dots on its card to switch between them; rename it with the **Group name** field in the editor. **Ungroup** shows up when a ticked theme has more than one look, and turns every look into a theme of its own. A look that only had a short name of its own, such as "Dark", takes the theme's name with it and becomes "Nord (Dark)". In the flat gallery a card is one look, so Group and Ungroup move just the looks you ticked and leave the rest of their theme together. Neither changes the theme in use, and both offer Undo.

Delete isn't offered for built-in themes or for the Default theme, only for themes in Your themes. Export is offered on built-in cards as well, so you can hand someone a copy of one as a file; only the Default card has no export button, since it's generated live rather than stored.

## Details and edge cases

- **Editing an existing custom theme doesn't switch to it.** Tapping the pencil on a theme already in Your Themes opens the editor without changing your active keyboard theme. Only Create, Duplicate (from a built-in), and Import set the edited theme as active, as a side effect of those actions rather than of editing.
- **Typography is part of a theme, but only once you set it.** The key font, the per-script fonts, key label size, bold key labels and corner hint size are all theme fields. Each one is empty until you touch it, and an empty field follows your global setting instead. So a theme you never gave a font to picks up whatever [Keyboard fonts](https://wmkeyboard.pages.dev/themes/fonts/) is set to, and changing that global font changes how the theme looks. Fonts are the one exception to "the theme's value wins once set": the theme's font shows only while your own font for that script is on its default, because a font you picked is a deliberate answer and a theme's is a suggestion. The sizes work the same way through the **Layout for this theme** switch.
- **The key-preview bubble has no band to rise into here.** On the real keyboard, the bubble for a top-row key is drawn in an empty strip of window kept above the board, over whatever app you are typing into. The preview has no window of its own, so it holds no such strip. Keeping one would be dead space taken out of the board's own room, and on the miniature it cost the board most of the width it had. The docked keyboard draws that bubble over the sections above it instead, the way the real one draws it over the app; the miniature, which is clipped to its own rounded corners, sits it on the board's top edge rather than letting it be cut in half.
- **Selected highlight used to miss the alternates.** Before version 0.5.14 the press-and-hold popup drew the highlight under your finger in the **Pressed key** colour and ignored Selected highlight and Selected text, so changing either row did nothing visible there. Both now reach the alternates as well as the menus. A theme that relied on the old behaviour and wants the pressed colour back sets Selected highlight to it.
- **Two "Auto" swatches don't match the real keyboard.** Pressed key and Active tool circle, when left on Auto, are worked out by a different formula in the editor's swatch than on the board itself. The swatch blends the key colour 40% toward the accent; the keyboard blends it 25% toward the key text. On a theme with a strong accent the two are visibly different colours, so trust the live preview over the swatch. Every other Auto fallback (popup background, tool circles at rest, and so on) matches exactly.
- **A theme's background image lives in this same editor**, under Board, but the picker, crop dialog, and opacity/blur sliders are covered in full on [Image backgrounds](https://wmkeyboard.pages.dev/themes/backgrounds/) rather than here.
- **Corner-radius overrides here are theme-specific**; the sliders they inherit from and the global key-shape basics are covered in [Theming overview](https://wmkeyboard.pages.dev/themes/overview/).
- **Exporting, importing, and installing a theme from a repository** are covered in [Sharing themes](https://wmkeyboard.pages.dev/themes/sharing/), including what happens to a theme's colors and images when it travels as a file.