Built by

Deathwish98

Category

CMS

Version

1.0.9-dev

Last updated

Sep 9, 2023, 05:51:27 AM7 months ago

Medusa Strapi Plugin

Setting up your store

  • Initialize a
    Copy to clipboard
    medusa
    project by using a starter
    yarn create medusa-app
    OR
    npx create-medusa-app
  • Choose
    Copy to clipboard
    medusa-starter-default
    ? Which Medusa starter would you like to install?
    ❯ medusa-starter-default
    medusa-starter-contentful
    Other
  • Pick any storefront starter
    Which storefront starter would you like to install?
    ❯ Gatsby Starter
    Next.js Starter
    None
  • Make sure
    Copy to clipboard
    redis
    is installed and running
    $ redis-cli
    127.0.0.1:6379> ping
    PONG
  • Go to backend directory.
    cd <Your project name>/backend
  • Make sure your packages version in
    Copy to clipboard
    package.json
    match this -
    "@medusajs/medusa": "^1.1.49",
    "@medusajs/medusa-cli": "^1.1.22",
    "medusa-fulfillment-manual": "^1.1.26",
    "medusa-interfaces": "^1.1.27",
    "medusa-payment-manual": "^1.0.8",
    "medusa-payment-stripe": "^1.1.30",
    "mongoose": "^5.13.3",
    "typeorm": "^0.2.36"
  • Edit
    Copy to clipboard
    medusa-config.js
    . Navigate to the end of file and make sure this line is not commented out -
    redis_url: REDIS_URL,
  • In the same file, add this object to plugins array -
    {
    resolve: `medusa-plugin-strapi`,
    options: {
    strapi_medusa_user: 'medusa_user',
    strapi_medusa_password: 'medusaPassword1',
    strapi_url: '127.0.0.1',
    strapi_port: '1337'
    }
    }
  • Create and navigate to
    Copy to clipboard
    plugins
    directory and pull
    Copy to clipboard
    medusa-plugin-strapi
    cd plugins
    git clone https://github.com/Deathwish98/medusa-plugin-strapi.git
  • Install dependencies and build project files
    cd medusa-plugin-strapi
    npm install
    npm run build
  • Start medusa server from
    Copy to clipboard
    backend
    directory
    cd ../../
    npm run seed
    npm run start
Your local Medusa server should now be running on port 9000.

Setting up strapi

This plugin assumes that you are familiar with strapi. If you have not used it before, visit the official docs for more info -
  • Create a new strapi project using our template.
    npx create-strapi-app@3.6.8 strapi-medusa --template https://github.com/Deathwish98/strapi-medusa-template.git
    OR
    yarn create strapi-app strapi-medusa --template https://github.com/Deathwish98/strapi-medusa-template.git
  • Start strapi server.
    npm run develop <---- For development purposes
    OR
    npm run start
    NOTE: If you are using
    Copy to clipboard
    SQLite
    there is a known
    Copy to clipboard
    knex.js
    bug -
    error KnexTimeoutError: Knex: Timeout acquiring a connection. The pool is probably full. Are you missing a .transacting(trx) call?
    It appears after running
    Copy to clipboard
    npm run develop
    for the first time . Just run the command again and it should disappear.
Visit docs.medusa-commerce.com for further guides.

Build your own plugins

Develop your own plugins with our API to speed up your processes.

Make your plugin available via npm for it to be shared in our Plugin Library with the broader Medusa community.