Cupboard-Configurator

Cupboard Ltd Configurator by CLOSING< /TAG>

Cupboard Ltd Configurator for the course "Fallstudie" @DHBW Stuttgart
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built with
2. Project setup
3. Running the project
   • Compiles and hot-reloads for development
   • Compiles and minifies for production
   • Lints and fixes files
4. Fixes for common issues
   • Error: Plugin(s) are missing
   • Error: "PostCSS Plugin tailwindcss required PostCSS 8."
   • Error: "npm ERR! Error: EACCES: permission denied, access '/path'"
5. License

About The Project

Project for the lecture "Case Study" in the third semester at DHBW Stuttgart. This project was created by 5 students within three weeks. The project includes self-organized agile planning and execution. The website was created for a fictitious company called "Cupboard Limited", which sells sustainable and customizable furniture. An API was provided was provided by the lecturers to retrieve the products and place the orders. . The rest of the design, including all the text, was created freely by the students.

Built with:

• Vue
• VueX Persist
• i18n
• Axios
• Lottie Interactivity
• TailwindCSS
• Bootstrap 5
• NextJS
• NodeJS

Project setup

In order to set up the project properly, you must have npm installed. If this is not yet the case, you can find the instructions here:

• Mac: https://bodo-schoenfeld.de/node-js-und-npm-unter-macos-installieren/
• Windows: https://phoenixnap.com/kb/install-node-js-npm-on-windows (NOT TESTED!)

Running the project

The project consists of a frontend and a backend, which communicate with each other via the localhost. The backend consumes the API and formats the data. The frontend provides functionalities such as the shopping cart and uses the data from the backend for this. It is therefore essential that both components are started.

Compiles and hot-reloads for development

To be able to use the full application you have to start the frontend and the backend separately. Use the following two commands to do this:

npm run frontend:serve
npm run backend:serve

If you are not doing any development on the backend, you can also use the following command as an alternative:

npm run backend:start

Compiles and minifies for production

npm run build

Lints and fixes files

npm run lint

Fixes for common issues

The following list contains frequent issues and their fixes and will be updated during development.

Error: Plugin(s) are missing

Run the following command to install all plugins specified in the config:

npm install

Error: "PostCSS Plugin tailwindcss required PostCSS 8."

Run the following commands to fix the issue:

npm uninstall tailwindcss postcss autoprefixer
npm install tailwindcss@npm:@tailwindcss/postcss7-compat postcss@^7 autoprefixer@^9

Error: "npm ERR! Error: EACCES: permission denied, access '/path'"

This error usually occurs with MacOS. To solve this problem, use the "sudo" statement before each command. E.g.:

sudo npm install ...

License

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