@bridge-ui/adapters

BridgeUI Adapters

🚀 Introduction

@bridge-ui/adapters ships ready-made date, icon, and i18n adapters for @bridge-ui/react and @bridge-ui/vue. Adapters implement the contracts from @bridge-ui/core/Adapters and are wired through BridgeUIProvider (React) or createBridgeUI (Vue) global.*.

Every adapter lives under a react/ or vue/ subpath — including framework-agnostic ones — so imports always follow @bridge-ui/adapters/{react,vue}/<name>.

📦 Install

npm install @bridge-ui/adapters

Then install the optional peer of each adapter you use (e.g. dayjs, lucide-react). Only @bridge-ui/core is a required peer; it is already installed with @bridge-ui/react / @bridge-ui/vue.

🔌 Usage

React:

import { createDayjsDateAdapter } from "@bridge-ui/adapters/react/date-dayjs";
import { createLucideIconAdapter } from "@bridge-ui/adapters/react/icon-lucide";
import { BridgeUIProvider } from "@bridge-ui/react";

<BridgeUIProvider
  global={{
    dates: createDayjsDateAdapter(),
    icons: createLucideIconAdapter(),
  }}
>
  <App />
</BridgeUIProvider>;

Vue:

import { createDayjsDateAdapter } from "@bridge-ui/adapters/vue/date-dayjs";
import { createLucideIconAdapter } from "@bridge-ui/adapters/vue/icon-lucide";
import { createBridgeUI } from "@bridge-ui/vue";

app.use(
  createBridgeUI({
    global: {
      dates: createDayjsDateAdapter(),
      icons: createLucideIconAdapter(),
    },
  }),
);

🧩 Adapters

Font Awesome also needs @fortawesome/fontawesome-svg-core and @fortawesome/free-solid-svg-icons.

🎨 Tailwind

No extra @source is needed. Adapter classes are named bridge-* utilities styled by the theme.css of @bridge-ui/react / @bridge-ui/vue.

🔁 Migrating from Adapters/Examples

Adapters used to ship as @bridge-ui/{react,vue}/Adapters/Examples/*. Swap the import prefix; factory names are unchanged:

Move the adapter peers (date libs, icon sets, i18n) to your app dependencies if they were only installed for the old subpaths.

🔧 Contributing

npm install
npm run build
npm run test:run
npm run lint
npm run type-check
npm run check:parity

Framework-agnostic adapters (date-*, i18n-dictionary) and their tests exist in both src/react/ and src/vue/. Change both copies in the same PR — npm run check:parity fails when they drift. See AGENTS.md for code conventions.

📝 License

Bridge UI Adapters is open-source software licensed under the MIT license.