Migrate

A collection of tools for migrating to Ghost.

Each tool has its own detailed documentation:

Install

Migrate is a set of command line tools, install them globally:

npm install --global @tryghost/migrate

Run migrate --help to see a list of available commands.

Basic usage is migrate [source] source-info:

E.g.

migrate medium path/to/export.zip

migrate wp-api https://mywpsite.com

Each source comes with optional flags to customise the migration:

migrate [source] --help will give more detail

This is a mono repository, managed with lerna.

git clone this repo & cd into it as usual
yarn setup is mapped to lerna bootstrap
- installs all external dependencies
- links all internal dependencies

To add a new package to the repo:

To run a local development copy, cd into this directory, and use yarn dev instead of migrate like so:

yarn dev [source]

yarn ship is an alias for lerna publish
- Publishes all packages which have changed
- Also updates any packages which depend on changed packages