GameOn is a Full-Stack Web App that allows users to connect, play and rank in sport of their liking through a platform that enables them to find games to play wherever and whenever they want.
Built with React.js, Node.js with Express, and PostgreSQL.
Users are able to:
- Create a new event or game with name, description, date, time and number of players.
- See near by events in the map view.
- Join an event or game to participate in it.
- At the end of each game the winning team members are awarded points.
- Only the creator of the event/game can start the game.
- The leaderboard displays the top 10 players with the most points in the app.
- Player roles, like captain, defender etc.
- Display a who won poll among all the players to decide winner.
- Have the leaderboard be by sport and by city.
- Using geo-location data and calculations module to get all events happening near the user within a give radius.
- On an event page displaying an and handling the join or start game button for players that join or the owner of the event.
- Integrating user authentication with Password.js, securely storing passwords and allowing for cookie-based authorization.
- Node.js & Express.js. For the HTTP backend server.
- Passport.js. For handling user authentication and authorization.
- React.js. For the front-end/client interface of our app.
- PostgreSQL. As our relation database management system.
- pg-promise. For interfacing with our database in our backend code.
- bcrypt. For hashing and salting passwords before storage.
- CSS3.
- Google Maps. For the map view displaying nearby games.
You must have installed Node.js as well as PostgreSQL in your computer.
You can check for these dependencies with node -v
and psql -v
. If your shell/terminal doesn't complain and you see version numbers you are good to go.
-
Clone this repo and change directory to it:
git clone git@github.com:alejo4373/GameOn.git && cd GameOn
-
Install dependencies for the Node/Express Server (
backend
folder):cd backend && npm install
-
Install dependencies the React App (
frontend
folder):cd frontend && npm install
-
Create database and seed sample data while being in the
GameOn
directory with:psql -f ./backend/db/GameOnDB.sql
-
To launch the Node/Express server, inside the
backend
folder run:npm start
-
To launch the React App, inside the
frontend
folder, and preferably in another terminal window run:npm start
-
A new browser tab should have been opened and the App should be running. If that is not the case check the terminals output for errors, if you are unable to troubleshoot the problem, I would be happy to address issues so open one