Read the per-install appearance configuration

GET

/admin/system/appearance

Local development behind nginx (port 8088 by default)

Returns the admin-chosen font slots (brand / display / body / mono). Each slot holds a font catalogue ID; empty means the slot uses the frontend default.

Authorizations

cookieAuth
bearerAuth

Responses

200

Current appearance config

Per-install brand and typography choices. Each field holds a font catalogue ID (e.g. limelight, inter-variable, system-sans); the frontend resolves the ID to an @font-face declaration at boot. Empty string means the slot uses the frontend’s default.

object

brand_font

Logo / hero font slot. Recommended for display faces (Limelight, Bebas Neue, Playfair Display); body text never uses this slot.

string

display_font

H1–H3 heading slot. Falls back to the body font when empty.

string

body_font

Body / UI text slot. Falls back to the system sans-serif stack when empty.

string

mono_font

Code / tabular numerics slot. Falls back to the system monospace stack when empty.

string

site_name

Display name of this install. Read-only here — it is owned and edited via the Site config (/admin/system/site); it is surfaced on this public boot path so the wordmark, login card, and document titles can render the configured name before the user has signed in. Defaults to “Artist Alley” when the operator hasn’t set one.

string

Example

Artist Alley

demo_mode

True when this install runs in demo mode (env AA_DEMO_MODE=1). Surfaced on the public boot path so the login card can advertise the shared demo credentials and a read-only banner can render once signed in. Absent/false in a normal install — zero footprint when off.

boolean

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed