Skip to content

keyobs/pocket-pbt

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.

About

Penalty box timers for roller derby people

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors