Customize the Velora Widget

The widget exposes a single visual control: a theme config field that switches between bundled light and dark themes.

Set a theme

<Widget config={{ theme: "light" }} />
<Widget config={{ theme: "dark" }} />
<Widget />                              // follows system preference

theme accepts the WidgetTheme type: "light" | "dark". If you omit theme, the widget reads the user’s OS preference via prefers-color-scheme and updates live when the preference changes.

Switch themes at runtime

The theme is a controlled prop. Pass a new value any time to switch.

import { useState } from "react";
import { Widget, type WidgetTheme } from "@velora-dex/widget";

export function ThemedWidget() {
  const [theme, setTheme] = useState<WidgetTheme>("light");

  return (
    <>
      <button onClick={() => setTheme(theme === "light" ? "dark" : "light")}>
        Toggle theme
      </button>
      <Widget config={{ theme }} />
    </>
  );
}

CSS scoping

The widget is built with Tailwind v4 and scopes all CSS variables under the .velora-widget class. That means:

The widget’s styles don’t leak into the rest of your app.
Your app’s global styles don’t bleed into the widget either. Selectors targeting bare elements (a, button, input) inside the widget’s DOM tree will still apply, but the widget’s own variables take precedence within its root.

Stylesheet auto-injection

The compiled stylesheet is auto-injected when you import { Widget }. No .css import required.

import { Widget } from "@velora-dex/widget";
// Stylesheet injected; nothing else needed.

If your bundler strips side-effect imports aggressively (rare but possible with aggressive treeshake), force-include the stylesheet:

import "@velora-dex/widget/styles.css";

Configure — every other config option.
Compatibility — Tailwind / bundler caveats.

API

SDK

Widget

Customize the Velora Widget

Set a theme

Switch themes at runtime

CSS scoping

Stylesheet auto-injection

​Set a theme

​Switch themes at runtime

​CSS scoping

​Stylesheet auto-injection

​Related pages

Set a theme

Switch themes at runtime

CSS scoping

Stylesheet auto-injection

Related pages