This is an example microfrontend repo demonstrating how to use single-spa. You can see the code running at https://polyglot.microfrontends.app.
This repository is a javascript project that creates a javascript bundle that is an in-browser javascript module (explanation on youtube / bilibili). The currently deployed version of the in-browser module can be seen at https://polyglot.microfrontends.app/importmap.json.
This project uses Vue, Vue CLI, and vue-cli-single-spa-plugin. It was created with create-single-spa
Whenever a pull request is merged to master, CircleCI builds and deploys the project. The "workflows" view (pictured below) can be seen if you are logged into CircleCI. Deployments for this in-browser module are completely independent of deployments for any other module.
Tutorial video: youtube / bilibili
There are two ways to do local development. It is preferred to do one module at a time, whenever possible.
cd clients
yarn install
yarn startGo to https://localhost:8500/js/app.js and verify that you are able to load the file without any SSL problems. To solve SSL problems, see these instructions.
Now, go to https://polyglot.microfrontends.app. In the browser console, run the following:
localStorage.setItem('devtools', true);Refresh the page. Click on the tan / beige rectangle:
Set an import map override to https://localhost:8500/js/app.js.
Refresh the page. Your local code for this module will now be running on https://polyglot.microfrontends.app. You may make changes locally and refresh the page to see them.
Run the root-config project locally:
cd root-config
yarn install
yarn start
Now follow the steps above for "One module at a time" for each of the modules you wish to work on.
Feel free to fork and modify any files you would like when doing a proof of concept for your organization. When it's time to actually create / adapt your organization's projects, consider using create-single-spa instead of forking this repository.