Need help with qiankun?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

8.6K Stars 938 Forks MIT License 562 Commits 123 Opened issues


📦 🚀 Blazing fast, simple and completed solution for micro frontends.

Services available


Need anything else?

Contributors list


npm version coverage npm downloads Build Status

In Chinese traditional culture

means heaven and
stands for earth, so
is the universe.

An implementation of Micro Frontends, based on single-spa, but made it production-ready.

🤔 Motivation

As we know what micro-frontends aims for:

Techniques, strategies and recipes for building a modern web app with multiple teams using different JavaScript frameworks. — Micro Frontends

Modularity is very important for large application. By breaking down a large system into individual sub-applications, we can achieve good divide-and-conquer between products and when necessary combination, especially for enterprise applications that usually involve multi-team collaboration. But if you're trying to implement such a micro frontends architecture system by yourself, you're likely to run into some tricky problems:

  • In what form do sub applications publish static resources?
  • How does the main application integrate individual sub-applications?
  • How do you ensure that sub-applications are independent of each other (development independent, deployment independent) and runtime isolated?
  • Performance issues? What about public dependencies?
  • And so on...

After solving these common problems of micro frontends, we extracted the kernel of our solution after a lot of internal online application testing and polishing, and then named it


Probably the most complete micro-frontends solution you ever met🧐.

📦 Installation

$ yarn add qiankun  # or npm i qiankun -S

📖 Documentation

💿 Getting started

This repo contains an

folder with a sample Shell app and multiple mounted Micro FE apps. To run this app, first clone
$ git clone
$ cd qiankun

Now run the yarn scripts to install and run the examples project:

$ yarn install
$ yarn examples:install
$ yarn examples:start



:sparkles: Features

  • 📦 Based On single-spa
  • 📱 Technology Agnostic
  • 💪 HTML Entry Access Mode
  • 🛡 Style Isolation
  • 🧳 JS Sandbox
  • Prefetch Assets
  • 🔌 Umi Plugin Integration

🎯 Roadmap

  • [x] Parcel apps integration (multiple sub apps displayed at the same time, but only one uses router at most)
  • [x] Communication development kits between master and sub apps
  • [ ] Custom side effects hijacker
  • [ ] Nested Microfrontends


👬 Community

🎁 Acknowledgements

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.