LAB | Vue.js Setup

Introduction

In this lab, you'll start exploring how Vue.js works and how to create a project using this web development framework.

Your goals for this lab will be the following:

Installing the Vue.js CLI on your computer
Creating a new Vue project with a specific set of configurations
Creating a new Vue component inside your project and showing it on the home screen
Showing data from your JavaScript inside your HTML
(Bonus) Creating a "Hello World" function that fires when you press a button
(Bonus) Creating two different routes and navigating between them

We'll be following the official Vue.js guide for most of this lab.

Setup

Fork this repo
Clone this repo

Open the LAB and start:

$ cd lab-vue-setup
$ yarn install
$ yarn dev

Submission

Upon completion, run the following commands:

git add .
git commit -m "done"
git push origin main # or master if you are working from a master

Create a Pull Request so that your TAs can check your work.

Getting Started

The first step before creating your first Vue project will be to install the CLI. You only need to take this step once on your computer.

You can find the instructions in this link. Remember to add the -g command in order to install Vue on your computer instead of just inside a specific folder.

If you're working on Mac, remember you'll need to add the keyword "sudo" before the command in order for it to work.

Next, you will proceed to create a new project. Creating a new project on Vue is as simple as inserting a command on your console once you've installed the CLI globally. You can see the exact steps to follow in this link.

Once you're creating a new project, you'll be able to choose which features you want. In this case, we want you to choose a few features manually:

Babel
Router
Linter / Formatter

We also want you to create a Vue 2 project instead of a Vue 3 one. If you have any questions, the documentation is your best friend!

Instructions

Iteration 1 | Create a new Vue component inside your project and show it on the home screen

Have you created your first project yet? Great! Now you'll start navigating inside the project's structure.

In order to make your life easier, we recommend you to install the Vetur extension. It will help you create new components and add functionalities in an easier way.

Once you've created your new project and navigated inside the folder the CLI has created, you can now create your first Vue component!

Here's a helpful guide in case you're stuck: How to create a Vue component.

Pro tip: if you use the Vetur extension, you just need to write "vue" inside your .vue file and choose the appropriate template to get a basic structure.

Once you've created your new component, we want to show it inside the App.vue file. We've already seen in class how to do that, but here's a step-by-step guide that'll help you with this task.

Iteration 2 | Showing data from your JavaScript inside your HTML

Now that you have your new component, we're going to practice how to link the elements inside the <script> with our <template>.

For this, you'll need to understand Text Interpolation. If you need a refresher about it, here's the link to the official documentation.

Iteration 3 | Bonus | Create a "Hello World" function that fires when you click on a button

This challenge is a bit more advanced; but it will show you how easy it is to create and trigger functions (or methods, as they're called in Vue) when you're working with a JavaScript method.

Here's what you need to do:

Create a new method called helloWorld() that shows the phrase "hello world" on the console.
Create a new button inside your component and show it on the home page.
Call the method helloWorld() when you click on your newly created button.

If you need any help, here's the link to the official documentation.

Iteration 4 | Bonus | Creating two different routes and navigating between them

We'll dive much deeper into the Vue Router module in future lessons; but if you want a new challenge, here's your last task for this lab:

If you didn't include it during your initial setup, download and configure the Router module. Here's a link to the official guide.

Remember you'll only need to install it again if you didn't choose to include it in your project when you created it with the CLI.

Create a new component and register it as a route. Again, the documentation is your best friend here.
Create a navbar (it can be as simple as two links on the website's top section) that allows you to navigate between your components.

That's it!

Happy coding! ❤️

ironhack-web-1/w8d3-lab-vue-setup