面向 Uni-app（Vue 3）的跨端移动端组件库。

Orpheus-K/lucky-ui · 快速上手 · 组件总览 · GitHub

_{微信扫码体验小程序}

Lucky UI 为 Uni-app 应用提供一套开箱即用、类型完备、主题可控的移动端基础设施。它面向 H5、App 与小程序多端交付，覆盖基础元素、表单控件、数据展示、导航、反馈浮层、图表与工程化能力。

项目当前以 src/uni_modules/lucky-ui 为组件库主体，配套 VitePress 文档、H5 预览页、运行态采集、SVG 资产转换与 AI 协作规则。它不是简单的组件集合，而是一套可持续演进的跨端 UI 工程体系。

pnpm install
pnpm run dev:h5

文档站点本地预览：

pnpm run docs:dev

默认文档端口为 4188，H5 预览端口为 5188。

将 src/uni_modules/lucky-ui 放入业务项目的 src/uni_modules/ 目录，然后注册插件：

// src/main.ts
import { createSSRApp } from 'vue';
import App from './App.vue';
import LuckyUI from './uni_modules/lucky-ui';

export function createApp() {
  const app = createSSRApp(App);
  app.use(LuckyUI);
  return { app };
}

The default plugin registers only public Lk* components. Demo and debugging utilities should be imported explicitly when needed.

引入主题样式：

// src/uni.scss
@use './uni_modules/lucky-ui/theme/src/index.scss';

页面中直接使用：

<template>
  <view class="page">
    <lk-button variant="solid">提交</lk-button>
    <lk-tag bg-color="var(--lk-color-success)" text-color="#fff">已启用</lk-tag>
  </view>
</template>

完整 API 与示例见 组件总览。

.
├── docs/                         # VitePress 文档站点
├── src/
│   ├── components/demos/         # H5 组件演示
│   ├── pages_sub/                # 预览与业务示例页面
│   └── uni_modules/lucky-ui/     # Lucky UI 组件库源码
│       ├── components/           # lk-* 组件
│       ├── composables/          # 跨组件复用逻辑
│       ├── core/                 # 核心工具与能力
│       ├── locale/               # 国际化文案
│       ├── theme/                # Design Token 与主题样式
│       └── utils/                # 通用工具
├── scripts/                      # 工程脚本
└── tests/                        # 自动化与回归用例

• 在线文档：Orpheus-K/lucky-ui
• 快速上手：Orpheus-K/lucky-ui
• 组件总览：Orpheus-K/lucky-ui
• 主题定制：Orpheus-K/lucky-ui

涉及 Canvas、原生组件、开放能力、系统安全区与平台私有样式的场景，应以目标端实测结果为准。

MIT