Skip to content

Commit

Permalink
Added README
Browse files Browse the repository at this point in the history
  • Loading branch information
w-henderson committed Dec 10, 2020
1 parent 836744e commit 9e6896b
Show file tree
Hide file tree
Showing 5 changed files with 14 additions and 0 deletions.
14 changes: 14 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
![Kascreech Banner](assets/banner.png)

# Kascreech
Kascreech is a real-time multiplayer quiz platform to make learning fun, and is definitely not a blatent rip-off of Kahoot. Built in Rust and JavaScript, Kascreech is a joint project between myself and [flauntingspade4](https://github.com/flauntingspade4) which allows anyone to create a quiz and play it with their friends.

## How to Deploy
The `web` folder contains all of the front-end code to place on a web server. Make sure you change the constant `SERVER_IP` in both `chungus.js` and `client.js` to wherever you're hosting the back-end server. The Rust code for the back-end is in the `server` folder, where you just need to run `cargo run` to start the server. If you don't have Rust installed, you can download a binary from [the Releases page](https://github.com/w-henderson/Kascreech/releases) and run that instead, which will host the server on port 80.

## How to Play
The host player, whose screen will display the questions, should navigate to the `/chungus.html` route of the server, and run `chungusGameInfo()` in the console (this will be changed in the future). All players should navigate to `/client.html` and enter the game code and choose a username. Then, the game will play out just like a Kahoot game.

| Host UI | Client welcome UI | Client in-game UI |
| --- | --- | --- |
| ![Host screen](assets/screenshot_chungus.png) | ![Client home screen](assets/screenshot_client.png) | ![Client in-game screen](assets/screenshot_client_ingame.png) |
Binary file added assets/banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/screenshot_chungus.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/screenshot_client.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/screenshot_client_ingame.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 9e6896b

Please sign in to comment.