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
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.)
- Fork the repo
-
Clone your fork of the repo
git clone https://github.com/vuestorefront/magento2.git && cd magento2
-
Checkout
develop
branchgit checkout develop
-
Run
yarn
to install dependenciesyarn install
-
Copy
.env.example
to.env
cp packages/theme/.env.example packages/theme/.env
-
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
-
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 inpackage.json
yarn dev:theme
-
If you need HMR on Api Client/Composables run
yarn dev:api-client
oryarn 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.
Honorable Mentions
Thanks go to these wonderful people 🙌:
Alef Barbeli💻 📖
Henrique Lopes💻 📖
Đại Lộc Lê Quang💻
Bogdan Podlesnii💻
Patrick Monteiro💻
Kevin Gorjan💻 📖
Marcin Kwiatkowski💻 📆 💼 📖 🤔 🚧 🧑🏫 👀
Dominik Deimel💻 📖
Lior Lindvor💻
Jonathan Ribas💻
Ali Ghanei💻
Maya Shavin📖
Alexander Devitsky💻
Diego Alba💻
Abdellatif EL MIZEB💻
Beniamin Sinca🐛 💻
Shankar Konar💻
Bratuniak Oleg🐛
Drew Michael🐛
This project follows the all-contributors specification. Contributions of any kind welcome!