A pretty fat boilerplate to start-off webapp projects based on Kuzzle, VueJS and Vuetify.
This boilerplate is composed of a backend, located in ./apps/backend
and a frontend, located in ./apps/frontend
.
It also contains a./initializationFiles
wich contains three files that will be used to initialize your backend.
Each layer of the stack contains its corresponding README.md
file. Please refer to it.
This boilerplate provides you with
- An instance of Kuzzle as a framework, ready to be extended
- A VueJS web application based on the Kuzzle SDK javascript v7, including:
- an implementation of the authentication method integrated with Vuex,
- an implementation of the "Offline mode", also integrated with Vuex,
- a complete i18n setup based on vue-i18n,
- a complete Vuetify installation (with fortawesome 5),
- an instance of the vue-izitoast plugin
Clone this repository using the following command
git clone https://github.com/berthieresteban/boilerplate-kuzzle-vuejs-vuetify.git
Then, delete the Git tree and reinitialize the repo from scratch
cd boilerplate-kuzzle-vuejs-vuetify
rm -rf .git
At this point you may rename the folder of your project to a meaningful name. Then, you can set remote(s) the usual way
git init
git remote add origin <another-git-server-URL-here>
You can then install the backend and frontend applications:
cd apps/backend
npm install
npm run install:docker
cd apps/frontend
npm install
Start your local Kuzzle instance by typing
cd apps/backend
npm run dev:docker
Adapt the ./initializationFiles/*
files to your need
Then you will need the kuzzle cli, kourou to initialize your backend
kourou admin:loadMappings < ./initializationFiles/mappings.json
kourou admin:loadFixtures < ./initializationFiles/fixtures.json
kourou admin:loadSecurities < ./initializationFiles/securities.json
Serve your web app locally by typing
cd apps/frontend
npm run serve
Take a look at the README.md
files in the backend
and frontend
directories to do the next steps.