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
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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/run-mfs.git
28
- cd run-mfs
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
- ### `mfer install`
114
- Install dependencies for all micro frontends in a group.
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 clone`
117
- Clone repositories that don't exist locally.
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/run-mfs.git
252
- cd run-mfs
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.0", "-v, --version", "mfer CLI version")
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.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
- });
@@ -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;