umijs /qiankun
📦 🚀 Blazing fast, simple and complete solution for micro frontends.
★ 16,703⑂ 2,053👁 220⑃ 931● 2,096▤ 147
+0
Daily
16,703
stars
2,053
forks
220
watchers
931
prs
2,096
issues
147
releases
README
Documentation · Quick start · Live examples · Roadmap English · 简体中文 qiankun(乾坤) [!WARNING] 🚧 qiankun 3.0 is currently under active development — check out the Roadmap for details. Looking for qiankun 2.x? Its documentation lives at v2.qiankun.umijs.org. In Chinese, qian(乾) means heaven and kun(坤) earth. qiankun is the universe. Qiankun enables you and your teams to build next-generation and enterprise-ready web applications leveraging Micro Frontends. It is inspired by and based on single-spa. 🤔 Motivation A quick recap about the concept of Micro Frontends: Techniques, strategies and recipes for building a modern web app with multiple teams using different JavaScript frameworks. — Micro Frontends Qiankun was birthed internally in our group during the time web app development by distributed teams had turned to complete chaos. We faced every problem micro frontend was conceived to solve, so naturally, it became part of our solution. The path was never easy, we stepped on every challenge there could possibly be. Just to name a few: - In what form do micro-apps publish static resources? - How does the framework integrate individual micro-apps? - How to ensure that sub-applications are isolated from one another (development independence and deployment independence) and runtime sandboxed? - Performance issues? What about public dependencies? - The list goes on long ... After solving these common problems of micro frontends and lots of polishing and testing, we extracted the minimal viable framework of our solution, and named it qiankun, as it can contain and serve anything. Not long after, it became the cornerstone of hundreds of our web applications in production, and we decided to open-source it to save you the suffering. TLDR: Qiankun is probably the most complete micro-frontend solution you ever met🧐. ✨ Features Qiankun inherits the fundamentals of single-spa — independent deployment, lazy loading, and a technology-agnostic host that never dictates a micro app's stack — and adds the pieces a real product needs: - 📄 HTML entry — point qiankun at a URL, not a manifest of assets. The entry HTML is streamed into the container as it arrives and can appear progressively before the response finishes. - 🧳 JS sandbox — enabled by default through a Proxy-membrane view of window and document. Global property writes stay local, and tracked timers, event listeners, and dynamic resources are cleaned up on unmount. - 📦 Native ESM — micro apps execute as real modules, routed through the membrane with dynamically injected import maps. Dynamic import() works, and so does a Vite dev server. - 🛡 Style isolation — opt-in runtime scoping built on the CSS @scope at-rule, including external stylesheets. No rewriting your CSS, no Shadow DOM tax. - ⚡ Automatic preloading — automatically discovers and preloads scripts and stylesheets while streaming the HTML entry. The pre-activation prefetch API prefetchApps is kept for backward compatib
Top issues
#1257想问一下,未来是否考虑支持 vite58 comments · 2021-02-05#1865主应用和子应用都是用Vue3+VueRouter4,点击主应用中菜单进行router.push,对应同一个activeRule的子应用来回切换,会重复创建子应用实例39 comments · 2021-12-10#1777分享你的 demo [ Share your demo ]38 comments · 2021-10-23#442[RFC] 2.0 文档计划31 comments · 2020-04-16#1963[Feature Request] 关于样式隔离26 comments · 2022-02-13#830[Feature Request] 关于子系统的热重载问题25 comments · 2020-08-06#1453官网的angular配置子应用报错:Expected to not be in Angular Zone, but it is!21 comments · 2021-05-18#452如何使用angular作为基座21 comments · 2020-04-17
Discussions
#3119Academic Survey: Impact of Micro-frontend Adoption in Companies (5–7 min)0 comments · 2026-03-02#3118Academic Survey: Impact of Micro-frontend Adoption in Companies (5–7 min)0 comments · 2026-03-02#3087nuxt3 嵌入qiankun1 comments · 2025-08-26#3085基于 2.10.16 tag 执行 yarn examples:install 报错0 comments · 2025-08-19#3069目前乾坤还在维护吗?感觉很久没有新消息了。1 comments · 2025-05-29#3068多个大屏项目可以接入qiankun吗?0 comments · 2025-05-21#3065【请求帮助】初始化主应用时,activeRule并不满足,如何去加载子应用,或者满足activeRule 并不需要去跳转子应用的页面0 comments · 2025-05-08#3063发到线上后,vite子应用无法加载0 comments · 2025-05-06
Latest release
v2.10.16 v2.10.16 2023-11-15- ⚡️ remove object spread operator for faster performance in big array iterator (2812) e75952fa https://github.com/kuitos/qiankun/compare/v2.10.15...v2.10.16