This project was developed for the Softweng MSE master at HES-SO. It's a small blog made with Vuepress automatically built with github actions on push.

You can check it out here!

The purpose of the project was to familiarize with frontend framework technologies like Vue/React or other. I chose to go on using Vuepress to build the blog. As such, we use:

• Vuejs
• Vuex
• Vuepress

As main technologies.

In order to play with this:

1. Clone this repository and cd in it
2. Run npm install to install all dependencies as well as npm i -g vuepress to load the vuepress builder
3. Run npm run dev to start the blog locally on your machine

If you want to run this small site in docker, do the following:

1. Run docker build --tag vpovesco:1.0 . to build an image from the given dockerfile
2. Run docker run -p 8080:8080 -d vpovesco:1.0 to run it on port 8080

It internally uses live-server which is not the best choice to expose a website, but it works for a proof-of-concept.

A small test suite was developed to check the behavior of the Vuex store, you can run it with npm test. It's built using Jest and babel-jest for transpilation.

Every visitor can have his own set of favorite article. When on an article simply click the heart button which will add it to vuex and automatically persist it to local storage using vuex-persist, a plugin for Vuex.

Vuepress is quite tough to get started with. Theming is complex and extending an existing theme is more complex than it seems. Loading external libraries like Vuex is also troublesome and doesn't follow the standard registration flow. But all in all it was a nice experiment.

Vuepress couldn't build the project because we're using window.localStorage in the store to persist it automatically. In order for everything to work, after a bit of digging, I ended up with the following solution:

if (typeof process === 'undefined') {
    // We're in browser!
}

This also allows us to run jest tests without problems.