Skip to main content
  1. All Posts/

magento2

eCommerce TypeScript

  

Stay connected




Vue Storefront 2 integration with Magento

This project is a Magento 2 integration for Vue Storefront 2.

How to start if you want to try out the integration

Please follow the installation guide

How to start if you want to contribute?

Want to contribute? Ping us on magento2 channel on our Discord!

Requirements:

  • NodeJS v16 or later
  • Yarn (npm is not supprted yet)
  • Magento >= v2.4.3 instance for GraphQL endpoint
  • Change Magento GraphQL Query Complexity and Depth values

Don’t forget to change the Magento GraphQL Query Complexity and Depth values
Magento 2 by default has a lower value for the complexity of 300, and a higher value for the depth of 20. Magento 2 – Issue #32427

The changes are required, due to the size of the queries and mutations in the api-client implementation.

To do this changes, you can use the Magento 2 module, which adds a configuration panel to your admin, or do this changes manually.

To install the Magento 2 GraphQL Config module, on your Magento installation execute:

composer require caravelx/module-graphql-config

php bin/magento module:enable Caravel_GraphQlConfig

php bin/magento setup:upgrade

php bin/magento setup:di:compile

php bin/magento setup:static-content:deploy

Find more information about the module GraphQl Custom Config

Steps

(Note: Currently only yarn is supported because of workspaces resolving. Do not use npm to install or build the project.)

  1. Fork the repo
  2. Clone your fork of the repo
    git clone https://github.com/vuestorefront/magento2.git && cd magento2
  3. Checkout develop branch
    git checkout develop
  4. Run yarn to install dependencies
    yarn install
  5. Copy .env.example to .env
    cp packages/theme/.env.example packages/theme/.env
  6. Update MAGENTO_GRAPHQL_URL with url to Magento >=2.4.2 GraphQL endpoint, and the other variable accordingly to your store configurations.
    MAGENTO_GRAPHQL_URL=https://{YOUR_SITE_FRONT_URL}/graphql
    
  7. Build dependencies yarn build:api-client && yarn build:composables
    yarn build:api-client && yarn build:composables
  8. Run yarn dev:theme to run theme. You can find other commands in package.json
    yarn dev:theme
  • If you need HMR on Api Client/Composables run yarn dev:api-client or yarn dev:composables on a separate terminal window.

Resources

Support

If you have any questions about this integration we will be happy to answer them on magento2-vsf2 channel on our Discord.

Contributors ✨

Honorable Mentions

Thanks go to these wonderful people 🙌:

Heitor Ramon Ribeiro💻 🚧 📖 📆

Alef Barbeli💻 📖

Henrique Lopes💻 📖

Đại Lộc Lê Quang💻

Bogdan Podlesnii💻

Patrick Monteiro💻

Kevin Gorjan💻 📖

Bartosz Herba💻 📖 🚧 🧑‍🏫 👀

Marcin Kwiatkowski💻 📆 💼 📖 🤔 🚧 🧑‍🏫 👀

Filip Rakowski💬 🧑‍🏫 👀

Filip Sobol💬 🧑‍🏫 👀 📖

Patryk Andrzejewski💬 🧑‍🏫 👀

Renan Oliveira🔧 🔌

Dominik Deimel💻 📖

Lior Lindvor💻

Artur Tagisow💻 💬 🤔 🚇 🚧 👀 ⚠️ 🔧

Jonathan Ribas💻

Ali Ghanei💻

Maya Shavin📖

Alexander Devitsky💻

Diego Alba💻

Abdellatif EL MIZEB💻

Beniamin Sinca🐛 💻

maaarghk💻

Shankar Konar💻

Bratuniak Oleg🐛

Drew Michael🐛

This project follows the all-contributors specification. Contributions of any kind welcome!