Resource

Backboard

Single page app for dribdat challenges and projects ๐Ÿงบ

Demo
↓  Open

Backboard

This is a single page application (SPA) that visualizes data from hackathon.json, Data Package, or the Dribdat API.

Demo: https://backboard.vercel.app/

Issues: https://codeberg.org/dribdat/backboard/issues

Features

  • Projects, challenges, clocks are shown for a specific event.
  • Flexible configuration options for displaying and sorting the results.
  • Seamlessly navigate using your mouse or keyboard between individual projects.
  • You can also show presentations in full screen mode, use a mouse, keyboard or clicker to navigate through the slides.
  • A subtle countdown timer bar is shown at the bottom of the screen to alert your presenters of the time available.
  • Backboard is FAST, with a quick loading home page and instant navigation of the results of your event.

Currently most functions link back to Dribdat, for example, when you click on the Join team button you get directed to the main web application. The long-term goal is to create a more modern, decoupled frontend for Dribdat.

The Backboard has minimal formatting, tight margins, and is ideal for embedding into your webpage announcing the upcoming event or results. If you are developing a Vue.js app, you can import the Challenges, Honeycomb and Preview components directly into your project.

Because it works like a static website, you can bundle the Data Package along with this app or point to a permalink location where you have uploaded your datapackage.json for archiving the event.

Installation

Deploy this application with any service that supports Node.js

Deploy with Vercel

Set up app options at the bottom of the page, then click the Share button, and paste the query string (everything after ?&) into your VUE_APP_DEFAULT_OPTS variable.

Tip: You may want to enable Challenges and Previews (opens a modal dialog with swipable navigation) through clicking the options button found at the footer of the page (which opens a configuration menu). Use the handy Share link to get a URL with your config.

Usage

This app currently only works if you have data already available. To get started, do one of the following:

  • Use the VUE_APP_DRIBDAT_URL configured with a link to your dribdat event, or the URL to a Data Package.

Or:

  • Put a hackathon.json or datapackage.json file that you exported from dribdat's Admin, Reports page, or API into the public folder - e.g. .../api/event/current/datapackage.json

Optionally, you can also put a activity.json file with an export of the Dribs data from the API - e.g. .../api/event/current/activity.json?limit=500, or link to it with the DRIBS_URL. This is only needed when you are not linking to a Dribdat API, and if your Data Package does not include Dribs.

You can use the following environment variables:

  • VUE_APP_DRIBDAT_URL (required) - fully qualified link to your Dribdat event, or online hosted Data Package (* see examples)
  • VUE_APP_DRIBS_URL - as above, a link to the export of the Dribdat Activity API.
  • VUE_APP_DEFAULT_OPTS - the default display settings - copy the part after ? from the Share link.
  • VUE_APP_HIDE_TOOLBAR - makes the options toolbar in the footer unavailable.
  • VUE_APP_VOTE_FORM_URL - link to a form where you are collecting votes or feedback, otherwise the Dribs Post feature will be used.
  • VUE_APP_TIMER_LENGTH - in minutes, how long the countdown timer should run for in presentation mode (0 to disable, 3 is the default).
  • BACKBOARD_ROOT - if your deployment is not at the root, change it here (e.g. /backboard)

* Examples:

If you have any questions or bug reports, please leave them on our Codeberg issues.

Development

To run locally, install Node.js and Yarn, then to start a development server:

yarn install
yarn serve

Credits

Created using Vue.js and CodeSandbox.

See also this earlier version: https://github.com/dribdat/dribdat2_frontend

Why backboard?

Players typically aim for the box in the backboard when making a shot in basketball.

MIT License

All attendees, sponsors, partners, volunteers and staff at our hackathon are required to agree with the Hack Code of Conduct. Organisers will enforce this code throughout the event. We expect cooperation from all participants to ensure a safe environment for everybody.

Creative Commons LicenceThe contents of this website, unless otherwise stated, are licensed under a Creative Commons Attribution 4.0 International License.