Medusajs open source ecommerce platform
one-click deploy on railway!

Need help?
Step by step tutorial, with screenshots and video

New version alert!
Check out medusajs 2.0 (preview version)

Combine Medusa's modules for your commerce backend with the newest Next.js 14 features for a performant storefront.

About this boilerplate

This boilerplate is a monorepo consisting of snapshot of a medusajs backend and storefront app created with npx create-medusa-app@latest February 2024. Modified to be plug n' play deployable on railway.app!

medusajs-backend

railway setup

Please change the value of environtment variables: COOCKIE_SECRET and JWT_SECRET.

local setup

• Install dependencies yarn
• Rename .env.template -> .env
• To connect to your online database, from local; copy the DATABASE_URL value that have been auto generated on railway, and add to your .env

requirements

• postgres database (will be automatically generated if using railway template)
• redis (will be automatically generated if using railway template)

optional

• cloudinary: I highly recommend using a proper media service.
  1. Sign up a free account with cloudinary choose "developer API calls" type of user.
  2. Add your cloud_name, api_key & api_secret to .env.local this will eneable Cloudinary as a file service on local dev environment
  3. Configure the same environment variables in your railway dashboard to enable cloudinary in production.
  4. If the steps above was confusin, visit https://medusajs.com/plugins/medusa-file-cloudinary/ for more setup details.

commands

cd medusajs-backend/ yarn build will compile app. yarn dev will start local admin dashboard app to manage products and orders etc. yarn start will start the backend server, needed for the storefront

medusa-storefront

local setup

intall dependencies yarn Rename .env.local.template -> .env.local

requirements

• running backend npm run start - needed to fetch products data and more, to build nextjs pages.

commands

cd medusajs-storefront/ yarn wait will keep calling backend endpoint until a backend responds. yarn build will build the nextjs app - remember to start backend app prior to running this command. yarn start will serve the frontend web shop.