How to Set Up MedusaJS Backend with a Storefront on Vercel

This guide will help you set up a MedusaJS backend with a storefront on Vercel. Follow the steps below to get your e-commerce store up and running.

Prerequisites

  1. Medusa.js Backend installed on Nomodo.io
  2. Vercel account
  3. Medusa Next.js Starter Template installed on the Vercel (GitHub, Documentation)

1. Set Environmental variable in Medusa backend

To allow any domain to access your Medusa.js backend, set the STORE_CORS environment variable to *. This wildcard value allows any origin, which is useful for development or public APIs where you want to ensure maximum accessibility and avoid CORS-related issues. However, be careful when using this setting in production environments, as it removes the security benefits of restricting access to specific domains.

  1. Go to SettingsEnvironment Variables
  2. Fill the Key with STORE_CORS and the Value with *
  3. Save and Restart to apply settings
💡
When you go to the production, replace * with the URL where your storefront is live (https://).

2. Connect Storefront on Vercel with Backend

Copy and paste the backend URL from your Medusa backend instance into the environment variable in the storefront. This action tells the storefront where to find data for products, etc.

  1. Open your Medusa app detail
  2. Copy Backend URL
  3. Open your storefront detail on the Vercel
  4. Add environmental variable NEXT_PUBLIC_MEDUSA_BACKEND_URL and paste Backend URL in the value field.
  5. Deploy to apply settings

3. Check functionality

  1. Open your storefront at the given URL
    In this example is it https://next-medusa.vercel.app
  2. If you see images, you have done it right.
  3. Optionally, you can try renaming items in the Medusa administration dashboard and check the storefront to see if any changes have been made.

Conclusion

Congratulations! You have successfully connected your Medusa.js backend with a storefront on Vercel. If you encounter any issues, refer to the Medusa.js and Vercel documentation for additional help. Feel free to share your experience or ask questions in our community on Discord.

Subscribe to nomodo.io

Don’t miss out on the latest issues. Sign up now to get access to the library of members-only issues.
jamie@example.com
Subscribe