Create a new project

It's good practice to keep one conversion project for each store that you want to migrate to Shopify. Here's how you can create one.

Instructions

To create a new conversion project, use the new sub-command:

$ shopify_transporter new example-magento-conversion --platform=magento

This will create a new project folder named example-magento-conversion targeted for the magento platform in the current directory.

Switch to the project folder:

$ cd example_magento_migration

Install all necessary gem dependencies:

$ bundle install

The above command must be executed before any custom pipeline stages can be created or run.

Conversion Project Structure

The new command creates the project folder with the following files:

Gemfile

The Gemfile references the shopify_transporter gem. It also allows custom pipeline stages to refer to the base classes that are defined in the shopify_transporter gem.

config.yml

config.yml provides the configuration required for each pipeline stage in the conversion process. This file is specific to the third-party platform that you are converting to Shopify.

custom pipeline stages

This folder will hold additional custom pipeline stages you may define later.