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

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

Description

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

Services available

!
?

Need anything else?

Contributors list

qiankun(乾坤)

npm version coverage npm downloads Build Status

In Chinese traditional culture

qian
means heaven and
kun
stands for earth, so
qiankun
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

qiankun
.

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

📦 Installation

$ yarn add qiankun  # or npm i qiankun -S

📖 Documentation

https://qiankun.umijs.org/

💿 Getting started

This repo contains an

examples
folder with a sample Shell app and multiple mounted Micro FE apps. To run this app, first clone
qiankun
:
$ git clone https://github.com/umijs/qiankun.git
$ cd qiankun

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

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

Visit

http://localhost:7099
.

: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

❓ FAQ

https://qiankun.umijs.org/faq/

👬 Community

https://qiankun.umijs.org/#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.