With the new
tool you will get your Medusa development environment ready within a couple of minutes. After completion, you will have a Medusa backend, a Gatsby or Next.js storefront, and an admin dashboard up and running on your local machine.Copy to clipboardcreate-medusa-app
Starting a new e-commerce project just got easier, now with one command.
Getting started with Copy to clipboardcreate-medusa-app
Copy to clipboard
create-medusa-app
Use
with your preferred package manager:Copy to clipboardcreate-medusa-app
Behind the scenes,
is populating your database with some initial set of mock data, which helps to interact with Medusa setup intuitively straight away.Copy to clipboardcreate-medusa-app
Right after hitting one of those commands, the multistep installation process will be initiated, so the starter can be shaped right for the specific needs.
Destination folder
Enter the path to the directory that will become the root of your Medusa project:
Pick the starter you prefer
You will be presented with three options:
is the most lightweight version of a Medusa projectCopy to clipboardmedusa-starter-default
almost like the default starter, but withCopy to clipboardmedusa-starter-contentful
preinstalledCopy to clipboardmedusa-plugin-contentful
if you have a different starter that you would wish to install fromCopy to clipboardOther
will give you the option of providing a URL to that starter. An additional question will be asked if you choose this option:Copy to clipboardOther
For the walkthrough purposes, we assume that the selected starter is
and proceed to the next step.Copy to clipboardmedusa-starter-default
Selecting a Storefront
After selecting your Medusa starter you will be given the option to install one of our storefront starters. At the moment we have starters for Gatsby and Next.js:
You may also select
if the choice is to craft a custom storefront for your product.Copy to clipboardNone
now has all of the info necessary for the installation to begin.Copy to clipboardcreate-medusa-app
Once the installation has been completed you will have a Medusa backend, a demo storefront, and an admin dashboard.
What's inside
Inside the root folder which was specified at the beginning of the installation process the following structure could be found:
prints out the commands that are available to you after installation. When each project is started you can visit your storefront, complete the order, and view the order in Medusa admin.Copy to clipboardcreate-medusa-app
What's next?
To learn more about Medusa to go through our docs to get some inspiration and guidance for the next steps and further development:
- Find out how to set up a Medusa project with Gatsby and Contentful
- Move your Medusa setup to the next level with some custom functionality
- Create your own Medusa plugin
If you have any follow-up questions or want to chat directly with our engineering team we are always happy to meet you at our Discord.
Share this post
Try Medusa
Spin up your environment in a few minutes.

You may also like
On this page