-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
* rename create to createNewRoom for clarity * rename create to createNewRoom for clarity * improve UI to support mobile * modify little things * modify README.md
- Loading branch information
1 parent
0a7a291
commit 348928b
Showing
11 changed files
with
219 additions
and
116 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,10 +1,79 @@ | ||
# Club Voting System | ||
# ClubVotingSystem | ||
|
||
The Club Voting system was developed in the runup to the 2022 AGM for the Programmers' Society. Since then it has been continually updated and improved. | ||
## About | ||
ClubVotingSystem lets you do real-time voting in a safe and controlled environment. It was initially developed in 2022 for the Annual General Meeting (AGM) for UTS Programmers' Society. | ||
|
||
## Features | ||
- [x] Responsive UI | ||
- [x] Realtime vote counting and display | ||
- [x] User facing dashboard | ||
- [x] Admin dashboard | ||
- [x] Anonymous voting | ||
|
||
## Use Cases | ||
1. Committee election in Annual & Special General Meetings (AGMs & SGMs) | ||
2. Voting where memberships are required | ||
|
||
## Limitation | ||
You can only vote & ask one question at a time. | ||
|
||
## Get Started | ||
### Prerequisites | ||
Install [Docker](https://www.docker.com/) | ||
|
||
### Steps | ||
1. Clone the repo | ||
``` | ||
git clone https://github.com/ProgSoc/ClubVotingSystem.git | ||
cd ClubVotingSystem | ||
``` | ||
|
||
2. Install dependencies | ||
``` | ||
yarn install | ||
``` | ||
|
||
3. Run database on Docker | ||
``` | ||
docker-compose up -d | ||
``` | ||
|
||
4. Run client & server on localhost | ||
``` | ||
yarn web dev | ||
yarn server dev | ||
``` | ||
|
||
## How to Contribute | ||
1. Pick your favourite issue (or make one) | ||
2. Make a comment saying you'll work on it | ||
3. Wait for the issue to be assigned to you | ||
4. Fork the repo | ||
5. Commit your changes with the issue number (e.g., issue #2) | ||
6. Make a pull request | ||
7. Wait for approval | ||
1. If approved: You're done! | ||
2. Else: See comments | ||
|
||
## Project Structure | ||
``` | ||
project-root/ | ||
│ | ||
├── .gitignore | ||
├── .dockerignore | ||
├── Dockerfile | ||
├── docker-compose.yml | ||
├── package.json | ||
├── ... | ||
└── src/ | ||
├── server/ | ||
| ├── src/ | ||
│ ├── package.json | ||
│ └── ... | ||
└── web/ | ||
├── src/ | ||
├── index.html | ||
├── package.json | ||
├── tailwind.config.cjs | ||
└── ... | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.