Build and operate the CaddieSight platform

Platform surfaces

Understand how the API, Clubhouse web app, native mobile apps, ProShop, and corp site fit together.

Architecture depth

Explore layered services, repositories, integrations, auth, storage, and cross-surface contracts.

Code-aware guidance

Navigate the monorepo, design patterns, deployment workflows, and practical code examples from the platform.

Development setup

Local commands, configuration expectations, and environment notes for working across the monorepo.

Platform overview

Product flow, main surfaces, and the contract boundaries that keep the experience aligned.

System architecture

End-to-end architecture for request flow, persistence, AI orchestration, and client responsibilities.

Codebase map

Folder-by-folder guide to the major projects, the responsibilities of each, and where to extend them.

What this site covers

• The phase-one golfer flow from photo capture to immediate recommendation and spoken readout.
• The backend architecture in /api/CaddieSight.Api, including controllers, services, domain interfaces, repositories, and integrations.
• The client implementations in React, SwiftUI, and Jetpack Compose, and how they mirror one another.
• The deployment story for Azure App Service, GitHub Actions, and environment configuration.
• The design patterns used throughout the codebase so new features stay consistent with the current shape of the product.

Suggested reading paths

New to the repo

1. Read Platform overview.
2. Follow with Development setup.
3. Review Codebase map.

Implementing backend features

1. Start at API architecture.
2. Review Integrations and data flows.
3. Finish with Design patterns.

Updating client experiences

1. Read Client applications.
2. Check Platform overview for the user flow constraints.
3. Use Workflows and deployment before shipping.