Skip to main content
Version: 2.x

# Introduction

🎼 micro -lc is an open source micro-frontend orchestrator .

🧱 micro -lc offers a solution for building flexible , multi-tenant frontend applications.

🖼 micro -lc is well suited to build any type of web application , from classical top-bar/sidebar multi-pages websites, to CMSs, blogs, or even applications with no layout at all.

⚡ micro -lc aims to be as lightweight as possible and to improve web security .

🔗 micro -lc brings together different micro-frontend patterns inside the same application.

🏃 micro -lc consists of a core interface that loads, embeds, and orchestrates individual frontend applications at runtime , while providing configuration options and useful out-of-the-box features .

## Rationale ​

In a world of frontend monoliths, the micro-frontend pattern brings to the frontend world the benefits microservice architecture brought to backend development. We are talking about scalability, technological agnosticism, faster development and delivery time, maintainability, and governance complexity reduction, just to name a few.

One of the greatest challenges when taking this architectural approach is making sure that all the independent micro-frontend application behave in a cohesive way , both in terms of user interface (e.g., styling, theming, branding) and user experience (e.g., state sharing, routing, error handling).

micro -lc has been designed to help overcome this challenge, offering the stability and unity of a centralized orchestrator, while maintaining the flexibility needed to mold the application to each unique use case.

## Features ​

micro -lc supports three different micro-frontend patterns at the same time: iframes , parcels , and shadowed components .

An iframe is an external websites embedded into our application. A parcel instead is a fully-fledged (possibly single-page) application which lives within the context of the main application, but is JS-sandboxed and routed. Finally, shadowed components refer to business logic encapsulation via web components which allows to protect from style leaks and to scope events using HTML5 elements Shadow DOM.

Orchestration happens at run-time so that a JSON (or YAML) configuration is all micro -lc needs to add a new micro-frontend application. Configurations can be hot-swapped or edited at run time, meaning a page refresh is enough to preview your application after config changes.

micro -lc provides a smooth navigation experience between different applications, SPAs, and iframes while wrapping them in a static layout.

It ships as a CDN bundle that can be embedded into HTML pages or other scripts, and as a Docker container that can be configured with volumes.

micro -lc is heavily inspired by and based on micro-frontend orchestration tools such as single-spa and qiankun .

By orchestrating micro-frontend applications, micro -lc achieves a fair amount of benefits:

- applications written in different frameworks can live together on the same page;
- applications can be deployed independently ;
- applications can communicate through standard APIs leveraging also event-driven patterns.

Compared to other tools, micro -lc provides:

- live configuration and preview;
- centralized styling APIs;
- HTML-like composition tools ( lit-html );
- import map integration ( es-module-shims ).

## Browser compatibility ​

IE 11 | Edge 79+ | Firefox 67+ | Chrome 64+ | Safari 11.1+ | Opera 51+
--- | --- | --- | --- | --- | ---
✖ | ✔ | ✔ | ✔ | ✔ | ✔