Files
gridpilot.gg/docs/concept/CONCEPT.md
2025-12-01 22:01:58 +01:00

5.3 KiB
Raw Blame History

GridPilot — The Competition Platform for iRacing Leagues

A modern, lightweight platform that gives iRacing league racing structure, identity, and long-term meaning — without taking control away from communities.


1. What GridPilot Solves

iRacings strength is racing quality, not league infrastructure.
Today, league racing suffers from:

  • scattered tools (Discord, Sheets, Forms, DMs)
  • zero unified identity for leagues
  • heavy admin workload for every race
  • no automatic standings or result sync
  • no long-term driver identity or career stats
  • no proper team-based competition
  • unstructured protest handling (DMs, screenshots, chaos)

GridPilot becomes the competition layer above iRacing.
We dont change racing — we fix everything around it.


2. Who GridPilot Is For

League Admins

Need:

  • easy season setup
  • automatic result handling
  • clean standings
  • a structured complaints/penalty workflow
  • predictable points systems
  • modern league presentation
  • simple driver/team signups
  • optional session-creation QoL automation

Drivers

Need:

  • easy league discovery
  • simple registration
  • clean standings
  • reliable schedule
  • personal stats and history
  • long-term progression
  • team + individual competition
  • structured way to file complaints

Admin + Driver = GridPilots only focus for MVP.


3. Core Features (MVP)

3.1 League Identity

  • clean public league page
  • schedule, standings, roster, rules
  • league branding (logo, colors)
  • optional custom domain
  • links to Discord / YouTube / Twitch

3.2 Season Management

  • full calendar for each season
  • point system presets
  • drop weeks
  • team or solo mode
  • automatic standings

3.3 Driver & Team System

Drivers:

  • league join flow
  • personal stats (per race + lifetime)
  • progression + history
  • cross-league identity (v1 basic)

Teams:

  • create/manage teams
  • team roster management
  • real “Constructors Championship” parallel scoring
  • team standings + history

(This is a unique selling point: real team racing in iRacing leagues.)


4. Complaints & Penalties (Essential)

A structured system to replace Discord DMs and random drama.

4.1 Driver Complaints

Drivers can file a complaint with:

  • race
  • involved drivers
  • timestamp(s)
  • description
  • optional replay clip / link

Keeps everything organized and searchable.

4.2 Admin Penalty Tools

Admins get a review panel:

  • complaint list
  • timestamps + notes
  • direct links to replays
  • quick actions:
    • no action
    • warning
    • time penalty
    • points deduction
    • DQ for race

4.3 Automatic Standings Update

When a penalty is assigned:

  • driver points update
  • team points update
  • classification updates with time penalties
  • everything logged transparently

Admins stay in control.
Drivers understand the decision.
Chaos disappears.


5. Result Automation (Essential QoL)

  • automatically sync race results from iRacing
  • parse positions, laps, incidents, fastest lap
  • update standings instantly
  • eliminate manual CSV uploads or spreadsheets

This is core for both admins and drivers
(but not the “main feature” — just feels like magic).


6. Optional: Session Creation QoL (Not required)

GridPilot can assist admins:

  • create sessions via browser automation
  • batch-create entire season
  • consistent settings without errors

Important: Automation is a helper, not the product.
We never touch gameplay.


7. Competition Layer

This is what makes GridPilot more than “tools”.

7.1 Individual Progression

Drivers earn:

  • points
  • standings
  • history
  • personal stats
  • performance trends

Racing finally has long-term meaning.

7.2 Team Competition

Teams accumulate points across races and seasons.
Drivers contribute to team success even when racing individually.

The result: iRacing Ligen finally feel like real motorsport championships.


8. Safety, Security & Trust

  • zero-knowledge login
  • we never see or store passwords
  • browser window visible for login
  • automation always runs on the admins machine
  • no client modification (unlike iRefined)

Trust and legality are fundamental.


9. MVP Philosophy

What we include:

  • Admin QoL tools
  • Driver identity
  • Team competition
  • Standings + automation
  • Complaints + penalties
  • League identity + presentation
  • Session creation helper (optional)

What we leave out for now:

  • stewards marketplace
  • streaming tools
  • monetization
  • complex global ladder
  • rating systems
  • cross-sim functionality
  • esports organization

GridPilot starts simple and solid.


10. Long-Term Vision (kept small but real)

GridPilot becomes the central place where:

  • drivers build a career
  • teams compete across seasons
  • leagues run without chaos
  • complaints/penalties stay structured
  • standings stay consistent
  • automation reduces work
  • identity and progression matter

This is the part that makes us THE platform,
but we dont overpromise it on day one.


Summary

GridPilot simplifies league management —
and elevates it from scattered spreadsheets
to a modern competition platform.

Admins get less work.
Drivers get more meaning.
Teams get real championships.
Everyone gets structure instead of chaos.