QuizRulers – iOS Source Code

Overview

QuizRulers is a multiplayer & singleplayer realtime quiz game, compiled with Swift 3.0, where you can challenge friends, and includes a matchmaking service to challenge random players. Players can also climb the ranks by winning games against friends and family; these ranks can be predefined within the settings file within XCode. In addition, players can add friends onto their friends list and send challenge requests on the wide of topics; you can easily create your own topics, and topics can be updated in realtime, even if your app has already been published using Google Firebase. Players can also track their stats on the home screen and they can also view the fact of the day, which can be changed by you using Firebase.

Features

• Realtime multiplayer experience
• Singleplayer mode
• Easily add new quiz topics, which appear on the app instantaneously
• Add friends, and send them challenge requests, and compare your stats
• Multiplayer matchmaking service available to challenge random players
• Easily reskin app by modifying images within xcassets folder
• Compiled with Swift 3.0
• Fact of the day feature on homescreen

Requirements

• Google Firebase account – instructions provided
• XCode 8 IDE, and an OSX device (Mac)

Instructions

1. Ensure the enclosing folder is unzipped
2. First open terminal, this can be found within your application folders on your Mac.
3. When the terminal window is open run the command “cd (FILE LOCATION OF QuizRulers FOLDER)” and include the file location of the folder after the “cd” function, without brackets.
4. Once inside the directory, run “pod install”. This will install all of the required pods automatically. These are required for Google’s Firebase framework to be installed.
5. Open the Xcode project, with the file extension .xcworkspace (White Icon). Do not open the .xcodeproj as frameworks will not load into the workspace correctly.
6. In the left window tab, click QuizRulers (this has blue icon next to it). Then make sure the general tab is highlighted blue and proceed to enter your developer account details in the Signing section.
7. Goto https://console.firebase.googl… and create an account. This is free, and the Free Spark Plan will allow your app to handle 100 simultaneous realtime quiz games. The website will take you through a step-by-step to sync the application with your account.
8. Once your account is setup, ensure users can use standard email login on firebase, which can be changed on the Authentication tab
9. Also in the Database structure, ensure you have the following structure by adding nodes. On the iOS applications first run, these nodes may be created automatically, but if not you will need to implement them manually using the plus button.
10. A sample JSON file is available in the  directory if you wish to use the template’s pre-existing quiz topics, you can import this into firebase by clicking the three dots, and “Import JSON”.

1. If you decide to include images within your quiz, ensure the relevant image files are uploaded to Storage on Google Firebase and in the JSON files, ensure the location of the images are correctly stated.
2. If you wish to reskin the application, you can change the images within the Assets.xcassets folder on XCode.