FRC Scouting App for Team 3464 "Sim-City"

Mass data collection

Built for the First Robotics Competition REBUILT 2026

Caution

You must create your own firebase database if you are not part of Sim-City

Features

• Questionnaire detailing all the data about another team
• Offline storage, for the terrible connection found at competitions
• Linked to usernames (less false data)
• Google Auth for creating users

Installation

Clone the repository and install dependencies. Node must be first installed

git clone https://github.com/FRC-Team-3464/sim-scouting
cd sim-scouting
npm install

To build frontend:

npm build

Documentation

Firebase

Working with the best free database:

• SERVER SIDE (backend/server.js) --
  • implementation of node.js and express.js
  • GET to "/debug": works with debug.tsx. just delivers which uid's to allow
  • POST to "/write": writes to theh database

Warning

to write you must submit a JSON.

• POST to "/read": reads documents. submit a path
• POST to "/signup": creates users
• POST to "/login": fetches hashed passwords to authenticate users
• POST to "/register": make user

Requests

Every request on the server side has 2 properties: req (request), and res (response). by using app.use(express.json()), both of these properties will be jsons. Request types.

• CLIENT SIDE (frontend/src/scripts/firebase.tsx) --
  • Most of the functions simply make a post request to server.js, except
  • register(): uses sha256 to encrypt passwords. If you don't know what this does, ask Ms. Meyer, and say sam sent you

Components (frontend/src/components)

AutoResizeTextArea

Autoresizetextarea.tsx

• label: String that appears above the text area, labeling it.
• value: Value that the input is changing.
• onChange: Function that runs when the value is changed.
• placeholder: String that is shown when it is blank.

BinaryChoice

BinaryChoice.tsx

• label: String that appears above the text area, labeling it.
• options: An array of strings that function as toggleable buttons.
• value: Value that the buttons are changing, the first button is selected if the value is true, and the second button is selected if it is false.
• onChange: Function that runs when the value is changed.

CheckboxDropdown

CheckboxDropdown.tsx

• label: String that appears above the text area, labeling it.
• optionList: Array that contains all of the options as strings.
• optionCheck: *Record<string, boolean### * that has the same key names as optionList, but also has boolean values attached to the keys.
• onChange: Function that runs when the value is changed.

Caution

in Matchform.tsx this element is not used

CounterInput

CounterInput.tsx

• value: Value that the input is changing.
• onChange: Function that runs when the value is changed.
• min: Minimum integer that the value can be.
• max: Maximum integer that the value can be.
• label: String that appears above the text area, labeling it.

Dropdown

Drowdown.tsx

• value: Value that the input is changing.
• options: An array of strings that function as options inside of the dropdown.
• label: String that appears above the text area, labeling it.
• onChange: Function that runs when the value is changed.
• placeholder: String that is shown when it is blank.

IntegerInput

IntegerInput.tsx

• value: Value that the input is changing.
• onChange: Function that runs when the value is changed.
• placeholder: String that is shown when it is blank.
• min: Minimum integer that the value can be.
• max: Maximum integer that the value can be.
• label: String that appears above the text area, labeling it.

MultiCounterInput

MultiCounterInput.tsx

• value: Value that the input is changing.
• onChange: Function that runs when the value is changed.
• min: Minimum integer that the value can be.
• max: Maximum integer that the value can be.
• label: String that appears above the text area, labeling it.

Scripts

seed.tsx

• Function that returns fake match data as a JSON.

user.tsx

• Has functions that relate to reading and generating the users cookie.

debug.tsx

• fetches which users have higher access

firebase.tsx

• view Firebase section of README.md

Other

.env

• File that has values that are kept hidden from the public.
• Used to hold api keys and secret values.
• Each variable name must be capitalized, underscores instead of spaces, and start with VITE_

.gitignore

• Makes git ignore files, and not show them on the repository.
• Can contain specific paths, file names, or directory names.
• Can also have comments using "#", and negation using "!"