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_migration --platform=magento

This will create a new project folder named example_magento_migration 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 new project:

$  shopify_transporter new example_magento_migration --platform=magento
      create  magento_project/config.yml
      create  magento_project/Gemfile
      create  magento_project/lib/custom_pipeline_stages

Gemfile

Includes the shopify_transporter gem. This 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.

For example, the config.yml file generated for a Magento 1.x conversion project will look something like this.

Custom Pipeline Stages

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