explaingit

umijs/umi

Analysis updated 2026-06-24

16,024TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

TLDR

Opinionated React application framework with built-in routing, plugins, and TypeScript support. Popular in the Chinese React ecosystem.

Mindmap

mindmap
  root((umi))
    Inputs
      Page files
      Plugin config
      Routes config
    Outputs
      Production bundle
      Dev server
      Routing layer
    Use Cases
      Build a React SPA
      Build an admin dashboard
      Use as a Next-like framework
    Tech Stack
      React
      TypeScript
      Webpack
      Node.js
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Bootstrap a React single-page app with routing and TypeScript already wired up

USE CASE 2

Build an admin dashboard using the Ant Design Pro stack on top of Umi

USE CASE 3

Extend Umi with a custom plugin to inject build steps or runtime behavior

What is it built with?

ReactTypeScriptNode.jsWebpack

How does it compare?

umijs/umijavascript-obfuscator/javascript-obfuscatoramplication/amplication
Stars16,02416,03115,998
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity3/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Documentation is primarily at umijs.org. Some docs and community resources are Chinese-first.

MIT licensed. Use it for anything including commercial work as long as you keep the copyright notice.

In plain English

Umi is a framework for building web applications using React (a popular JavaScript library for creating user interfaces). Think of a framework as a set of pre-built tools and conventions that give you a head start when building a web app, so you don't have to figure out every small detail from scratch. Umi is specifically designed to work within the React ecosystem, providing structure, routing (navigation between pages), and other essentials out of the box. It is built with TypeScript, which is a version of JavaScript that adds extra rules to help catch errors before your code runs. This tool would be useful if you are building a web application with React and want something that handles common setup and configuration for you, rather than wiring everything together manually. It is aimed at developers who want a structured starting point and a community-supported set of conventions to follow. The README is minimal and points to the official documentation at umijs.org for full details. The project has an active community of contributors and is open-source under the MIT license, meaning it is free to use and modify.

Copy-paste prompts

Prompt 1
Scaffold a new Umi app with TypeScript and add a /dashboard route that loads a chart
Prompt 2
Show me how to write a Umi plugin that adds a custom Webpack loader to my project
Prompt 3
Migrate a Create React App project to Umi and preserve my existing routes
Prompt 4
Explain how Umi conventional routing differs from Next.js file-based routing

Frequently asked questions

What is umi?

Opinionated React application framework with built-in routing, plugins, and TypeScript support. Popular in the Chinese React ecosystem.

What language is umi written in?

Mainly TypeScript. The stack also includes React, TypeScript, Node.js.

What license does umi use?

MIT licensed. Use it for anything including commercial work as long as you keep the copyright notice.

How hard is umi to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is umi for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub umijs on gitmyhub

Verify against the repo before relying on details.