Skip to main content

​
Requirements

​
Create a new project

Use the Mercur CLI to scaffold a new project: 
npx @mercurjs/cli@canary create my-marketplace
The CLI will guide you through template selection and database configuration.

​
Initialize an existing project

If you have an existing Medusa project, initialize Mercur in it: 
npx @mercurjs/cli@canary init
This creates a blocks.json configuration file in your project.

​
Add blocks

Install blocks from the registry: 
npx @mercurjs/cli@canary add <block-name>
Browse available blocks: 
npx @mercurjs/cli@canary search

​
Run database migrations

After adding blocks that include modules: 
npx medusa db:generate <module1> <module2> ...
npx medusa db:migrate

​
Start the development server

npx medusa develop

​
Default credentials

If you used the CLI to create a new project with seed data: Vendor: 
email: seller@medusa-test.com
password: supersecret