Hello! Welcome to Team 32, a.k.a Team Gossip Guru, Chat Applet! This was made over a 12 week period in the Google CodeU Program Spring 2018. The team consisted of a Google Engineer and 4 undergraduate CS students. We were given a barebone chat applet and left to our imagination on how we wanted to customize the chat applet. Not only did Team Gossip Guru redesigned the UI, we also added Profile Pages, Notifications, and Private Conversations. Our goal, as hinted by our team name, was the ability for people to plan surprise events for their friends.
A live production site can be found here: http://gossip-guru-206201.appspot.com/. Steps to host a local server can also be found below.
Check whether you already have Java installed by opening a console and typing:
javac -version
If this prints out a version number, then you already have Java and can skip to
step 2. If the version number is less than javac_1.8
, then you have an old
version of Java and should probably upgrade by following these instructions.
Download the JDK (not the JRE) from here.
Retry the javac -version
command in a new console window to check the
installation. If you still don't see a version number, then update your PATH
environment variable so it contains Java's bin
directory. Follow these
directions to do so.
This project uses Maven to compile and run our code. Maven also manages dependencies, runs the dev server, and deploys to App Engine.
Download Maven from here. Unzip the folder wherever you want.
Make sure you have a JAVA_HOME
environment variable that points to your Java
installation, and then add Maven's bin
directory to your PATH
environment
variable. Instructions for both can be found
here.
Open a console window and execute mvn -v
to confirm that Maven is correctly
installed.
This project uses Git for source version control and GitHub to host our repository.
Download Git from here.
Make sure Git is on your PATH
by executing this command:
git --version
If you don't see a version number, then make sure Git is on your PATH
.
Clone this respository onto your local PC.
In order to test changes locally, you'll want to run the server locally, on your own computer.
To do this, open a console to your codeu_project_2018
directory and execute this command:
mvn clean appengine:devserver
This tells Maven to clean (delete old compiled files) and then run a local App Engine server.
You should now be able to use a local version of the chat app by opening your browser to http://localhost:8080.
- Bring down the existing server by pressing
ctrl+c
in the console running the App Engine devserver. - Modify a
.java
or.jsp
file. (Try updating the homepage by editing theindex.jsp
file.) - Bring the devserver back up by executing
mvn clean appengine:devserver
again. - Refresh your browser to see your changes!