Preloader
Full-page boot overlay with brand, orb or spinner, and optional auto-dismiss after window load.
Basic Usage
Drop
neura::preloader
near the top of
<body>
. It covers the viewport, then fades out after
window
load (plus a short minimum duration).
Loading…
<neura::preloader
brand="Neura"
logoLight="https://docs.neuraui.dev/logo/light.svg"
logoDark="https://docs.neuraui.dev/logo/dark.svg"
/>Indicators
Choose an
orb
(default), a
spinner
, or
none
when you only need brand + label.
Orb
Spinner
<neura::preloader indicator="orb" />
<neura::preloader indicator="spinner" spinnerVariant="ring" />
<neura::preloader indicator="none" brand="Neura" />Manual control
Disable auto-hide and call
NeuraKitPreloader.hide()
when your
app is ready (Livewire boot, data fetch, …).
Waiting for hide()
<neura::preloader :auto-hide="false" />
<script>
// when ready:
NeuraKitPreloader.hide()
</script>Props
| Property | Type | Default | Description |
|---|---|---|---|
| indicator | string | orb | orb · spinner · none
|
| orbState | string | working | Passed to neura::orb
|
| orbSize | int | 72 | Orb size in pixels |
| spinnerVariant | string | default | Passed to neura::spinner
|
| label | string | Loading… | Status text under the indicator |
| brand | string | null | Brand name |
| logo / logoLight / logoDark | string | null | Brand logos |
| autoHide | bool | true | Dismiss after window load |
| minDuration | int | 400 | Minimum visible time in ms |
| overlay | bool | true | Fixed fullscreen vs inline preview |
| zIndex | int | 100 | CSS z-index when overlay |