README.md

Alokai Integration With plentysystems

Welcome to the plentysystems integration for Alokai.

Development setup

This section describes how to run the project locally with the preconfigured demo system.

Prerequisites

• Node.js 20+
• Yarn 3
• Personal Access Token with the scope read:packages

Download Node.js from the official website or use nvm to switch to a compatible version. For installation instructions for Yarn, refer to the Yarn documentation.

Repository fork

We recommend working with a fork of this repository. A fork allows you to easily incorporate updates from this boilerplate into your own codebase.

1. Create a fork.
2. Clone the forked repository.

Authentication

This project queries data from plentysystems by using other NPM packages as middleware. These packages are published on the GitHub registry. To download packages from GitHub's registry, you have to authenticate. To enable authentication, carry out the following steps:

1. In the root directory, create a new file called .yarnrc.yml.
2. Copy the contents of .yarnrc.yml.example to .yarnrc.yml.
3. In .yarnrc.yml, replace <TOKEN> with the Personal Access Token you created earlier.

Git doesn't track .yarnrc.yml, so you don't have to worry about exposing your token.

Setup environment

1. Add your API endpoint
2. Add your API security token

Starting the app

1. Open the repository in your command line interface.
2. Run yarn to install all dependencies.
3. Run yarn dev to start the development server. The app will be served with hot reload at localhost:3000.

Resources

Documentation

• Developers Documentation
• Technical Overview

Changelog

English | German

Features

• Turborepo remote cache build system, with blazingly fast execution of commands (build, lint, test etc.) on your local machine.
• TypeScript support.
• Nuxt.js 3 & Server Side Rendering for great UX, loading and SEO scores.
• Beautiful components built with TailwindCSS and Storefront UI - a lightweight, accessible, and customizable component library built for e-commerce.
• Unit tests with Vitest and Vue Test Utils.
• ESLint for code linting.
• Prettier code formatter.
• Husky for working with Git hooks efficiently.
• Conventional Commits standard for commit messages.
• Staged code linting with lint-staged.
• Progressive Web App features with Vite PWA for Nuxt.
• i18n localisation powered by Nuxt-i18n.
• Alokai SDK ready - integrate headless E-commerce platform with your project easily.
• Alokai Middleware.
• Maximized lighthouse score.

Alokai

• Introduction to learn what is Alokai.
• Alokai Documentation
• Storefront UI Documentation
• Community Chat

License

Distributed under the MIT License. See LICENSE for more information.

Contributing

Please see our CONTRIBUTING.md for more information.

Support

If you have any questions about this integration we will be happy to answer them on the plentymarkets channel of the Alokai Discord.