Lockdown has seen a spike in online quizzes and people have been deprived of the party experience. So with that in mind, we wanted to give people a platform to play multiplayer quizzes remotely, mordernise the typical pub quiz by having a neon party theme to bring the party feel to the user!
Let's Get Quizzical is an online quiz game built in fullstack with react and redux on the client, Node.js and Express on the server and a mongoDB database. The game uses Socket.io to allow multiple users to play together, questions and answers are fetched from OpenTrivia API, and it is deployed on Netlify and Heroku.
For each game, up to 4 players can play and the host of each game selects the type of quiz they want everyone to play (i.e the number of questions, category, and difficulty). Users are then able to join the game using a unique room name set by the host. Once users have joined the lobby, they can take it in turns to play and the winner is announced at the end of every game and all new and existing scores are then shown on the leaderboard.
Clone or download the repo and navigate to the root directory of this repo.
To run the client, open the terminal:
cd react-client
npm install
npm run dev
It should automatically load on 0.0.0.0:8080
To run client test suite:
npm run tests
To start the server and use docker compose for the api and database containers, open the terminal and run:
bash _scripts/startDev.sh
- starts api & db services
- runs db migrations
- seeds db for development
- serves api on localhost:3000
To run the server test suite:
bash _scripts/startTest.sh
- starts api & db services
- runs db migrations
- attaches to api container and triggers full test run
- no ports mapped to local host
MongoDB shell
bash _scripts/mongo.sh
To teardown docker compose completely:
bash _scripts/teardown.sh
- HTML, CSS, JavaScript
-
Server: cors, nodemon, socket.io, express, mongodb
-
Client: axios, file-loader, react, router-dom, react-redux, react-router-dom, redux, redux-devtools-extensions, redux-thunk, socket.io-client
-
Server: jest, nodemon, supertest
-
Client: babel, react-testing-library, jest
- Start by planning out a plan!!! Use of GitHub Projects to set up a Kanban board.
- Create Figma design plan.
- Deploy to Netlify and Heroku!
- Set up files and folder structure for docker, react-client with redux, api, db for mongodb and test suites.
- Connect API and Socket server to React-Client
- Connect mongoDB database to API
- issues with routing with mongodb
- cors error when implementing socket.io
- fetch returns undefined data
- answers are encoded
- after submitting answer for final question in quiz, page will crash
- sends wrong quiz score to post
- socket and client integration
- scores not showing as percentage
- leaderboard not sorted by descending order
- winner not displayed
- score styling
- network spam for POST request
- winner crown assignment
- Set up pages and components
- Test suite!
- Use axios to set up GET request from OpenTrivia API, and POST score data to quizzical-quiz API
- Implement socket.io client
- Set up server with routes, models and controllers
- Install socket.io and integrate into client
- Complete GET, POST, PATCH routes
- Test!
- Create DELETE route to clear database
- Initially decided on SQL but changed to noSQL due to simplicity of data needed.
- Update config files and install dependencies required for mongodb.
- Set up connectin string with mongodb and mock connection for testing
- Set up mongodb atlas and connect to Heroku and code
- Deploying to Heroku and Netlify from one repo! And deploy early!
- Amazing progress after Day 1 - socket connection establisted, routes working on API, react-redux set up!
- Set up connection between api, db and client
- Responsive!
- Decoded answers from API
- Successful mob programming sessions
- Understanding and implementing socket.io
- Testing with mongodb
- Testing with react
- Deploying mongodb
- Passing data around - may need to refactor code
- Setting up multiplayer
- React redux testing
- Login / user accounts with authentication
- High scores leaderboard for each difficulty
- Score to include time taken to complete quiz
- Sound effects
- Full socket.io real time implementation
https://www.canva.com/design/DAEcypURzgQ/hUwNi51yfXyb7-FrHAeP4Q/edit#1
@pearlhamilton, @gretaivan, @natbibi, @Sem-the-dev, @roselynle