# @co2-lab/mws

> A command line to organize some repositories under a centralized repository.

Latest version **1.0.13** (published 2023-04-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install @co2-lab/mws
pnpm add @co2-lab/mws
yarn add @co2-lab/mws
bun add @co2-lab/mws
```

Provides the command `mws`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.13 |
| Published | 2023-04-04 |
| First published | 2023-04-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 5 |
| Unpacked size | 14.1 KB |
| Known vulnerabilities | 0 (+4 in 2 direct dependencies) |
| Install scripts | no |
| Author | Codeco |
| Maintainers | codeco |

## Links

- npm: https://www.npmjs.com/package/@co2-lab/mws
- Repository: https://github.com/co2-lab/mws
- Homepage: https://github.com/co2-lab/mws#readme
- Issues: https://github.com/co2-lab/mws/issues
- npm.io page: https://npm.io/package/@co2-lab/mws

## Dependencies (5)

- [glob](https://npm.io/package/glob.md) ^9.3.4
- [yargs](https://npm.io/package/yargs.md) ^17.7.1
- [octokit](https://npm.io/package/octokit.md) ^2.0.14
- [prompts](https://npm.io/package/prompts.md) ^2.4.2
- [simple-git](https://npm.io/package/simple-git.md) ^3.17.0

## Recent versions

- 1.0.13 (latest) — 2023-04-04
- 1.0.11 — 2023-04-04
- 1.0.10 — 2023-04-04
- 1.0.9 — 2023-04-04
- 1.0.8 — 2023-04-04
- 1.0.7 — 2023-04-04
- 1.0.6 — 2023-04-04
- 1.0.5 — 2023-04-04
- 1.0.4 — 2023-04-04
- 1.0.3 — 2023-04-04
- 1.0.2 — 2023-04-04
- 1.0.1 — 2023-04-03

## README

# MWS - Modular Working Space

A command line to organize some repositories under a centralized repository.

## One More Option

- Different from git submodules you can manage every project as a normal git repo.

- Different from mono repo you can create some repositories for you project and manage them centralized.

## Install

using npm

    $ npm i -g @co2-lab/mws

using yarn

    $ yarn global add @co2-lab/mws

using pnpm

    $ pnpm add -g @co2-lab/mws

## How it works

You wanna create some repositories for your project...

example:

    https://github.com/co2-lab/module-1
    https://github.com/co2-lab/module-2

but you wanna manager all of then on the same IDE instance like a workspace, then you can create a centralizer repo.

You can create a git repo using the mws cli or using a existing git repo. For now let's consider the scenario of you create a git repo using the mws cli...

In any folder run the command **`mws create`** and answer the questions...

example:

    $ mws create --verbose
    $ What will be the workspace name ? my-project-workspace
    $ What will be the name of the repositories folder ? modules
    $ Do you want to push it to github ? yes
    $ What Github password or Personal Access Token can I use ? *******
    $ What will be the Github project name ? my-project-workspace
    $ Do you want to make the repo private ? no
    $ Starting workspace creation...
    $ Creating github repo...
    $ Done...

This command will create a folder named my-project-workspace with the mws config file inside, create a git repo named my-project-workspace (`https://github.com/co2-lab/my-project-workspace`) and push the content to the created repository.

Now, all you need to do is add the modules to your new workspace.

example:

    $ mws add-repo --verbose
    $ What is the git url of the repo that you want to clone ? https://github.com/co2-lab/module-1
    $ What should be the folder name where it should be cloned ? module-1
    $ Connect to ... ? Branch
    $ pull from ... ? main
    $ Starting to add a repo...
    $ Done...

    $ mws add-repo --verbose
    $ What is the git url of the repo that you want to clone ? https://github.com/co2-lab/module-2
    $ What should be the folder name where it should be cloned ? module-2
    $ Connect to ... ? Branch
    $ pull from ... ? main
    $ Starting to add a repo...
    $ Done...

This commands will clone the git repos within the **`my-project-workspace/modules`** folder.

example:

    my-project-workspace
     ├─ modules
     │   ├─ module-1
     │   │   └─ ...
     │   └─ module-2
     │       └─ ...
     └─ mws.json

If you prefer use a existing git repo, run the command **`mws init`**.

---
_Source: https://npm.io/package/@co2-lab/mws · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._