Skip to content

An app for creating, sharing, and analyzing rankings of Eurovision contestants from 1956-2024.

License

Notifications You must be signed in to change notification settings

jekrch/eurovision-ranker

Repository files navigation

Eurovision Ranker 💛

Version Run Tests License: MIT

https://www.eurovision-ranker.com/

Eurovision Ranker is a web application for creating, sharing, and analyzing rankings of Eurovision Song Contest participants.

A user's ranking is stored in the URL so it can be easily saved for later reference or shared with friends. React Joyride is used to provide a tour that demos other features: e.g. generating YouTube playlists and exploring official voting results from previous years.

Users can also view a geographical heat map of their ranking, which is implemented using React Simple Maps.

Multiple rankings can be created by category with different weights given to each category to reflect the user's preferences. A weighted total ranking can then be calculated, which reflects the competing values contributing to the user's final judgment.

image image

image

Features

  • Rank Eurovision contestants from 1956 to present
  • Share rankings via URL
  • Generate YouTube playlists
  • Explore official voting results from previous years
  • View geographical heat map of rankings
  • Create multi-category rankings with weighted totals

Stack

  • TypeScript
  • React
  • Redux Toolkit
  • Tailwind CSS
  • Vite
  • Umami

Getting Started

Prerequisites

  • Node.js (version 14 or later)
  • npm

Installation

  1. Clone the repository:

    git clone https://github.com/jekrch/eurovision-ranker.git
    cd eurovision-ranker
    
  2. Install dependencies:

    npm install
    

Running the Application

npm run start

The application will be available at http://localhost:3000

Running Tests

npm run test

Continuous Integration

This project uses GitHub Actions for continuous integration. The "Run Tests" workflow (test_on_push.yml) automatically runs the test suite on every push to the main and dev branches.

Data Source

Eurovision Ranker utilizes data from the Eurovision-Dataset, which covers contest years from 1956 onwards. Much of this data was originally sourced from Eurovisionworld.

License

This project is licensed under the MIT License.

Acknowledgments

About

An app for creating, sharing, and analyzing rankings of Eurovision contestants from 1956-2024.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published