aapokiiso/vuestorefront-magento2

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

yarn global add @vue-storefront/cli

vsf init <project_name> && cd <project_name> && yarn && yarn dev

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.)

Fork the repo

Clone your fork of the repo

git clone https://github.com/vuestorefront/magento2.git && cd magento2

Checkout develop branch
```
git checkout develop
```
Run yarn to install dependencies
```
yarn install
```
Define a store running environment by adding a STORE_ENV to your running project or execute the code
```
echo "STORE_ENV=dev" >> .env
```
Copy config/example.json to an environment named config and update GraphQL Endpoint
```
cp packages/theme/config/example.json packages/theme/config/dev.json
```
Update magentoGraphQl with url to Magento >=2.4.2 GraphQL endpoint, and the other variable accordingly to your store configurations.
```
"magentoGraphQl": "https://{YOUR_SITE_FRONT_URL}/graphql",
```
Build dependencies yarn build:api-client && yarn build:composables
```
yarn build:api-client && yarn build:composables
```
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} 💻 📖	_{Đại Lộc Lê Quang} 💻	_{Bogdan Podlesnii} 💻
_{Patrick Monteiro} 💻	_{Kevin Gorjan} 💻	_{Bartosz Herba} 💻	_{Marcin Kwiatkowski} 💻 📆	_{Filip Rakowski} 💬 🧑‍🏫 👀
_{Filip Sobol} 💬 🧑‍🏫 👀	_{Patryk Andrzejewski} 💬 🧑‍🏫 👀	_{Renan Oliveira} 🔧 🔌	_{Dominik Deimel} 💻 📖	_{Lior Lindvor} 💻
_{Maya Shavin} 💻📖