Skip to content

frc868/StrategyBoard2025

 
 

Repository files navigation

FRC StrategyBoard 2025

image host

StrategyBoard2025 is a digital strategy whiteboard for FIRST Robotics competitions.

Getting Started

This app is intended for tablets in landscape mode. However, it should work on most platforms

Install as a PWA

For the best experience, especially on mobile devices, install the website as a Progressive Web App (PWA).

On mobile, PWA will remove the browser UI for a larger app window.

Features

Whiteboard

  • Draw
  • Erase
  • Undo
  • Robots
    • Draggable
    • Rotatable
    • Edit Robot dimensions (to scale)
  • Separate whiteboard for auton, teleop, endgame
  • Toggle betwen three perspectives

Offline

This app works offline. Before entering the competition venue, open the app once to cache the files.

To test if offline is working, disable internet and try to access the app.

Persistent Storage

All previous whiteboards are stored in IndexedDB. Use the Clear button to clear IndexedDB.

QR Code Transfer

Whiteboards can be transferred offline across devices through QR codes.

The device importing the whiteboard must have a camera.

Instructions:

Device that is exporting:
Tap the three white dots > Export

Device that is importing:
Import QR > Switch Camera (if needed) > Keep QR code within the yellow corners

When the import is finished, it will automatically close the window. Tap outside the window at any time to cancel the import/export.

By nature, importing may take a few seconds. For the fastest imports:

  • Don't draw excessively; every additional point is more data to send
  • Find decent diffuse lighting without any glare
  • Make sure the importing device has a good camera >15fps

image host

Issues

Please report any bugs on GitHub.

If the app isn't working, try to:

  • Manually clear IndexedDB
  • Delete and re-add as PWA
  • Manully unregister the service worker

Contributing

This was scrapped together in a few days, so the code is not maintainable. However, edits to the README are welcome. Please suggest them through pull requests :)

Future Use

Updating the project for future games is easy:

  1. Fork the project
  2. Replace src/field.png with the new field image
  3. Update src/config.ts
  4. Push the changes, the app should then be available on https://<github-username\>.github.io/<fork-name>/

Credits

Field image - https://github.com/mjansen4857/pathplanner

About

Digital Strategy Whiteboard for FIRST Robotics Competitions

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 85.6%
  • HTML 14.4%