explaingit

dcloudio/uni-app

📈 Trending41,527Objective-CAudience · developerComplexity · 4/5ActiveLicenseSetup · hard

TLDR

Write once in Vue.js, deploy to iOS, Android, web, and Chinese mini-programs (WeChat, Douyin, Alipay, etc.) from a single codebase.

Mindmap

mindmap
  root((uni-app))
    What it does
      Single codebase
      Multi-platform deploy
      Mini-program support
    Target platforms
      iOS and Android
      Web responsive
      WeChat Douyin Alipay
    How it works
      Vue.js components
      Custom compiler
      Platform-specific output
    Tech stack
      Vue.js framework
      HBuilderX IDE
      UTS TypeScript variant
    Use cases
      Consumer mobile apps
      Chinese super-app reach
      Cross-platform efficiency

Things people build with this

USE CASE 1

Build a mobile app that works on both iOS/Android and inside WeChat Mini Programs without maintaining separate codebases.

USE CASE 2

Launch a consumer app across multiple Chinese super-apps (Douyin, Alipay, Baidu) simultaneously from one Vue.js project.

USE CASE 3

Create a responsive web app and native mobile version that share the same component logic and styling.

USE CASE 4

Reach Chinese users through mini-program platforms where standalone app downloads are less common.

Tech stack

Vue.jsJavaScriptTypeScriptSwiftKotlinHBuilderX

Getting it running

Difficulty · hard Time to first run · 1h+

Requires HBuilderX IDE installation and configuration for multiple platform targets (iOS, Android, web, mini-programs); each platform has distinct build and deployment requirements.

Apache 2.0 license allows free use for any purpose, including commercial, as long as you include a copy of the license and state significant changes.

In plain English

Uni-app is a cross-platform frontend development framework from DCloud, a Chinese company. It lets developers write a single codebase using Vue.js and deploy the result to iOS, Android, the web (as a responsive site), and a wide range of Chinese mini-program platforms simultaneously, including WeChat Mini Programs, Alipay Mini Programs, Baidu, ByteDance (Douyin/TikTok), Feishu (Lark), QQ, Kuaishou, and others. The problem it solves is fragmentation. In the Chinese mobile ecosystem, "mini programs", lightweight apps that run inside super-apps like WeChat rather than as standalone downloads, are enormously popular. Each platform has its own SDK and slightly different development rules. Without a tool like uni-app, a developer who wants to reach users on both WeChat and Douyin has to maintain two entirely separate codebases. Uni-app provides a single abstraction layer on top. Here is how it works: developers write Vue.js components using a custom set of base components and APIs that uni-app defines. When building for a target platform, uni-app compiles the code appropriately, generating native iOS (Swift) or Android (Kotlin) code, JavaScript for web, or the specific format each mini-program platform expects. A newer variant called uni-app x uses a TypeScript-like language called UTS that compiles directly to Kotlin on Android, Swift on iOS, ArkTS on Harmony (Huawei's OS), and JavaScript for web and mini-programs, aiming for closer-to-native performance rather than a WebView-based approach. You would use uni-app if you are building a consumer-facing application that needs to reach users both as a native mobile app and within major Chinese super-app ecosystems from a single shared codebase. The stack is Vue.js for application logic, with a custom compiler and the HBuilderX IDE developed by DCloud as the recommended development environment.

Copy-paste prompts

Prompt 1
How do I set up a new uni-app project and deploy it to both WeChat Mini Programs and iOS using HBuilderX?
Prompt 2
Show me how to write a Vue.js component in uni-app that works across web, Android, and Douyin mini-programs.
Prompt 3
What are the differences between uni-app and uni-app x, and when should I use UTS instead of Vue.js?
Prompt 4
How do I handle platform-specific code in uni-app when iOS and WeChat Mini Programs need different implementations?
Prompt 5
Walk me through building a simple e-commerce app in uni-app that targets WeChat, Alipay, and the web.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.