Sample Code - Micro Frontends in Action

This is the example code that goes along with the Manning book Micro Frontends in Action.

Hosted examples

You can interact with the running examples here:
https://the-tractor.store 🚜

Local machine

Prerequisites

Clone this git repository or download & extract the zip to your local machine.
Make sure you have Node.js (v12 or newer) installed.
```
$ node -v
v14.4.0
```
Go into the main directory and install all required dependencies.
```
cd micro-frontends-in-action-code
npm install
```
Install Nginx on your machine. The nginx executable only has to be present - no configuration required.
- macOS (via Homebrew): brew install nginx
- Debian/Ubuntu: sudo apt-get install nginx
- Windows: Binaries included in this repository. No installation required.
Five examples require Nginx:
- 04_routing
- 05_ssi
- 06_timeouts_down
- 16_universal
- 18_asset_registration_include

Running the code

All examples involve starting up multiple applications which are owned by different teams. There is an NPM run for each directory. You can start examples like this: npm run [name_of_example].

The following command will start example #5:

npm run 05_ssi

The script starts all applications and shows a combined log output.
NOTE: Nginx stdout do not work on Windows.

It waits until the servers are ready and opens the example page in your default browser.

You can stop the example by hitting [CMD] + C in your terminal.

NOTE: The code should run on all platforms. However, if you're having troubles feel free to create an issue.

Folder structure and ports

Each example has its own folder (e.g. 05_ssi). Each example folder contains a subfolder that contains the actual application (e.g. nginx, decide, inspire).

Different port numbers are used to indicate ownership. This following table shows which teams owns which application. Make sure ports 3000 to 3003 are not allocated by another process on your machine.

Port	Team	Responsibility
`3000`	- shared -	infrastructure (web-server, app shell)
`3001`	Team Decide	product page
`3002`	Team Inspire	homepage, search, recommendations
`3003`	Team Checkout	cart, checkout process

List of all examples

Here is a list of all run commands with a reference to the chapter they belong to.

run script	name	chapter
`npm run 01_pages_links`	Pages & Links	2
`npm run 02_iframe`	iFrames	2
`npm run 03_ajax`	Namespaces	3
`npm run 04_routing`	Server-side Routing	3
`npm run 05_ssi`	Server-side Integration	4
`npm run 06_timeouts_down` `npm run 06_timeouts_short_delay` `npm run 06_timeouts_long_delay`	Timeouts & Fallbacks	4
`npm run 07_podium`	Podium	4
`npm run 08_web_components`	Client-side Composition	5
`npm run 09_shadow_dom`	Style Isolation & ShadowDOM	5
`npm run 10_parent_child_communication`	Parent-Child Communication	6
`npm run 11_child_parent_communication`	Child-Parent Communication	6
`npm run 12_fragment_fragment_communication`	Fragment-Fragment Communication	6
`npm run 13_client_side_flat_routing`	Client-side Routing (Flat)	7
`npm run 14_client_side_two_level_routing`	Client-side Routing (Two-Tiered)	7
`npm run 15_single_spa`	Single SPA	7
`npm run 16_universal`	Universal Rendering	8
`npm run 17_asset_client_redirect`	Asset Client-side Redirect	10
`npm run 18_asset_registration_include`	Asset Registration Include	10
`npm run 19_shared_vendor_webpack_dll`	Shared Vendor Libraries via Webpack DLLPlugin	11
`npm run 20_shared_vendor_rollup_absolute_imports`	Shared Vendor Libraries via Rollup.js and Absolute ES Module Imports	11
`npm run 21_local_development`	Local Development	14

nowy/micro-frontends-in-action-code