Prebaked medusajs 2.0 monorepo

Backend + Storefront + postgres + redis + MinIO + MeiliSearch

one-click deploy on railway!

Need help?
Step by step deploy guide, and video instructions

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 the officially released MedusaJS 2.0 backend and storefront application. It is a pre-configured, ready-to-deploy solution, modified for seamless deployment on railway.app.

Updated: to version 2.8.8 🥳

Preconfigured 3rd party integrations

• MinIO file storage: Replaces local file storage with MinIO cloud storage, automatically creating a 'medusa-media' bucket for your media files. README
• Resend email integration Watch setup video - special thanks to aleciavogel for Resend notification service, and react-email implementation! README
• Stripe payment service: Watch setup video
• Meilisearch integration by Rokmohar: Adds powerful product search capabilities to your store. When deployed on Railway using the template, MeiliSearch is automatically configured. (For non-railway'ers: Watch setup video)

AI & Automation Services

Medusa MCP Server

Located in /services/medusa-mcp, this is a Model Context Protocol server that enables AI assistants (like Claude) to interact with the Medusa backend. Features include:

• Product Management: AI can list, create, update products
• Order Processing: Automate order management via AI
• Customer Insights: AI-powered customer analytics
• Local development: cd services/medusa-mcp && npm run dev
• Railway deployment: Deployed as a separate service with health checks

N8N Workflows

Pre-configured automation workflows in /n8n-workflows/:

• Order Automation: Intelligent order processing with VIP detection
• AI Chatbot: 24/7 customer support
• SEO Optimizer: Automatic product SEO enhancement
• Component Generator: AI-powered React component creation

/backend

local setup

Video instructions: https://youtu.be/PPxenu7IjGM

• cd /backend
• pnpm install or npm i
• Rename .env.template -> .env
• To connect to your online database from your local machine, copy the DATABASE_URL value auto-generated on Railway and add it to your .env file.
  • If connecting to a new database, for example a local one, run pnpm ib or npm run ib to seed the database.
• pnpm dev or npm run dev

requirements

• postgres database (Automatic setup when using the Railway template)
• redis (Automatic setup when using the Railway template) - fallback to simulated redis.
• MinIO storage (Automatic setup when using the Railway template) - fallback to local storage.
• Meilisearch (Automatic setup when using the Railway template)

commands

cd backend/ npm run ib or pnpm ib will initialize the backend by running migrations and seed the database with required system data. npm run dev or pnpm dev will start the backend (and admin dashboard frontend on localhost:9000/app) in development mode. pnpm build && pnpm start will compile the project and run from compiled source. This can be useful for reproducing issues on your cloud instance.

/storefront

local setup

Video instructions: https://youtu.be/PPxenu7IjGM

Install dependencies npm i of pnpm i Rename .env.local.template -> .env.local

requirements

• A running backend on port 9000 is required to fetch product data and other information needed to build Next.js pages.

commands

cd storefront/ npm run dev or pnpm dev will run the storefront on uncompiled code, with hot-reloading as files are saved with changes.

Useful resources

• How to setup credit card payment with Stripe payment module: https://youtu.be/dcSOpIzc1Og
• https://funkyton.com/medusajs-2-0-is-finally-here/#succuessfully-deployed-whats-next

A template by,