FRC Search - Browser Extension

FRC Search is a powerful browser extension designed to provide you with quick and easy access to comprehensive information about First Robotics Competition (FRC) teams. Built with a speedy and efficient Bun-powered infrastructure, FRC Search allows you to instantly look up team details, keep track of your favorite teams, and stay organized by creating custom groups.

This extension has been tested and confirmed to work on Brave, Chrome, Edge, OperaGX, Opera, Firefox, and Zen Browser.

Features

• Blazing-Fast Search: Instantly find teams using their number or name.
• Detailed Team Insights:
  • Country Ranks: View the team's ranking within their country, accompanied by detailed charts.
  • World Rank: Explore the team's global ranking with insightful charts.
  • Map Integration: See the team's location on an interactive map powered by FRCMap.com.
  • AI Overview (Powered by DeepSeek): Get a concise overview of the team generated by the DeepSeek AI model.
• Favorite Teams: Easily track the teams you're most interested in by adding them to your favorites.
• Group Creation: Organize your teams into custom groups (e.g., "Rival Teams," "Regional Teams").
• User-Friendly Interface: A modern and intuitive user interface developed with Vue.js and Vite.

Installation

This extension consists of two main components: a browser extension and a server, both built with Bun.

Browser Extension (extension folder)

The frontend is developed using Vue.js and Vite within the Bun environment.

1. Download or clone the extension folder from the GitHub repository to your local machine.

2. To run in a development environment (optional):

   cd extension
   bun install
   bun run dev

3. To build for production (chrome or firefox):

   cd extension
   bun run build:chrome

4. Install the extension in your browser following these steps:

   • Google Chrome, Brave, Edge, Opera, OperaGX, and Zen Browser:
     1. Navigate to chrome://extensions in your browser.
     2. Enable the "Developer mode" toggle in the top right corner.
     3. Click the "Load unpacked" button in the top left corner.
     4. Select the extension/dist folder you downloaded and click "Open."
   • Mozilla Firefox:
     1. Navigate to about:addons in your browser.
     2. Click the gear icon in the top right corner and select "Install Add-on From File..."
     3. Select the manifest.json file located within the downloaded extension folder and click "Open."

5. Once successfully installed, you'll see the FRC Search icon in your browser's toolbar.

Backend Server (server folder)

The backend is developed using TypeScript and Express.js on Bun. It utilizes MongoDB and Mongoose for the database.

1. Download or clone the server folder from the GitHub repository to your local machine.

2. Install the necessary dependencies:

   cd server
   bun install

3. Configure your MongoDB database and set the connection details in the .env file.

4. Start the server:

   bun run dev   # Development mode
   # or
   bun start     # Production mode

Note: The server must be running correctly for the extension to access all features (AI summaries, detailed ranking charts, etc.).

Usage

1. Click the FRC Search icon in your browser to open the extension.
2. Enter the number or name of the team you want to search for in the search bar and click "Search."
3. On the results page, you'll see the team's basic information, country and world rankings, their location on the map, and an AI-generated overview powered by DeepSeek.
4. To add a team to your favorites, click the "Add to Favorites" icon next to the team's information.
5. To create groups, navigate to the "Groups" section in the extension menu and create a new group. You can then add your favorite teams to these groups.

Screenshots

See the extension in action! Here are some screenshots showcasing its key features and interface.

Search results and basic team information

---

Detailed charts displaying the team's country and world rankings

---

The team's location on the interactive FRCMaps.com map

---

The AI-generated team overview powered by DeepSeek

---

A view of your favorite teams and created groups

Contributing

If you'd like to contribute to FRC Search, please follow these steps:

1. Fork this repository.
2. Create a new branch (git checkout -b feature/new-feature).
3. Commit your changes (git commit -am 'Add new feature').
4. Push to the branch (git push origin feature/new-feature).
5. Submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

---

Thank you! We hope FRC Search proves to be a valuable tool for the FRC community.