Skip to content

Repository files navigation

๐Ÿ† FIFA World Cup 2026 Predictor & Interactive Bracket

A premium, responsive, and feature-rich client-side web application to track groups, standings, schedules, brackets, and predict scores for the 2026 FIFA World Cup (hosted across the USA, Canada, and Mexico).

Live at: https://soccerworldcup.xyz


๐ŸŒŸ Key Features

  • ๐Ÿ“Š Real-time Standings & Groups: Live calculations of points, goals scored/conceded, goal difference, wins, and group positions.
  • ๐Ÿ“… Interactive Matches Tab: View, search, and filter matches by round, group, status, or team name.
  • ๐ŸŒฟ Interactive Tournament Bracket: Drag-and-pan responsive visual bracket tracking progression from the Round of 32 all the way to the Final in New York/New Jersey.
  • ๐Ÿ”ฎ Score Predictor Workspace: Set custom scorelines for group and knockout matches and watch the group tables and knockout brackets recalculate and progress dynamically.
  • โšฝ Match Details Modals: Click on any match card or list row to open a detailed popup with a chronological goal timeline, venue details, and prediction comparisons.
  • ๐ŸŒ“ Theme Switching: Premium dark and light modes with custom CSS tokens.
  • ๐Ÿ’พ Local Persistence: All prediction states are automatically saved to your browser's localStorage.

๐Ÿ› ๏ธ Technology Stack

  • HTML5: Semantic document structure.
  • CSS3: Vanilla CSS variables, animations, glassmorphism, responsive grid/flexbox layouts.
  • JavaScript: Vanilla ES6+ logic (data-driven state management, dynamic DOM rendering).
  • VCS: Managed using Jujutsu (jj) backing Git.

๐Ÿš€ How to Run Locally

You do not need to install complex dependencies. You can serve the static files using any simple web server:

  1. Clone the repository:
    jj git clone git@suraj.github.com:surajp/wc-26.git
  2. Serve using Node.js:
    npx http-server .
    Or if you prefer python:
    python3 -m http.server 8000
  3. Open http://localhost:8080 (or http://localhost:8000) in your browser.

๐Ÿ“‚ Project Structure

โ”œโ”€โ”€ index.html           # Main application shell
โ”œโ”€โ”€ app.js               # Application engine, data handlers, and DOM renderers
โ”œโ”€โ”€ style.css            # Custom CSS variables, light/dark themes, animations
โ”œโ”€โ”€ worldcup.json        # Baseline tournament match fixtures
โ””โ”€โ”€ CNAME                # Domain routing mapping for GitHub Pages

About

Site for soccer world cup scores

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages