---
# System prepended metadata

title: First Time Setup
tags: [Documents]

---

---
tags: Documents
---
# First Time Setup

[TOC]

## Introduction
Welcome to CS18! This guide will go over how to setup everything that you need for assignments and lecture.

## Communication During Lecture

Lecture will take place in Zoom (link and passcode in Canvas). During lecture, we will run polls and have Q&A through a tool called Prismia (developed at Brown). Here is the link to [join the course Prismia board](https://prismia.chat/projects/e4d25559-76da-4471-a576-88ca430da10a/join).

## Downloading and Running Assignments

### Downloading the Assignment
We use Github to distribute assignments and share lecture code. 
- Create an account on [Github](https://github.com), or login to your existing account
- Follow [this link](https://classroom.github.com/a/zZ6pwHB6) to download an example assignment (click on Accept this Assignment and then refresh the page to get the actual link to the assignment). We will use this distribution method for all homework and project assigments.
- Now the assignment is linked to your Github profile. Follow the **Downloading code** section of our [Github guide](https://hackmd.io/YoK8zBN9Rkum1_rxlyBzPQ) to download the assignment to your computer.
### Downloading IntelliJ
We recommend that you use IntelliJ for programming assignments. [Here is our guide on setting up and configuring IntelliJ.](https://hackmd.io/Cq7UQr7JQmardJnHt71Ryg) Read the **Introduction** and follow the steps in the **Installing** section before continuing with this guide.

**Note:** If you are familiar with other text editors or IDEs that you have written Java with in the past, you may use them, but we will not be able to help you with editor-specific bugs and configuration issues unless you are using IntelliJ 

### Using IntelliJ

Now that you have IntelliJ downloaded, and the assignment is somewhere on your computer, let's open it and configure IntelliJ! You can follow the rest of the IntelliJ guide to get set up, but here's a more step-by-step guide to make sure that the assignment is configured properly on IntelliJ:
- First, open IntelliJ and on the bar at the top, go to `File -> Open` and then find the `hello-world-[username]` folder on your computer. Select that folder, and open it.
![](https://i.imgur.com/vkEGASb.png)
*Make sure that you open the highlighted folder, and not `lib` or `sol`!*
- Open the folder on the sidebar, and double click on `TestSuite.java`. Then, click on either of the green arrows next to `public class TestSuite ...` or `public static void main ...`. You should see some output on the bottom panel. If you get `All tests passed.`, you're all set!
![](https://i.imgur.com/GxTe9Q2.png)
- You may not see the green arrows if the `import tester.Tester` line is red. To fix this, go to `File -> Project Structure -> Modules -> Dependencies` and then click on the little plus button on the bottom, and select `JARs or Directories`
![](https://i.imgur.com/kTiX1Du.png)
- Then, open the `tester.jar` file that is in this project's `lib` directory.
![](https://i.imgur.com/8yrYVJD.png)
- If you still don't see the green arrows, right click on the topmost folder and go to `Mark Directory As -> Sources Root`, and they should show up.
![](https://i.imgur.com/IeUD5r9.png)


You should now be all set! You can also try running the `Hello.java` file, and play around with Java if you want. 

These steps should be the same for all future homeworks (minus the inital installation and download steps), and they are explained a bit more in depth in  our previously referenced [IntelliJ guide](https://hackmd.io/Cq7UQr7JQmardJnHt71Ryg). Please come to office hours this week or post on Piazza if you have any other issues with setting up!
