Sync

Since the Host and Remote live in separate repositories, there is a small helper library called mono-utils that handles syncing between them.

The templates Mono Host and Mono Remote already ship with mono-utils installed.

Setup Sync

Both Mono Host and Mono Remote use these files to handle the syncing process:

mono-vue/
├── .apps/
├── mono.apps.json
├── package.json
├── .env.dev
└── .env

mono.apps.json

Points to the apps you want to sync. If you're on a Remote, list your Host here:

[
  {
    "name": "mono-host",
    "url": "https://github.com/EJI-ICT/mono-host.git",
    "branch": "main",
    "path": ".apps",
    "envToken": "MONO_TOKEN"
  }
]

.env and .env.dev

The envToken above (MONO_TOKEN) lives in .env or .env.dev — just a normal GitHub token.

MONO_TOKEN=YOUR_GITHUB_TOKEN

package.json

The sync script:

{
  "name": "mono-vue",
  "private": true,
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "mono:sync": "dotenv -e .env.dev -- node ./node_modules/mono-utils/dist/mono-clone.mjs",
    ...
  },
  "dependencies": {
    ...
  },
  "devDependencies": {
    ...
  }
}

Run Sync

Then run:

pnpm mono:sync

It will download each app listed in mono.apps.json using the GitHub token from .env.dev or .env, and place them into your .apps/ folder.