LeaderBoard

KO | EN

gitlite — search

#hacktoberfest #react #typescript #llm #go #android #rust #macos #java #windows #cli #security #ios #openai

(★ 12)

The leaderboard website displays scores submitted by different players. It also allows you to submit your score. All data is preserved thanks to the external Leaderboard API service.

LeaderBoard Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![](https://img.shields.io/badge/LeaderBoard-pink)

# LeaderBoard

> The leaderboard website displays scores submitted by different players. It also allows you to submit your score.

## Mini Presentation

![screenshot](https://raw.githubusercontent.com/AnselemOdims/LeaderBoard/develop/src/images/screenshots/Screencast%20from%2012-15-2021%2003%2058%2047%20PM.gif)

## Dark Mode

![screenshot](https://raw.githubusercontent.com/AnselemOdims/LeaderBoard/develop/src/images/screenshots/leader-dark.png)

Additional description about the project and its features.

## Built With

- Major languages (HTML, CSS, JavaScript)
- Frameworks (None)
- Technologies used 
  
  ``` bash
  - Webpack(Code Bundlng et al)
  - Git(version control)
  - ESLint(JavaScript linting)
  - WebHint(linting tool)
  - Stylelint(style linting)
  ```

## Live Demo

[Live Demo Link](https://anselemodims.github.io/LeaderBoard/)

## Getting Started

To get a local copy up and running follow these simple example steps.

### Prerequisites
 - A text editor(preferably Visual Studio Code)
### Install
  -  [Git](https://git-scm.com/downloads)
  -  [Node](https://nodejs.org/en/download/)
### Usage
#### Clone this repository

```bash
$ git clone git@github.com:AnselemOdims/LeaderBoard.git
$ cd LeaderBoard
```
#### Run project

```bash
$ npm install
$ npm run start # this will make webpack watching for your changes in code
```

#### Open page in browser
```bash
$ open dist/index.html
```

## Interaction with the Leaderboard API
- Each new game is created with the POST method using 
  ```bash
      { 
          "name": "My cool new game" 
      }
    ```
 This request returns a result that holds the unique ID for that game:

```bash
    {
      "result": "Game with ID: Zl4d7IVkemOTTVg2fUdz added."
    }
  ```
>  This gameID is saved in the localStorage automatically

The two allowed actions are posting and getting of the scores
- The POST request creates a new Leaderboard score for the given game sending user and score as parameters like this:
  #### Endpoint
  ```bash
  https://us-central1-js-capstone-backend.cloudfunctions.net/api/games/:id/scores/
  ```
  
  body parameters
  ```bash
  { 
	  "user": "John Doe",
	  "score": 42
  }
  ```
  and it returns

```bash
  {
	  "result": "Leaderboard score created correctly."
  }
  ```
- The GET request returns data in JSON format like this:
    #### Endpoint
  ```bash
  https://us-central1-js-capstone-backend.cloudfunctions.net/api/games/:id/scores/
  ```
  It returns
  ```bash
  {
    "result": [
        {
            "user": "John Doe",
            "score": 42
        },
        {
            "user": "Peter Parker",
            "score": 35
        },
        {
            "user": "Wonder Woman",
            "score": 50
        }
    ]
  }
  ```

<br>
## Authors

👤 **Anselem Odimegwu**

- GitHub: [github](https://github.com/AnselemOdims)
- LinkedIn: [LinkedIn](https://www.linkedin.com/in/anselem-odimegwu-65a679104/)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/AnselemOdims/LeaderBoard/issues).

## Show your support

Give a ⭐️ if you like this project!

## 📝 License

This project is [MIT](https://opensource.org/licenses/MIT) licensed.

LeaderBoard

LeaderBoard Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

LeaderBoard

LeaderBoard Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README