1. Project Overview

uv-ui

A UI framework compatible with Vue 3 and Vue 2 for rapid multi-platform development

uv-ui: A comprehensive ecosystem framework based on uni-app and uView2.x, designed to support Vue 3, Vue 2, apps, H5, and mini-programs. Supports individual component imports and works out of the box.

2. Open Source License

Licensed under MIT

3. Screenshots

4. Feature Overview

uv-ui Features

1. The Evolution of uv-ui: uv-ui is derived from the uview2.x version. It was renamed to avoid release conflicts and address situations where many components prefixed with u- cannot be used in nvue. This led to the creation of uv-ui. Thanks to the uview-ui author for their open-source contributions. Another round of applause for open source! uv-ui is also fully open source without any restrictions.

2. Full Platform Compatibility: uv-ui supports Vue 3, Vue 2, app-vue, app-nvue, H5, mini-programs, and more. All uv-ui components automatically adapt to multiple platforms, with the underlying implementation handling many differences and bugs across mini-program platforms.

3. Extended Configuration: Built-in uv-ui methods are no longer mounted on the uni object by default, which means you cannot directly use built-in methods through uni.$uv.xxx in your project under the default configuration. However, this can be resolved through extensions by following the configuration instructions below. For usage details, refer to Extended Configuration. This includes the JS utility library, custom themes, base styles, setconfig, and more.

Component List

The following table lists the extended components available in uv-ui. Click Download & Install for any component to import it into your project on its detail page. After importing, it is recommended to restart the project so the component can be used immediately. No import statements or component registration are required.

5. Tech Stack

Quick Start

Method 1: uv-ui strongly recommends downloading the plugin and importing it into HBuilderX to import the components.

Method 2: Download the complete uv-ui project and copy uni_modules into your own project.

Method 3: Download via npm i @climblee/uv-ui. This method requires configuring easycom. For configuration details, see Installation.

Please refer to the Quick Start guide for more detailed information.

Note: After importing the plugin, it is recommended to restart the project in HBuilderX. Newly imported plugins may not update in real time, which could cause the project to fail to run.

Usage

After importing components into uni_modules, you can use them directly in your project without importing them via import statements.

<template>
    <uv-icon name="baidu" size="30" color="#909399"></uv-icon>
</template>

Extended Features

uv-ui includes powerful built-in utility functions, request wrappers, and more. You can configure extensions according to your needs. For details, please refer to Extended Configuration.

Note: You must configure extensions before using the component library's built-in methods, variables, and other features in your own project pages.