Skip to content
This repository has been archived by the owner on Jan 27, 2023. It is now read-only.
/ leaf Public archive

๐Ÿ† 1st Place, Fall Hack 2020. A Multiplayer acronym game motivated by a simple problem; acronym recognition.

Notifications You must be signed in to change notification settings

awtkns/leaf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Legacy Edition

๐Ÿ† SFU Fall Hack 2020 Winner ๐Ÿ†
Team: Legacy Edition
Demo (UI Only, No gameplay)

PyPI - Python Version npm


Built using python, fastapi, socketio, and nuxt, Legacy Edition: Acronym Finder is a multiplayer acronym game motivated by a simple problem; acronym recognition. Gameplay involves being the first person amongst an unlimited playerbase to correctly guess what the underlying phrase of an acronym. Points are then awarded and stored on a global leaderboard.

Example: You are given SFU, and options would include Sloths For Us, Simon Fraser University, etc.

Legacy Edition: Acronym Finder, LEAF for short, is:

  • Ready for online multiplayer
  • Everyone of your friends can play
  • All sorts of acronyms!
  • Don't ever fail a hackathon again
  • Money will be yours!
  • Edition is Legacy

Tech Stack and Deployment

LEAF's backend is coded using fastapi and python 3.8. LEAF's frontend is coded using nuxt.js (a vuejs framework) and the vuetify material design framework. LEAF uses a self developed framework to scrape the web for acronyms and then generate different incorrect versions of the same acronym. We implemented an algorithm to generate incorrect acronyms within a certain degree of "closeness" to the real acronym

Running LEAF

To install LEAF, please follow the steps in order below. Note: Docker and docker-compose is required to run this application (Needed for mongodb).

Mongo DB

docker-compose up -d 

Backend

Installing and running backend. Note: python > 3.5 is required.

cd backend
pip install -r requirements.txt
python asgi.py

The backend should now be visible in a browser at localhost:5000. It may take minute for the database to initialize.

Frontend Installing and running frontend. Note: nodejs lts is required.

cd frontend
npm install
npm run dev

The frontend should now be visible in a browser at localhost:3000. The application should now be fully functional.

Credits