Skip to content

Repository files navigation

Pocket Penalty Box Manager

visit : https://keyobs.github.io/pocket-pbt/

Backup timers for roller derby penalty box when you forget to buy batteries.

The Pocket Penalty Box Manager is a web app designed to serve as a reliable backup for the official penalty box timers in roller derby.


Penalty Box Timer screen


✨ Features

The app is mobile-friendly.

Available :

  • 6 countdown timers for each six penalty box seats
  • Colored stroke helper
  • Customize your own color set

Flexible Timing Configurations:

  • Track time for 1 or 2 teams
  • Track only jammers
  • Track only blockers

Automated Jammer Management :

  • Automatically swaps a jammer’s active timer when a new jammer is sent to the box.

Penalty Box Timer screen



NEW TO ROLLER DERBY ?

The sport = WFTDA - The Game
The rules = WFTDA - The Rules of Flat Track Roller Derby



💻 Stack

Project is open-source.
Feel free to fork and/or contribute.

Built with React and Vite.
Enforce pnpm use.

Frontend

  • React 19
  • TypeScript
  • Less
  • Vite
  • pnpm

Code Quality

  • ESLint
  • Vitest
  • Husky
  • TypeScript ESLint

Monitoring

  • Sentry
    • optionnal - disabled if no DSN
    • uses secure tunnel on Netlify (prevents ad blockers, keep sentry dsn secret)

CI/CD & Tooling

  • GitHub Pages (deployment)
  • gh-pages (deployment helper)
  • only-allow (ensures pnpm usage)


💻 Developper Setup

To get started and contribute, follow these steps:

Prerequisites

Node.js: Ensure you have Node.js installed on your machine.

Installation

Clone the repository:

git clone https://github.com/your-username/pocket-pbt.git

Navigate to the project directory:

cd pocket-pbt

Install dependencies:

pnpm install

Running the Project : start the development server:

pnpm run dev

Launch the app at http://localhost:5173/ (or a similar port). Hotload active : the page will automatically reload as you make changes.


📜 License
This project is licensed under the MIT License. For more details, see the LICENSE file in this repository.


🤝 Contributing
We welcome contributions from the community !
If you're interested in helping, please check out our CONTRIBUTING.md file for guidelines on setting up your environment, submitting pull requests, and coding standards.

Releases

Packages

Contributors

Languages