From 73de28e1222e8638172879691d9e83bac8d065e4 Mon Sep 17 00:00:00 2001
From: Hippolyte Alain <alain.hippolyte@gmail.com>
Date: Tue, 12 Nov 2019 23:49:30 +0100
Subject: [PATCH] add vuetify generator doc

---
 client-generator/vuetify.md | 206 ++++++++++++++++++++++++++++++++++++
 1 file changed, 206 insertions(+)
 create mode 100644 client-generator/vuetify.md

diff --git a/client-generator/vuetify.md b/client-generator/vuetify.md
new file mode 100644
index 00000000000..dc18223a03c
--- /dev/null
+++ b/client-generator/vuetify.md
@@ -0,0 +1,206 @@
+# Vuetify Generator
+
+Create a Vuetify application using
+[Vue CLI 3](https://cli.vuejs.org/guide/):
+
+    $ vue create -d vuetify-app
+    $ cd vuetify-app
+    $ vue add vuetify
+
+Install the required dependencies:
+
+    $ yarn add router lodash moment vue-i18n vue-router vuelidate vuex vuex-map-fields
+
+    $ yarn global add @api-platform/client-generator
+
+In the app directory, generate the files for the resource you want:
+
+    $ npx @api-platform/client-generator -g vuetify https://demo.api-platform.com src/
+    # Replace the URL with the entrypoint of your Hydra-enabled API
+    # Omit the resource flag to generate files for all resource types exposed by the API
+
+The code is ready to be executed! Register the generated routes in `src/router/index.js`
+
+```javascript
+import Vue from 'vue';
+import VueRouter from 'vue-router';
+import bookRoutes from './book';
+import reviewRoutes from './review';
+
+Vue.use(VueRouter);
+
+export default new VueRouter({
+  mode: 'history',
+  routes: [bookRoutes, reviewRoutes]
+});
+
+```
+
+and store modules in the `src/store/index.js` file.
+
+```javascript
+import Vue from 'vue';
+import Vuex from 'vuex';
+import makeCrudModule from './modules/crud';
+import notifications from './modules/notifications';
+import bookService from '../services/book';
+import reviewService from '../services/review';
+
+Vue.use(Vuex);
+
+const store = new Vuex.Store({
+  modules: {
+    notifications
+  },
+  strict: process.env.NODE_ENV !== 'production'
+});
+
+store.registerModule(
+  'book',
+  makeCrudModule({
+    service: bookService
+  })
+);
+
+store.registerModule(
+  'review',
+  makeCrudModule({
+    service: reviewService
+  })
+);
+
+export default store;
+
+```
+
+Update the `src/plugins/vuetify.js` file with the following:
+```javascript
+import Vue from 'vue';
+import Vuetify from 'vuetify/lib';
+import i18n from '../i18n';
+
+Vue.use(Vuetify);
+
+const opts = {
+  icons: {
+    iconfont: 'mdi'
+  },
+  lang: {
+    t: (key, ...params) => i18n.t(key, params)
+  }
+};
+
+export default new Vuetify(opts);
+
+The generator comes with a i18n feature to allow quick translations of some labels in the generated code, to make it
+work, you need to create the `src/i18n.js` file with the following:
+```
+import Vue from 'vue';
+import VueI18n from 'vue-i18n';
+import messages from './locales/en';
+Vue.use(VueI18n);
+
+export default new VueI18n({
+  locale: process.env.VUE_APP_I18N_LOCALE || 'en',
+  fallbackLocale: process.env.VUE_APP_I18N_FALLBACK_LOCALE || 'en',
+  messages
+});
+```
+
+Update your App.vue with following:
+```
+<template>
+  <v-app id="inspire">
+    <snackbar></snackbar>
+    <v-navigation-drawer v-model="drawer" app>
+      <v-list dense>
+        <v-list-item>
+          <v-list-item-action>
+            <v-icon>mdi-home</v-icon>
+          </v-list-item-action>
+          <v-list-item-content>
+            <v-list-item-title>Home</v-list-item-title>
+          </v-list-item-content>
+        </v-list-item>
+        <v-list-item>
+          <v-list-item-action>
+            <v-icon>mdi-book</v-icon>
+          </v-list-item-action>
+          <v-list-item-content>
+            <v-list-item-title>
+              <router-link :to="{ name: 'BookList' }">Books</router-link>
+            </v-list-item-title>
+          </v-list-item-content>
+        </v-list-item>
+        <v-list-item>
+          <v-list-item-action>
+            <v-icon>mdi-comment-quote</v-icon>
+          </v-list-item-action>
+          <v-list-item-content>
+            <v-list-item-title>
+              <router-link :to="{ name: 'ReviewList' }">Reviews</router-link>
+            </v-list-item-title>
+          </v-list-item-content>
+        </v-list-item>
+      </v-list>
+    </v-navigation-drawer>
+    <v-app-bar app color="indigo" dark>
+      <v-app-bar-nav-icon @click.stop="drawer = !drawer"></v-app-bar-nav-icon>
+      <v-toolbar-title>Application</v-toolbar-title>
+    </v-app-bar>
+
+    <v-content>
+      <Breadcrumb layout-class="pl-3 py-3" />
+      <router-view></router-view>
+    </v-content>
+    <v-footer color="indigo" app>
+      <span class="white--text">&copy; 2019</span>
+    </v-footer>
+  </v-app>
+</template>
+
+<script>
+import Breadcrumb from './components/Breadcrumb';
+import Snackbar from './components/Snackbar';
+
+export default {
+  components: {
+    Breadcrumb,
+    Snackbar
+  },
+
+  data: () => ({
+    drawer: null
+  })
+};
+</script>
+```
+
+To finish, update your `main.js` with the following :
+
+```javascript
+import Vue from 'vue';
+import Vuelidate from 'vuelidate';
+import App from './App.vue';
+import vuetify from './plugins/vuetify';
+
+import store from './store';
+import router from './router';
+import i18n from './i18n';
+
+Vue.config.productionTip = false;
+
+Vue.use(Vuelidate);
+
+new Vue({
+  i18n,
+  router,
+  store,
+  vuetify,
+  render: h => h(App)
+}).$mount('#app');
+
+```
+
+Go to `https://localhost:8000/books/` to start using your app.
+That's all!