umi
Umi is an extensible, convention-over-configuration React application framework from the Ant Group ecosystem, providing routing, build tooling, plugins, and conventions out of the box for enterprise-grade web apps.
Embed badge
[](https://opensources.dev/resource/umi)MITPermissive — free to use in commercial and proprietary software, with attribution.View license →
Production readiness
4/5- Actively maintainedCommits in the last 6 months
- No known vulnerabilitiesNot yet scanned
- Clear, usable licenseMIT (permissive)
- Proven adoptionWidely used
- Has documentationDocumentation indexed
npm install umiOur analysis
Umi is a pluggable, convention-based React framework developed within the Ant Group/Ant Design ecosystem, bundling routing, build tooling, and a rich plugin architecture for building enterprise web applications.
When to use umi
Choose Umi when building medium-to-large React applications, especially admin dashboards or enterprise apps using Ant Design, and you want file-based routing, batteries-included tooling, and a mature plugin system without assembling the stack yourself.
When not to
If you target an edge/serverless-first deployment with strong SSR/streaming needs, or want a minimal, framework-agnostic setup, Next.js or plain Vite are better fits. Umi's documentation and community are heavily China-centric, which can be a barrier for English-only teams.
Strengths
- Deeply integrated with Ant Design and the broader Ant Group toolchain (Pro, dumi, qiankun micro-frontends)
- Powerful plugin and convention system that reduces boilerplate
- File-based routing with built-in code splitting and data fetching conventions
- Battle-tested at scale inside Alibaba/Ant Group products
Trade-offs
- Much of the richest documentation and community support is in Chinese
- Opinionated conventions can feel restrictive or magical when you fight the framework
- Smaller global mindshare than Next.js, meaning fewer third-party tutorials and StackOverflow answers
- Migrating between major versions (e.g., Umi 3 to 4) has historically required nontrivial work
Maturity
Mature and actively maintained with 16k+ stars and wide adoption in Chinese enterprise frontends; backed by Ant Group, it powers Ant Design Pro and integrates with the qiankun micro-frontend ecosystem.
UmiJS
A static site base on dumi.
Development
# install dependencies
$ pnpm install
# start dev server
$ pnpm start
# build docs
$ pnpm run build
LICENSE
MIT