Development setup

Prerequisites

• Node.js 24+ for the web properties and this docs site.
• .NET 10 SDK for the API.
• PostgreSQL with PostGIS for structured platform data.
• Azurite when you need local blob-backed image and avatar storage.
• Xcode 16+ for iOS work.
• Android Studio with JDK 17 for Android work.

Local commands

API

Set-Location api/CaddieSight.Api
dotnet restore
dotnet run --launch-profile http

The API normally serves on http://localhost:5097 with Swagger at /swagger.

Clubhouse web app

Set-Location clubhouse
npm install
npm start
npm run build

Use .env.local with:

REACT_APP_CLUBHOUSE_API_URL=http://localhost:5097

Corp marketing site

Set-Location corp
npm install
npm run dev
npm run build

ProShop

Set-Location proshop
npm install
npm run build

Docs site

Set-Location docs
npm install
npm run dev
npm run build

Local infrastructure expectations

PostgreSQL

The API requires ConnectionStrings:Postgres and applies EF Core migrations on startup.

Blob storage

Blob storage is used only for image and avatar bytes. For local development, configure either:

• Storage:ConnectionString, or
• Storage:BlobEndpoint

If you use Azurite, run it with:

azurite --silent --skipApiVersionCheck --location $env:TEMP\azurite --blobHost 127.0.0.1 --queueHost 127.0.0.1 --tableHost 127.0.0.1

Working rules that matter in this repo

• Keep API controllers thin and push business logic into Application/Services.
• Persist structured data in PostgreSQL through EF Core repositories.
• Keep blob storage limited to binary assets such as uploaded images and avatars.
• If an API contract changes, update every affected client surface.
• Preserve the phase-one request/response flow unless a task explicitly asks to change it.