HY‑UI Docs

English

中文

English

中文

Appearance

Personal Introduction ​

Hello everyone, I am the independent developer of the Huayue Component Library (hy-design-uni). I am a front-end engineer deeply rooted in the UniApp ecosystem, focusing on the Vue3+TypeScript technology stack. I have been committed to the development of enterprise-level UniApp applications and component encapsulation for a long time, always adhering to the development philosophy of "efficient, compatible, and easy to use," creating technical tools that meet the actual needs of developers.

Why Create the Huayue Component Library? ​

Before the birth of the Huayue Component Library, I have been using uview-plus as the core component library for UniApp projects for a long time, supporting the development of various projects. However, with the increase in project complexity and the continuous maturity of the Vue3+TS ecosystem, two core issues of uview-plus have gradually become obstacles on the path of development:

  • The component library is not developed based on pure Vue3+TypeScript, and in actual development, it frequently encounters issues such as missing type hints, incompatibility with syntax, and code redundancy, which increases the troubleshooting cost and is difficult to meet the standardized development needs of enterprise-level projects;
  • Starting in 2024, uview-plus introduced a "view ads to access documentation" model, which greatly reduced development efficiency. Each time I debugged components or查阅ed APIs, I had to spend additional time watching ads, which severely affected the development experience, and made me realize that developers need a high-quality component library with no barriers and no interference.

Based on these pain points, I decided to develop a pure Vue3+TS component library as a reference to the source code of uview-plus, which is the origin of the Huayue Component Library and the original intention of my hope to solve the actual difficulties of UniApp developers.

Development History of the Huayue Component Library (From 0 to 1: Persistence) ​

This is my first time creating a full-featured UniApp component library independently. Without team support or external assistance, I was responsible for every aspect of the development process, from technical architecture design and component encapsulation logic to multi-end adaptation, bug fixing, and feature iteration, all of which were done by me alone.

Throughout this year of development, "all-nighters" became my norm. In order to meet the schedule and maintain quality, I almost gave up all my free time, staying up late to refine the code, debugging every detail of each component: from the style compatibility of a button, the animation transition of a popup, to the optimization of the overall architecture, multi-end logic adaptation, even the design of a hooks interface, all of which were debugged repeatedly for hundreds of times to pursue the ultimate user experience.

I am fully aware that the core of the component library is "practicality" and "stability," so I have always adhered to two principles during the development process: first, strictly follow the Vue3+TS development specifications to ensure the maintainability and scalability of the code; second, take into account the compatibility of multi-end adaptation and not to neglect any incompatibility bugs in the mini-program end.

Core Advantages of the Huayue Component Library ​

  • Pure Vue3+TypeScript Development: Fully compatible with the Vue3 ecosystem, with complete type hints, saying goodbye to type errors, improving development efficiency and code standardization, and meeting the development needs of enterprise-level projects;
  • Full-end Mini-program Adaptation: Perfectly compatible with mainstream mini-program platforms such as WeChat, Alipay, Douyin, and Kuaishou, without the need for additional code modification, one-click multi-end adaptation, and reducing the cost of multi-end development;
  • Exclusive Hooks Interface Encapsulation: Based on Vue3 compositional API, I have designed and implemented exclusive hooks interfaces, making component calls more flexible and logic more decoupled, simplifying the development process;
  • Feature Upgrade and Optimization: On the basis of replicating the core practical features of uview-plus, combined with my many years of UniApp development experience, I have added multiple practical features that are in line with actual development scenarios, making up for the shortcomings of the original component library;
  • Open Source, Free, and No Barriers: Since its birth, the component library has strictly followed the open-source project specifications, with all code open and available for free, without any advertising interference. You can access the complete documentation without watching ads, restoring a pure development experience.

To Every Developer Using the Huayue Component Library ​

Creating a full-featured UniApp component library from 0 to 1 is a process that is hard to describe—the countless nights of staying up late to debug, the helplessness of being caught by bugs, and the persistence of optimizing details are all my dedication to this component library. I am not a professional open-source maintainer, but a front-end engineer who wants to solve developer pain points and create a practical tool.

The growth of the Huayue Component Library is inseparable from the support and feedback of every developer. If you have any questions, suggestions, or want to communicate technology or participate in open-source construction, please feel free to contact me through the following methods. I will reply and answer your questions as soon as possible, continue to optimize the component library, improve features, fix bugs, and strive to provide you with a better user experience.

I also hope that the Huayue Component Library can truly help every UniApp developer, allowing everyone to take fewer detours and improve efficiency on the Vue3+TS UniApp development path, which is the greatest significance of developing this component library.

Contact Me ​

If you have any questions, suggestions, or needs for technical exchange or open-source construction, please feel free to contact me through the following methods:

I will continue to focus on the Huayue Component Library and grow with every UniApp developer, building a better UniApp development ecosystem ✨