mfer 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -1,7 +1,32 @@
|
|
|
1
1
|
# mfer (Micro Frontend Runner)
|
|
2
2
|
|
|
3
|
+
[](https://opensource.org/licenses/MIT)
|
|
4
|
+
|
|
3
5
|
A powerful CLI tool designed to simplify the management and execution of multiple micro frontend applications. mfer helps developers run, update, and organize their micro frontend projects with minimal configuration and maximum efficiency.
|
|
4
6
|
|
|
7
|
+
## 📋 Table of Contents
|
|
8
|
+
|
|
9
|
+
- [🚀 Features](#-features)
|
|
10
|
+
- [📦 Installation](#-installation)
|
|
11
|
+
- [🛠️ Quick Start](#️-quick-start)
|
|
12
|
+
- [📋 Commands](#-commands)
|
|
13
|
+
- [mfer init](#mfer-init)
|
|
14
|
+
- [mfer run](#mfer-run)
|
|
15
|
+
- [mfer pull](#mfer-pull)
|
|
16
|
+
- [mfer install](#mfer-install)
|
|
17
|
+
- [mfer clone](#mfer-clone)
|
|
18
|
+
- [mfer config](#mfer-config)
|
|
19
|
+
- [mfer config list](#mfer-config-list)
|
|
20
|
+
- [mfer config edit](#mfer-config-edit)
|
|
21
|
+
- [mfer help](#mfer-help)
|
|
22
|
+
- [⚙️ Configuration](#️-configuration)
|
|
23
|
+
- [🎯 Use Cases](#-use-cases)
|
|
24
|
+
- [🔧 Advanced Usage](#-advanced-usage)
|
|
25
|
+
- [🐛 Troubleshooting](#-troubleshooting)
|
|
26
|
+
- [🤝 Contributing](#-contributing)
|
|
27
|
+
- [📄 License](#-license)
|
|
28
|
+
- [🙏 Acknowledgments](#-acknowledgments)
|
|
29
|
+
|
|
5
30
|
## 🚀 Features
|
|
6
31
|
|
|
7
32
|
- **Concurrent Execution**: Run multiple micro frontends simultaneously with organized output
|
|
@@ -24,8 +49,8 @@ npm install -g mfer
|
|
|
24
49
|
|
|
25
50
|
### Install from source
|
|
26
51
|
```bash
|
|
27
|
-
git clone https://github.com/srimel/
|
|
28
|
-
cd
|
|
52
|
+
git clone https://github.com/srimel/mfer.git
|
|
53
|
+
cd mfer
|
|
29
54
|
npm install
|
|
30
55
|
npm run build
|
|
31
56
|
npm install -g .
|
|
@@ -103,18 +128,52 @@ mfer pull # Pull from all repositories
|
|
|
103
128
|
mfer pull shared # Pull from shared components group only
|
|
104
129
|
```
|
|
105
130
|
|
|
131
|
+
### `mfer install [group_name]`
|
|
132
|
+
Install dependencies for all micro frontends in a group.
|
|
133
|
+
|
|
134
|
+
**Arguments:**
|
|
135
|
+
- `group_name`: Name of the group to install dependencies for (defaults to "all")
|
|
136
|
+
|
|
137
|
+
**Example:**
|
|
138
|
+
```bash
|
|
139
|
+
mfer install # Install dependencies for all micro frontends
|
|
140
|
+
mfer install frontend # Install dependencies for frontend group only
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
### `mfer clone [group_name]`
|
|
144
|
+
Clone repositories that don't exist locally.
|
|
145
|
+
|
|
146
|
+
**Arguments:**
|
|
147
|
+
- `group_name`: Name of the group to clone repositories from (defaults to "all")
|
|
148
|
+
|
|
149
|
+
**Example:**
|
|
150
|
+
```bash
|
|
151
|
+
mfer clone # Clone all repositories
|
|
152
|
+
mfer clone shared # Clone repositories in shared group only
|
|
153
|
+
```
|
|
154
|
+
|
|
106
155
|
### `mfer config`
|
|
107
156
|
Manage your configuration settings.
|
|
108
157
|
|
|
109
158
|
**Subcommands:**
|
|
110
|
-
- `mfer config edit`: Open configuration file in your default editor
|
|
111
159
|
- `mfer config list`: Display current configuration
|
|
160
|
+
- `mfer config edit`: Open configuration file in your default editor
|
|
112
161
|
|
|
113
|
-
|
|
114
|
-
|
|
162
|
+
**Example:**
|
|
163
|
+
```bash
|
|
164
|
+
mfer config list # Show current configuration
|
|
165
|
+
mfer config edit # Edit configuration in your editor
|
|
166
|
+
```
|
|
115
167
|
|
|
116
|
-
### `mfer
|
|
117
|
-
|
|
168
|
+
### `mfer help`
|
|
169
|
+
Display help information for mfer commands.
|
|
170
|
+
|
|
171
|
+
**Example:**
|
|
172
|
+
```bash
|
|
173
|
+
mfer help # Show general help
|
|
174
|
+
mfer help run # Show help for run command
|
|
175
|
+
mfer help config # Show help for config command
|
|
176
|
+
```
|
|
118
177
|
|
|
119
178
|
## ⚙️ Configuration
|
|
120
179
|
|
|
@@ -248,13 +307,15 @@ mfer config edit
|
|
|
248
307
|
For local development of mfer itself:
|
|
249
308
|
|
|
250
309
|
```bash
|
|
251
|
-
git clone https://github.com/srimel/
|
|
252
|
-
cd
|
|
310
|
+
git clone https://github.com/srimel/mfer.git
|
|
311
|
+
cd mfer
|
|
253
312
|
npm install
|
|
254
313
|
npm run build
|
|
255
314
|
npm install -g .
|
|
256
315
|
```
|
|
257
316
|
|
|
317
|
+
Refer to [local development](./docs/local-development.md) docs for more information.
|
|
318
|
+
|
|
258
319
|
## 🤝 Contributing
|
|
259
320
|
|
|
260
321
|
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
|
package/dist/index.js
CHANGED
|
@@ -10,7 +10,7 @@ import { loadConfig } from "./utils/config-utils.js";
|
|
|
10
10
|
program
|
|
11
11
|
.name("mfer")
|
|
12
12
|
.description("Micro Frontend Runner (mfer) - A CLI for running your project's micro frontends.")
|
|
13
|
-
.version("1.0.
|
|
13
|
+
.version("1.0.2", "-v, --version", "mfer CLI version")
|
|
14
14
|
.hook("preAction", (thisCommand, actionCommand) => {
|
|
15
15
|
console.log();
|
|
16
16
|
})
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mfer",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "CLI tool designed to sensibly run micro-frontends from the terminal.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"mfer": "dist/index.js"
|
|
@@ -9,7 +9,9 @@
|
|
|
9
9
|
"scripts": {
|
|
10
10
|
"build": "tsc",
|
|
11
11
|
"clean": "rimraf dist",
|
|
12
|
-
"watch": "tsc --watch"
|
|
12
|
+
"watch": "tsc --watch",
|
|
13
|
+
"test": "vitest run",
|
|
14
|
+
"test:watch": "vitest"
|
|
13
15
|
},
|
|
14
16
|
"keywords": [
|
|
15
17
|
"micro frontends",
|
|
@@ -38,7 +40,8 @@
|
|
|
38
40
|
"devDependencies": {
|
|
39
41
|
"@types/node": "^24.0.3",
|
|
40
42
|
"rimraf": "^6.0.1",
|
|
41
|
-
"typescript": "^5.8.3"
|
|
43
|
+
"typescript": "^5.8.3",
|
|
44
|
+
"vitest": "^3.2.4"
|
|
42
45
|
},
|
|
43
46
|
"dependencies": {
|
|
44
47
|
"@inquirer/prompts": "^7.5.3",
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export {};
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
import { Command } from "commander";
|
|
2
|
-
import { currentConfig } from "../../utils/config-utils.js";
|
|
3
|
-
const configCommand = new Command("config")
|
|
4
|
-
.description("prism configuration settings")
|
|
5
|
-
.option("-l, --list", "list the current configuration")
|
|
6
|
-
.action((options) => {
|
|
7
|
-
const { list, path } = options;
|
|
8
|
-
if (list) {
|
|
9
|
-
console.log(`\nCurrent configuration:\n`);
|
|
10
|
-
console.log(currentConfig);
|
|
11
|
-
console.log("");
|
|
12
|
-
}
|
|
13
|
-
if (path) {
|
|
14
|
-
}
|
|
15
|
-
});
|
|
16
|
-
export default configCommand;
|
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
import { Command } from "commander";
|
|
2
|
-
import { currentConfig } from "../../../utils/config-utils.js";
|
|
3
|
-
export const listConfigCommand = new Command("list")
|
|
4
|
-
.description("display the current configuration settings")
|
|
5
|
-
.action(() => {
|
|
6
|
-
console.log("current configuration!");
|
|
7
|
-
console.log(currentConfig);
|
|
8
|
-
});
|
package/dist/commands/config.js
DELETED
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
import { Command } from "commander";
|
|
2
|
-
import { currentConfig } from "../utils/config-utils.js";
|
|
3
|
-
const configCommand = new Command("config")
|
|
4
|
-
.description("prism configuration settings")
|
|
5
|
-
.option("-l, --list", "list the current configuration")
|
|
6
|
-
.action((options) => {
|
|
7
|
-
const { list, path } = options;
|
|
8
|
-
if (list) {
|
|
9
|
-
console.log(`\nCurrent configuration:\n`);
|
|
10
|
-
console.log(currentConfig);
|
|
11
|
-
console.log("");
|
|
12
|
-
}
|
|
13
|
-
if (path) {
|
|
14
|
-
}
|
|
15
|
-
});
|
|
16
|
-
export default configCommand;
|