Coding Challenge - Medusa Application

Documentation | Website

Prerequisites

Before starting this coding challenge, ensure you have the following installed on your computer:

• Docker Desktop (or Docker Engine + Docker Compose)
• Node.js (version 20 or higher recommended)
• npm (comes with Node.js)

To verify your installations, run:

docker --version
docker compose version
node --version
npm --version

Setup Instructions

Follow these steps carefully to set up your Medusa development environment:

1. Clone and Navigate to the Project

cd /path/to/medusa-store-mytest

2. Install Dependencies

npm install --legacy-peer-deps

Note: The --legacy-peer-deps flag is required to resolve dependency conflicts.

3. Configure Environment Variables

Create your environment configuration file:

cp .env.template .env

The .env file contains essential configuration for your Medusa application, including CORS settings, Redis URL, and database configuration.

4. Start Medusa app

Start the Medusa app:

npm run docker:up

This will start your Medusa app, including the database and Redis. Automatically, it will seed your DB as well.

5. Create an Admin User

Create your first admin user to access the Medusa Admin dashboard:

docker compose run --rm medusa npx medusa user -e admin@example.com -p supersecret

The Medusa server will start on http://localhost:9000

6. Verify the Installation

Access the Admin Dashboard

1. Open your browser and navigate to: http://localhost:9000/app
2. Login with your credentials:
   • Email: admin@example.com
   • Password: supersecret
3. If you can access the dashboard, your setup is successful! 🎉

Get the Publishable API Key

1. In the Admin dashboard, go to: Settings → Publishable API Keys: http://localhost:9000/app/settings/publishable-api-keys
2. Copy the API key token
3. Save this token - you'll need it to connect your Storefront application

Additional Resources

For more detailed information:

• Medusa Documentation
• Installation Guide
• System Requirements

Compatibility

This starter is compatible with versions >= 2 of @medusajs/medusa.

Getting Started

Visit the Quickstart Guide to set up a server.

Visit the Docs to learn more about our system requirements.

What is Medusa

Medusa is a set of commerce modules and tools that allow you to build rich, reliable, and performant commerce applications without reinventing core commerce logic. The modules can be customized and used to build advanced ecommerce stores, marketplaces, or any product that needs foundational commerce primitives. All modules are open-source and freely available on npm.

Learn more about Medusa’s architecture and commerce modules in the Docs.

Community & Contributions

The community and core team are available in GitHub Discussions, where you can ask for support, discuss roadmap, and share ideas.

Join our Discord server to meet other community members.

Other channels

• GitHub Issues
• Twitter
• LinkedIn
• Medusa Blog