Migrate

A collection of tools for migrating to Ghost.

Each tool has its own detailed documentation:

• Ghost
• beehiiv
• beehiiv Members
• Blogger
• Buttondown
• Chorus
• Curated
• Curated members
• Jekyll
• Letterdrop
• Libsyn
• Mailchimp Members
• Medium Content
• Medium Members
• Squarespace
• Stripe
• Substack
• Substack members
• Tiny News
• Tiny News Members
• WordPress API
• WordPress XML

Install

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

npm install --global @tryghost/migrate

Usage

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

Basic usage is migrate [source] source-info:

E.g.

migrate medium --pathToZip /path/to/export.zip

migrate wp-api --url https://mywpsite.com

Each source comes with optional flags to customise the migration:

migrate [source] --help will give more detail

Develop

This is a mono repository, managed with Nx and yarn workspaces.

1. git clone this repo & cd into it as usual
2. yarn setup to install all dependencies

Run

To make sure the TypeScript packages are built (immediately and after file changes), use

yarn build:watch

Or run yarn build once if you don't need the watching.

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

yarn dev [source]

Test

• yarn lint run just eslint
• yarn test run lint and tests

Publish

• yarn ship to interactively version bump and publish
  • Uses nx release under the hood — prompts per-package for the bump level
  • Publishes all packages which have changed
  • Also updates any packages which depend on changed packages

First release of a new package

When publishing a package for the first time, use yarn ship:first-release. This tells nx release to skip looking for previous git tags or npm registry versions, which would otherwise fail for an unpublished package.

1. Create the package in packages/ (see CLAUDE.md for the template)
2. Set "version": "0.0.0" in its package.json
3. Commit and merge to main
4. Run yarn ship:first-release — select the initial version when prompted

Copyright & License

Copyright (c) 2013-2026 Ghost Foundation - Released under the MIT license.