Hacker News client app built with Nuxt.js (and Vue.js) which generates fast and lightweight AMP pages as a Progressive Web Application
The idea behind this project is to provide a developer friendly "recipe" to generate and serve a PWA with AMP using Javascript.
Simplicity is the key to brilliance
- Because of Vue.js simple, intuitive and reliable template engine.
- Because of Nuxt.js presets and conventions, which let you stay focused on the most important thing: enjoy coding your app
- Because is javascript
- Render all pages with required markup
- Loading stylesheet from an external file is not allowed
- Custom javascript is not allowed, only amp
custom-elementscripts can be used - When is supposed to be so, render the right amp
custom-elementin place of native HTML elements - amp
custom-elementsscripts must be imported only if they're used in page - Output head meta tags like
canonicalandamphtml"rel" links to make AMP pages discoverable
Is a Server Side Rendered Vue.js application in universal mode.
Since custom javascript is not allowed, client side webpack bundles imports must be removed from DOM. Of course, would be better to avoid client side build at all but I didn't find the way to exclude this step. See ampHtmlSanitizer.js module for the regular expression applied for this purpose.
In server side rendering everything works as usual with any other Nuxt.js app. Fetch method is used to fire an async vuex action to call the APIs and gather request data in order to render the page. If you are familiar with Vue.js and Nuxt.js you should easily understand the request and render flow in SSR
Client side interaction can be done using amp-bind and amp-mustache-templates. In this app you can see them in action by navigating to any /item/:id route and clicking on "toggle replies" link: on link tap fires setState action, which toggles the underneath block visibility and amp-list gets remote data using a remote endpoint. Comment replies are shown using mustache templates under components/amp-mustache-templates folder by referencing their id (filename including extension)
Canonical and amphtml page link meta tags are handled at layout level by using the appConfigInjector.js module. To put these meta tags in <head> tag Nuxt.js relies on vue-meta plugin, which works great.
# install dependencies
$ yarn install
# serve with hot reload at localhost:8000
$ yarn run dev
# build for production and launch server
$ yarn run build
$ yarn start
# generate static project
$ yarn run generateFor detailed explanation on how to deal with Nuxt.js, checkout Nuxt.js docs