Vue Storefront

Vue Storefront is an frontend framework that can work with any backend API. To learn how to build your integration, see Kibo's integration guide on the Vue Storefront website.

Try It Out

If you want to demo the integration, you can run the following commands:

yarn global add @vue-storefront/cli
vsf init <project_name> && cd <project_name> && yarn && yarn dev

Contribute

This project follows the all-contributors specification and contributions of any kind are welcome.

Prerequisites

In order to use Vue Storefront, you must have the following:

  • NodeJS v14 or later
  • KiboCommerce Account

Get Started

To begin development on your own version of the repo:

  1. Fork the repo.
  2. Clone your fork of the repo:git clone https://github.com/vuestorefront/kibocommerce.git cd kibocommerce.
  3. Checkout develop branch git checkout develop.
  4. Run yarn to install dependencies.
  5. Define a store running environment by adding a STORE_ENV to your running project or execute the code $ echo "STORE_ENV=dev" >> .env.
  6. Copy config/example.json to an environment named config and update the GraphQL Endpoint:$ cp packages/theme/config/example.json packages/theme/config/dev.json.
  7. Update the  Client ID and Shared Secret with your respective Application Client ID and Shared secret found in your Developer Console.
  8. Update apiHost to point at your Kibo site.
  9. Build dependencies yarn build:api-client && yarn build:composables.
  10. Run yarn dev:theme to run theme. You can find other commands in package.json.

If you need HMR on your API client or composables, run yarn dev:api-client or yarn dev:composables in a separate terminal window.

Resources

For more information, see the following resources: