@flare-im/vue-ui

Flare IM UI Kit — Vue 3 + Naive UI component library for chat (conversation list, message list/bubble, composer, media, business cards). L1 web implementation, driven by core observable views + @flare-im/tokens.
985
Install
npm install @flare-im/vue-ui
Latest Version:1.0.14
Vue:3
License:Apache-2.0
Last Updated:Oct 23, 2026
Links: GitHub  ·  npm
Maintainer: hugotang

@flare-im/vue-ui

Shared Vue 3 + TypeScript + Naive UI presentation layer for Flare IM example apps (Web, Electron, Tauri, uni-app H5).

Not an SDK runtime. Components receive view-state props and emit intents; example apps map intents to FlareImClient / platform-specific raw clients.

Install

npm i @flare-im/vue-ui

@flare-im/tokens 会作为依赖自动装上。Vue 3 与 Naive UI 是 peer dependencies, 需要宿主工程自行安装(见下方 Peer dependencies)。

本包发布的是 .ts / .vue 源码,不是编译后的产物。

入口指向源文件,所以需要宿主工程的打包器来编译它。Vite / Nuxt 默认就能处理; Webpack 需要为 @flare-im/vue-ui 加一条 include 规则(node_modules 默认被 loader 排除),并确保配了 vue-loader。

发源码是有意的:组件要跟随宿主的 Vue 版本与主题变量编译,预编译反而会锁死这些。

Exports

Path Contents
. Full barrel
./theme Semantic tokens, CSS vars, Naive overrides
./i18n zh-CN / en-US keys + useFlareI18n
./contracts View-state types (conversation row, message content, layout)
./composables useFlareAdaptive, useViewport, useFlareWorkbenchUi, message menu interaction
./components FlareWorkbenchShell, FlareUiProvider, conversations, messages, composer, diagnostics, auth
./style.css Workbench shell, auth, chat, composer, diagnostics, responsive layout CSS
./app Optional workbench components, SDK context helpers, and platform adapter hooks
./sdk-lab Lazy-loadable SDK Lab component for example apps
./app/style.css CSS for the optional workbench components

Source layout

Path Role
src/design-system/ Product foundations: provider, theme runtime, generated tokens, shared CSS foundations
src/components/ Public reusable IM components grouped by product surface
src/app/ Optional workbench building blocks: components/, SDK context, runtime adapters, and page-level state
src/shared/ Cross-cutting contracts, i18n, config, constants, tests
src/composables/ Public Vue composition APIs for host apps and shared components
src/utils/ Public UI/data formatting helpers

Usage

<script setup lang="ts">
import { FlareUiProvider, FlareConversationList, FlareConversationRow } from "@flare-im/vue-ui/components";
import "@flare-im/vue-ui/style.css";
</script>

<template>
  <FlareUiProvider layout-mode="auto">
    <FlareConversationList :items="rows" active-id="c1">
      <template #item="{ item, active }">
        <FlareConversationRow :item="item" :active="active" @select="onSelect" />
      </template>
    </FlareConversationList>
  </FlareUiProvider>
</template>

Peer dependencies

  • vue ^3.5
  • naive-ui ^2.44

Design boundary

This package owns product UI foundations and reusable interaction surfaces only. Host apps own App.vue, router creation, route guards, URL shape, runtime transport, login credentials, native shell adapters, and final SDK lifecycle bootstrapping.

Related Packages

im-ui-mobile

A Vue3.0 + Typescript instant messaging component library for Uniapp

20,641
@alanlee97/lee-ui

基于 Vue 3 的轻量级 UI 组件库

909
@deep-eye/core

深瞳前端团队企业级 Vue 3 组件库 | Enterprise Vue 3 component library for DeepTon...

24,334
@yymojo-tec/mojo-ui

Mojo UI 是 YYmojo 旗下维护的 UI 组件库。

9,973
whelk-ui

Vue3 Component Library for NearBeach

5,447

Version History

Version Released Vue License
1.0.14 ^3.5.0 Apache-2.0
1.0.9 ^3.5.0 Apache-2.0
1.0.8 ^3.5.0 Apache-2.0
1.0.7 ^3.5.0 Apache-2.0
1.0.6 ^3.5.0 Apache-2.0