Tally

Tally is a real-time tournament scheduling dashboard designed for FIRST LEGO League (FLL) events. It integrates seamlessly with Google Sheets to provide live schedule updates, pit locations, and upcoming matches to teams and organizers. The application has the following features:

Connect directly to a Google Sheet to fetch and display live tournament schedules.
View real-time “Happening Now” and “On Deck” match and judging sessions.
Filter the schedule by specific teams.
Centralized view of all team pit locations.
Built-in Tournament Schedule Generator with customizable parameters (fields, judging areas, lunch breaks, etc.).
Export generated schedules to XLSX, PDF, and PNG formats.
Multiple schedule viewing modes (Grid and List views).
Toggleable Light, Dark, and System visual themes.

Tally was originally developed as a side project on the Riverside STEM Foundation website . The project has since been decoupled to function as a standalone utility. This allows for dedicated hosting and independent version control. The initial commit of this repository introduces a complete application with minimal changes from the original project. This is a Next.js project bootstrapped with create-next-app .

Installation

Clone the repository and navigate to the project folder directory.

BASH

git clone https://github.com/michaeltin001/tally.git
cd tally
git clone https://github.com/michaeltin001/tally.git
cd tally

Start the development server.

BASH

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3001 with your browser to see the result.

Overview

Tally operates primarily as a single-page dashboard application that centralizes all tournament information.

Home
Settings
Tournament Schedule Generator

Home

The main dashboard displays real-time updates and the complete tournament schedule once connected to a data source.

Status Header: Displays the current time, tournament date, and any active delays affecting the schedule.
Happening Now: Shows all active events (matches, judging sessions) that are currently underway based on the current time.
On Deck: Highlights upcoming events that are scheduled to start shortly, ensuring teams know when to prepare.
Tournament Schedule: A chronological list of all events for the day. Each entry displays the event title, team name, team number, pit location, specific event code, and time slot.
View Schedule: Opens a modal to preview the full master schedule in either a Grid or List format.

Settings

Accessed via the “Settings” button, this modal provides configuration options to tailor the dashboard to your needs.

Data Source: Connect your live tournament Google Sheet by providing its ID. This is the primary way to populate the dashboard with data.
Filter Teams: Select one or multiple specific teams to filter the entire dashboard. When filtered, the “Happening Now”, “On Deck”, and “Tournament Schedule” sections will only show events relevant to those selected teams.
Pit Information: A centralized directory listing the pit locations for all participating teams.
Theme: Switch the application’s appearance between Light, Dark, or System default themes.

Tournament Schedule Generator

If you are an organizer and don’t yet have a schedule, Tally includes a built-in generator to help you create one from scratch.

Configuration: Set tournament parameters including base match periods, judging duration multipliers, number of fields, judging areas, rounds, and specific schedule blocks (like lunch breaks or opening ceremonies).
Team List: Input your participating teams directly into the generator.
Preview Modes: View the resulting generated schedule in an intuitive Grid layout or a chronological List view before finalizing.
Exporting: Download the finalized schedule as an Excel spreadsheet (XLSX), PDF document, or PNG image, which you can then upload to Google Sheets to act as your live data source.

Attribution

This project incorporates code from JiayiGeng/JiayiGeng.github.io , which is licensed under the MIT License.

content/config.toml
src/app/globals.css
src/app/layout.tsx
src/components/layout/Footer.tsx
src/components/layout/Navigation.tsx
src/components/ui/ThemeProvider.tsx
src/components/ui/ThemeToggle.tsx
src/lib/config.ts
src/lib/stores/themeStore.ts
src/lib/utils.ts