---
# System prepended metadata

title: Foursquare Project Onboarding

---

# Foursquare Project Onboarding

---

🚨 **MOVED!** 🚨
This guide has been moved to Confluence. Head over to the new page at https://foursquare.atlassian.net/wiki/spaces/ENG/pages/170819585/Foursquare.web%2BProject%2BOnboarding

---

## Prerequisites

At this point, we assume you have:
- Forked and cloned the [foursquare.web](http://github.com/foursquare/foursquare.web/) project
- Git remotes are configured with `origin` set to `git@github.com:foursquare/foursquare.web.git` and some other remote set to your fork.
- **Successfully ran `./fs green` in the project directory**

## Where to get help
There are a number of Slack channels that are great places to ask beginner questions and get help from your friendly co-workers:
- [#build](https://foursquare.slack.com/messages/C024KS3G7/) for when your project won't build on Jenkins or locally, and you don't think your code is to blame. _Hint:_ first try running `./upkeep --all`.
- [#code](https://foursquare.slack.com/messages/C024L62EB/) if your code _is_ to blame - best place for help with Scala, Python, best practices, etc.
- [#helpdesk](https://foursquare.slack.com/messages/C02685165/) for problems with account permissions or your laptop setup (they might ask you to file a ticket by emailing helpdesk@foursquare.com).
- [#intellij](https://foursquare.slack.com/messages/C025F44RR/) for problems with your IntelliJ IDE.
- [#bigbigdata](https://foursquare.slack.com/messages/C024KTGMQ/) for help with data things: Luigi, Hadoop, Scalding, Spark, Databricks.

If you aren't sure where to ask for help, someone in any of these channels will likely point you in the right direction. In general, try not to direct message individuals -- the public conversation could help someone else stuck on a similar issue.

## Meta - Updating the Guide

This guide should be a living document owned by all engineers. For small clarifications or fixes, please feel free to edit these pages yourself! For more in depth meta discussion of this guide, head to [#p_onbaording](https://app.slack.com/client/T024JL2SB/CHBU8KPGT) to discuss.

## Table of contents

1. [Set up IntelliJ](https://hackmd.io/@iant/ByYtk6kzH)
2. [Create a new module and test it](https://hackmd.io/@iant/Sk3gxpyGB)
3. [Debugging techniques](https://hackmd.io/@iant/SJJ4xpJGS)
4. [Add an external dependency](https://hackmd.io/@iant/HkZFlpJGr)

----

[Set up IntelliJ](https://hackmd.io/@iant/ByYtk6kzH) →
