Skip to content

empjs/emp

Repository files navigation

EMP Federation Fox

EMP v4

EMP Federation Fox · 高性能微前端联邦构建 · ESM 输出 · TS 7 稳定类型基线

@empjs/cli version Rspack dependency version Module Federation dependency version Node engine version package manager version license

微前端联邦 · Rspack 2 构建 · ESM 优先输出 · TypeScript 7 stable · 框架插件生态


EMP 是面向高性能微前端工程的构建工具。它把 Rspack 2、Module Federation 2、ESM 输出、TypeScript 7 stable 类型基线和常用框架插件收在一套配置模型里,让 host、remote、shared、manifest、DTS 和运行时适配都由工具链统一处理。

EMP Federation Fox 是 v4 的新视觉系统:docs/assets/emp-v4-readme-logo.png 用于 README 顶部项目 IP,docs/assets/emp-federation-fox-full.png 用于官网首屏,compact 狐头用于导航和小尺寸入口,monochrome / outline 版本用于周边、深浅底和弱品牌场景。

v4 的重点是换到新的构建、联邦与类型底座,同时尽量保留 EMP 既有的使用习惯。业务项目可以继续围绕 EMP 插件组织配置,把更多精力放在模块拆分、依赖共享和应用交付上。

当前 v4 文档面向正式版发布;顶部 badge 从 npm latest manifest 和 v4 分支的 packageManager 字段动态读取,README 不再维护手写版本号。

v4 快速开始和迁移步骤见 EMP v4 迁移指南

核心功能

  • 微前端联邦:封装 host、remote、shared、runtime、manifest 和类型声明生成。
  • Rspack 构建:覆盖开发服务、生产构建、本地预览和构建分析等常见流程。
  • ESM 优先输出:支持 build.useESMmodern-module library 和 preserveModules,让现代浏览器、联邦 remote 与静态服务直接消费标准模块产物。
  • TS 7 稳定类型基线:根脚本固定 TypeScript 7 stable,并通过 tsconfig、CLI、plugin、share、chain 的兼容检查守住 DTS 与样式类型边界。
  • 框架插件:提供 React、Vue 2、Vue 3、Tailwind CSS、Lightning CSS 等接入能力。
  • 共享依赖治理:统一处理单例依赖、版本协商和运行时加载,减少重复配置。
  • 工程化基础:提供 CLI、chain 配置层、共享 Biome 配置和包内类型声明。

v4 优势

  • Rspack 2 构建基础:获得新的性能和能力,同时沿用 webpack 生态里熟悉的配置模型。
  • 官方 Module Federation:@empjs/share 使用官方 2.x 包,减少历史 fork 带来的维护成本。
  • 平滑迁移:保留 pluginRspackEmpShare(...) 这条用户侧 API,已有项目不需要重写联邦配置。
  • ESM-first 输出:build.useESM 会自动切到 Rspack modern-module 产物形态,同时保留必要的 CJS 兼容出口。
  • TS 7 稳定链路:ci:verify 覆盖 TypeScript 7 stable 的 tsconfig、CLI 和核心包类型检查,提前暴露 DTS、样式模块和联邦类型兼容问题。
  • Node 生态对齐:Node 基线跟随 ESM-only 工具链要求,覆盖 require(esm) 默认启用后的运行环境。

QQ 交流群

EMP QQ group

About

EMP Micro FE Base on Rspack & module federation

Topics

Resources

Stars

2.4k stars

Watchers

28 watching

Forks

Packages

 
 
 

Contributors