Platform overview

What CaddieSight is

CaddieSight is a digital caddie platform that analyzes a golfer’s lie and returns actionable shot guidance. The platform is organized as a monorepo with multiple user-facing surfaces that share a common backend contract.

API

api/CaddieSight.Api is the system hub for uploads, analysis, profiles, swings, courses, and integrations.

Clubhouse

clubhouse is the React PWA used by golfers on the web.

iOS and Android

ios and android mirror the same product flow with native frameworks.

Supporting surfaces

proshop supports staff workflows and corp serves public marketing content.

Core golfer journey

The golfer captures or selects a photo of the ball lie.
The client submits the image plus shot context to the API.
The API stores image bytes in blob storage and metadata in PostgreSQL.
The shot-analysis pipeline produces lie analysis plus stance and club guidance.
The client immediately displays the recommendation and reads it aloud.

Cross-surface contract rule

The React, iOS, and Android clients all target the same API contract. A change to a request or response type is not complete until every affected client has been aligned.

Main capabilities

Photo upload and analysis
Speech playback of caddie advice
Swing-data import and per-club averages
Course search/import/refresh through OpenGolf
Profile management, avatars, and personalization
Subscription and upload-credit enforcement

Supporting principles

Keep the user flow fast and direct on the course.
Prefer structured data for agent outputs and platform contracts.
Treat the API as the source of truth for persistence and orchestration.
Mirror client behavior across web and native experiences where possible.