matheusmr13 / create-micro-react-app

✨ Create a microfrontend architecture as simple as CRA.

✨ Create Micro React App

Most complete approach to microfrontend architecture:

• Library to export and import microfrontends; know more...
• Command line interface to create, development and release your app; know more...
• Backoffice to simplify all complexity needed; know more...
• Simple just like Create React App.

If you want to know more about microfrontends and why you should (or shouldn't) use it, check this article.

⚡ Quick Overview

  npx @cmra/cli create my-app
  cd my-app
  npm start

🚀 Demo

Microfrontend Store: Demo

💾 Installing

To install our cli you need Node >= 13.

npm

  npm i -g @cmra/cli

yarn

  yarn global add @cmra/cli

💻 Using it

After installing it, you'll have cmra command available:

  cmra create my-app

It will generate a folder structure like:

  my-app
  ├── package.json
  ├── packages
  |  ├── microfrontend # create-react-app structure folder
  |  |  ├── README.md
  |  |  ├── package.json
  |  |  ├── public
  |  |  |  ├── favicon.ico
  |  |  |  ├── index.html
  |  |  |  ├── logo192.png
  |  |  |  ├── logo512.png
  |  |  |  ├── manifest.json
  |  |  |  └── robots.txt
  |  |  ├── src
  |  |  |  ├── App.css
  |  |  |  ├── App.js
  |  |  |  ├── App.test.js
  |  |  |  ├── index.css
  |  |  |  ├── index.js
  |  |  |  ├── logo.svg
  |  |  |  ├── serviceWorker.js
  |  |  |  └── setupTests.js
  |  |  └── yarn.lock
  |  └── webapp # create-react-app structure folder
  |     ├── README.md
  |     ├── package.json
  |     ├── public
  |     |  ├── favicon.ico
  |     |  ├── index.html
  |     |  ├── logo192.png
  |     |  ├── logo512.png
  |     |  ├── manifest.json
  |     |  ├── microfrontends
  |     |  |  └── meta.json
  |     |  └── robots.txt
  |     ├── src
  |     |  ├── App.css
  |     |  ├── App.js
  |     |  ├── App.test.js
  |     |  ├── index.css
  |     |  ├── index.js
  |     |  ├── logo.svg
  |     |  ├── serviceWorker.js
  |     |  └── setupTests.js
  |     └── yarn.lock
  └── yarn.lock

🔨 Development

First of all, check our contributing guide. If you have any questions just open an issue!

📚 Docs

https://matheusmr13.github.io/create-micro-react-app/docs/

---

Icon made by Freepik from www.flaticon.com

create-micro-react-app's Issues

Files Integrity

Some files when downloaded are corrupted, it seems like some files were downloaded on the half or missing some content.

Deprecated service worker lib

Replace sw-precache by workbox