bearTracks

a webapp for frc scouting

setup

environment variables

FRC_API_KEY
MY_TEAM
HOSTNAME
PASSKEY_RP_ID
TEAMS
EVENTS
SEASONS
APN_KEY_ID
APN_TEAM_ID

• FRC_API_KEY FRC API credentials, in base64. standard encoding (username:token), and omit the "Basic " occasionally prepended to the string. obtain a key: https://frc-events.firstinspires.org/services/API. (default: NONE)
  
• MY_TEAM your team number (default: 766)
  
• HOSTNAME your public IP (default: localhost)
  
• PASSKEY_RP_ID the domain for the passkeys (default: localhost)
  
• TEAMS is a comma separated list of all teams registered to use this instance of the app
  
• EVENTS is a comma separated list of all events the app should use
  
• SEASONS is a comma separated list of all seasons this app has been used
• APN_KEY_ID the ID of the APN key in the ssl folder (filename APN.p8)
• APN_TEAM_ID the team ID of the APN key

ssl

use cloudflare ssl in full strict mode. place certificate and key in ssl/cert.pem and ssl/key.pem.

running server

To start the server from a ssh session, run the following command from the ~/bearTracks directory.

nohup ./bear_tracks &

you may now exit the ssh session. To stop bearTracks, run

./service.sh stop

license

Copyright © 2025 Jayen Agrawal. All rights reserved. Email dev@jayagra.com for inquiries. By the GitHub TOS, you are permitted to view and fork the code. Everything beyond that, including but not limited to modification (public or private, even in your fork), distribution, and use in any form is prohibited without written permission.

iOS & macOS apps

The clients are broken into 3 apps- Data, Scout, and Manage. Manage is intended for the server admins, and can only be installed by compiling it yourself. Scout and Data are available on the App Store. Data uses Mac Catalyst to provide an optimized macOS experience, while Scout runs the iPad version. Accounts may be created in-app or on beartracks.io/create.

	Scout	Data	Manage
iOS 17, 18	✅	✅	✅
iOS 16, 15	✅	✅	❌
macOS 14, 15	✅	✅	✅
macOS 13, 12	✅	✅	❌
watchOS 9-11	❌	✅	❌
visionOS 2	❌	✅	❌
App Store	✅	✅	❌
Web (PWA)	✅	✅	❌

android users may use web.
web data access is not as complete as iOS access.

Data iOS
Data macOS
Scout iOS
Manage Xcode