docs: add homepage

docs: upgrade to vuepress v1

change pkg description to HTML metadata

docs/.vuepress/config.js

@@ -1,4 +1,12 @@
 module.exports = {
+  plugins: {
+    '@vuepress/google-analytics': {
+      ga: 'UA-88662854-1',
+    },
+    '@vuepress/plugin-pwa': {
+      serviceWorker: true
+    }
+  },
   locales: {
     '/': {
       lang: 'en-US',
@@ -6,8 +14,6 @@ module.exports = {
       description: 'Metadata manager for Vue.js'
     },
   },
-  ga: 'UA-88662854-1',
-  serviceWorker: true,
   themeConfig: {
     repo: 'nuxt/vue-meta',
     docsDir: 'docs',
@@ -16,16 +22,11 @@ module.exports = {
         label: 'English',
         selectText: 'Languages',
         editLinkText: 'Edit this page on GitHub',
-        nav: [{
-          text: 'Guide',
-          link: '/guide/'
-        }, {
-          text: 'API',
-          link: '/api/'
-        }, {
-          text: 'Release Notes',
-          link: 'https://github.com/nuxt/vue-meta/releases'
-        }],
+        nav: [
+          { text: 'Guide', link: '/guide/' },
+          { text: 'API', link: '/api/' },
+          { text: 'Release Notes', link: 'https://github.com/nuxt/vue-meta/releases' }
+        ],
         sidebar: [
           '/',
           {

docs/README.md

@@ -1,14 +1,41 @@
-<img src="vue-meta.png" alt="vue-meta"/>
-
-::: tip We need your help
+---
+home: true
+heroImage: /vue-meta.png
+heroText: vue-meta
+tagline: HTML Metadata manager for Vue.js
+actionText: Get Started →
+actionLink: /guide/
+features:
+- title: What
+  details: vue-meta is a plugin for Vue.js which helps you to manage your app's metadata using Vue's built-in reactivity
+- title: How
+  details: Just export the special property `metaInfo` in any or all your components
+- title: So?
+  details: Nested components can overwrite each others values, allowing you to easily add or remove metadata where and when you need it
+footer:
+  MIT License | Created by Declan de Wet, currently developed with ❤ by Nuxt.js core-team & contributors
+---
+::: tip We need your help!
 We are working on defining the RFC for Vue Meta v3.0. It will be a ground-breaking release built from the ground up.
 
 We would like your help with this! Please visit the [Vue Meta v3.0 rfc](https://github.com/nuxt/rfcs/issues/19) and let us know your thoughts.
 :::
 
-# Introduction
-`vue-meta` is a [Vue.js](https://vuejs.org) plugin that allows you to manage your app's metadata, much like [`react-helmet`](https://github.com/nfl/react-helmet) does for React. However, instead of setting your data as props passed to a proprietary component, you simply export it as part of your component's data using the `metaInfo` property.
+```js
+// Component.vue
+{
+  metaInfo: {
+    meta: [
+      { charset: 'utf-8' },
+      { name: 'viewport', content: 'width=device-width, initial-scale=1' }
+    ]
+  }
+}
+```
+```html
+<!-- Rendered HTML tags in your page -->
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+```
 
-These properties, when set on a deeply nested component, will cleverly overwrite their parent components' `metaInfo`, thereby enabling custom info for each top-level view as well as coupling metadata directly to deeply nested sub components for more maintainable code.
-
-[Get started](/guide) or play with the [examples](https://github.com/nuxt/vue-meta/tree/master/examples)
+See the [examples](https://github.com/nuxt/vue-meta/tree/master/examples) for more inspiration!