Part 1 - Setting Up Our VueJS Project
In this first tutorial, we will be covering exactly how you set up your development machine so that we can start working on our HackerNews clone.
We’ll get a basic VueJS application up and running and we’ll also cover how you can build this simple project so that you end up with files that are deployable to the likes of and S3 bucket, or a server that can serve your files.
Installing the Vue CLI
We’ll be using version
2.9.3 of the
vue-cli in order to create our initial project. You can install this by typing the following:
$ yarn global add vue-cli # or $ npm install -g vue-cli
Note: At the time of writing this
vue-cli3.0.0 is currently in beta, I will update this when it goes to production!
Once you have done this, verify you have a working
vue-cli by typing:
$ vue -V 2.9.3
Creating our Project
Once we have successfully installed version
2.9.3 or above of the
vue-cli, we can then go about creating our project by typing the following:
$ mkdir hackernews-clone $ cd hackernews-clone $ vue init webpack
This will ask you a series of questions regarding how you project should be set up.
Yto generate project in the current directory
- Leave the Project name as is.
- Leave the project description as is.
- Enter your name in the Author field.
- Choose Runtime + Compiler.
- Install vue-router =
- Use ESLint to lint your code =
Ywith the Standard lint settings.
- Set up unit test =
nfor now, we can add them later
- Choose no for e2e tests with Nightwatch
- Then select the package manager of your choice, I’ll be using Yarn
Once we’ve done this we can run it locally by calling:
$ yarn run dev
When you navigate to
http://localhost:8080 within your browser, you should see your newly created VueJS application running:
Building Your Project
Once you are happy with your project, you will need to build it using the
yarn run build command. This will generate a
dist/ directory which will contain all of the necessary files needed in order for your application to run. If you are planning on deploying this application to a server or an AWS S3 bucket then you can certainly do so by simply pushing these files.
Once you have run
yarn run build you should see your
dist/ directory look something like this:
dist/ - index.html - static/ - - css/ - - js/ - - style.css
index.html file needs in order to run as a Vue.js application. You will be able to push this up to
Excellent, we now have everything we need set up on our machine in order to build our HackerNews clone! In the next tutorial, we are going to start building up our VueJS project and create our first single-page component with its’ own styling. You can find that tutorial here: Part 2 Creating a Few Components