Skip to documentation

Themes without application-code replacement

Manage the permanent Audoryx default theme and declarative manifest v3 packages with scoped assets, predictable fallback, and atomic updates.

The default theme is permanent

It cannot be deleted and remains the safe fallback if an installed package is missing, invalid, or incompatible.

Theme administration

Open Admin → Themes. Each card presents a full-width preview, identity, semantic version, scope, compatibility, palette, and available actions.

ActionWhen to use itSafety behavior
ApplyMake a validated installed theme activeSwitches the active theme record; the default remains available.
UpdateInstall a newer semantic version of the same packageValidates in staging and replaces atomically only after checks pass.
RemoveDelete an inactive optional themeCannot remove the default or the currently active package.
PreviewInspect the publisher's live demonstrationOpens a configured HTTPS URL in a new tab.

Install a ZIP package

  1. Acquire a trusted archive. Use EKR Marketplace or a package from a publisher you have independently verified.
  2. Select the ZIP. Audoryx enforces the upload size and rejects nested executables or unexpected paths.
  3. Verify and install. Manifest schema, identifier, version, scope, compatibility, assets, and hashes are checked before extraction.
  4. Review the preview. Confirm landing, login, creator, administrative, responsive, RTL, maintenance, 404, and 500 surfaces as applicable.
  5. Apply deliberately. Switch only after the validation checklist passes.

Per-theme content

Landing and presentation content is theme-scoped. In Admin → Brand & content, select the theme before editing its hero, sections, authentication copy, cards, media, maintenance page, or error-page content. Switching themes does not overwrite another theme's content.

  • Use a separate landing screenshot and preview metadata for each theme.
  • Use an actual image or video only after upload succeeds and the license inventory is complete.
  • Keep essential meaning in text, not only in decorative imagery.
  • Verify English and an RTL language at desktop and narrow viewport sizes.

Theme-aware fallback covers

ElevenLabs Music and Google Lyria creations that have no generated artwork use the active theme's default music cover: a theme-consistent gradient and music-note mark. Suno-compatible results retain provider-generated artwork when present. The fallback can appear as soon as the audio becomes safely streamable and preserves the image blur transition.

Theme manifest v3

A package is declarative. It may provide scoped CSS, referenced assets, design tokens, page-level style overrides, and approved component-style overrides. It must not replace Laravel, React, route, controller, migration, executable JavaScript, or vendor files.

theme.json · minimal structure
{
  "schema_version": 3,
  "id": "publisher-theme",
  "name": "Publisher Theme",
  "version": "1.0.0",
  "author": "Publisher",
  "scope": "dashboard_and_frontend",
  "compatibility": {
    "audoryx": ">=2.0.0 <3.0.0"
  },
  "styles": ["assets/theme.css"],
  "assets": {
    "preview": "assets/preview.webp"
  },
  "tokens": {}
}

Use the authoritative JSON Schema and the included package example. The engineering rules and token inventory are preserved in the theme technical guide.

Package rules

  • The identifier is stable, lowercase, namespaced where appropriate, and matches updates.
  • The version uses semantic versioning and increases for every released archive.
  • Every path is relative, normalized, within the package, and explicitly declared.
  • CSS selectors remain under the Audoryx theme root and do not leak into admin or third-party surfaces unintentionally.
  • Preview, fonts, icons, photos, and videos are recorded in the asset-license inventory.
  • The package contains no credentials, generated caches, source maps with private paths, or executable backend code.

Emberveil 1.3.1

Emberveil 1.3.1 adds a continuously moving creative-network showcase with eight locally packaged Logoipsum placeholder marks. The marks are identified as fictional showcase identities rather than customer endorsements, pause on hover, and become static when a visitor requests reduced motion.

Audoryx 2.0.0 supplies the companion landing component and completes Emberveil RTL behavior across the hero, creation rail, showcase, alternating stories, audience, tools, workflow, pricing, FAQ, final CTA, authentication visuals, and dashboard navigation. Keep Audoryx at 2.0.0 or newer before installing this theme release.

Theme QA matrix

SurfaceMinimum checks
PublicLanding, explore, public track, login, register, legal, 404, 500, maintenance
CreatorCreate, streaming row, library, workspace, track details, comments, billing, support
AdminNavigation, dense tables, dialogs, forms, charts, themes, updates, licenses
AccessKeyboard, focus, contrast, reduced motion, zoom, labels, error messages
ViewportWide desktop, laptop, tablet, narrow mobile, landscape mobile
LocaleEnglish plus one long-string locale and one RTL locale
Verified release walkthrough

Visual guide

These annotated captures come from the reviewed release listed in the screenshot manifest. Follow the numbered steps below each image.

Audoryx Themes administration showing the verified ZIP upload control and the permanent Nocturne fallback theme with a full landing-page preview.
Theme package library
  1. 1
    Verified package install Choose a compatible theme ZIP and verify it before the atomic installation is allowed.
  2. 2
    Full theme preview Review the landing-page preview and theme identity before applying or updating a package.
  3. 3
    Permanent fallback Nocturne remains installed as the safe default and cannot be removed from the theme library.
Neon Verdant landing page with theme-specific artwork, navigation, appearance control, studio entry, prompt field, Music and Voice to Song modes.
Neon Verdant public landing
  1. 1
    Theme-specific identity Neon Verdant changes the landing artwork, typography, palette, and surface treatment without changing core routes.
  2. 2
    Studio entry The public header keeps the primary route into the creator studio visible across themes.
  3. 3
    Creation modes Start with a text-led music idea or switch to the Voice to Song workflow from the landing composer.
Neon Verdant landing page showing the restored original 3D microphone artwork inside a green Silk-backed Text to Tune feature card.
Neon Verdant Silk feature presentation
  1. 1
    Restored themed artwork The original transparent 3D visual remains intact and is framed by the theme-specific animated Silk treatment.
  2. 2
    Feature-led entry The adjacent explanation and action take visitors directly into prompt-led song creation.
Neon Verdant 404 page with a theme-specific luminous green visual system and direct recovery actions.
Neon Verdant 404 recovery page
  1. 1
    Theme-specific identity Installed themes provide their own resilient error presentation instead of inheriting an unrelated generic surface.
  2. 2
    Consistent recovery Navigation actions remain familiar even while the visual language follows Neon Verdant.
Audoryx documentation · Version 2.0.0 · Updated 3 September 2026