Wallpapers

Blixt ships four built-in wallpapers (blixt, coast, pier, storm) plus whatever you add through config.json. The phone and tablet each maintain their own wallpaper list.

Built-in wallpapers

Available without any configuration. Reference them by ID in defaults.wallpaperId:

{
  "phone": {
    "defaults": { "wallpaperId": "coast" }
  }
}

ID	Description
blixt	Brand wallpaper (default).
coast	Daytime coastline.
pier	Sunset pier.
storm	Stormy weather.

Custom wallpapers

Add entries to phone.wallpapers or tablet.wallpapers:

{
  "phone": {
    "wallpapers": [
      {
        "id": "skyline-day",
        "url": "https://cdn.myserver.com/wp/skyline-day.webp",
        "urlLight": "https://cdn.myserver.com/wp/skyline-day-light.webp",
        "label": "City skyline (day)"
      }
    ],
    "defaults": { "wallpaperId": "skyline-day" }
  }
}

Field	Required	What it does
id	yes	Unique within the device’s wallpaper list. Don’t collide with built-in IDs unless you intend to override.
url	yes	Image URL. Absolute or relative (see below).
urlLight	no	Light-mode variant. Used when defaults.theme === "light".
label	no	Display name in the wallpaper picker.

Hosting options

Absolute URLs

Easiest. Host the image on your CDN (Cloudflare R2 with a public URL, S3 + CloudFront, etc.) and paste the URL.

{ "url": "https://cdn.myserver.com/wp/skyline.webp" }

Relative URLs (resource-hosted)

Bundle the image inside the device resource itself — no CDN required. Drop the file under the device resource’s dist/html/ folder and use a relative URL:

resources/[blixt]/blixt/dist/html/wallpapers/skyline.webp

{ "url": "wallpapers/skyline.webp" }

For tablet wallpapers, the same applies under blixt-tablet/html/.

Format and size guidance

• Format: WebP for size, PNG/JPEG fine. Avoid SVG (slow to rasterise).
• Resolution: 1284 × 2778 (phone) or 2048 × 2732 (tablet) — both at the native logical density of their canvases. Smaller works, larger is wasted bandwidth.
• File size: keep under 1 MB. The boot screen waits for the wallpaper to load.

Picking a default

defaults.wallpaperId only applies to new characters on first boot. Existing characters keep whatever they’ve set. To force a re-default for returning players, you’d need a custom migration — out of scope for this config.