Running Both Projects in Visual Studio Code

To launch both the Blazor PWA (SFA_PWA) and the WebAPI backend (SFA_WebAPI) in development:

1. Open two terminals in VS Code.
2. In the first terminal, run:

   dotnet run --project SFA_PWA/SFA_PWA.csproj

3. In the second terminal, run:

   dotnet run --project SFA_WebAPI/SFA_WebAPI.csproj

4. Make sure your Blazor app’s API calls use the correct backend URL (http://localhost:5216/api/bot/chat).

You can copy and paste these commands directly into your VS Code terminals.

Testing the Web API with curl

You can test your production Web API endpoint using curl. Replace the URL and endpoint as needed:

curl -X POST "https://sfawebapi-c9bgawf9evfkg6dp.westeurope-01.azurewebsites.net/api/Bot/chat" -H "accept: application/json" -H "Content-Type: application/json" -d '{"message": "How can I join the club?"}'

adb logcat > cafes-log.txt

Running the .NET MAUI app (SFA_MauiApp)

The MAUI project targets multiple frameworks, so specify which target when running with dotnet watch run using --framework (or -f). Example commands:

• Windows:

dotnet watch run --framework net10.0-windows10.0.19041.0
$env:DOTNET_HOST_PATH="C:\Program Files\dotnet\dotnet.exe"; dotnet watch run --framework net10.0-windows10.0.19041.0

• Android (requires Android SDK + emulator/device):

dotnet watch run --framework net10.0-android

• Mac Catalyst (macOS only):

dotnet watch run --framework net10.0-maccatalyst

• iOS (macOS only):

dotnet watch run --framework net10.0-ios

Notes:

If your API requires authentication or a POST request, update the command accordingly.

• Use the exact TFMs listed in SFA_MauiApp/SFA_MauiApp.csproj: net10.0-android, net10.0-ios, net10.0-maccatalyst and (on Windows) net10.0-windows10.0.19041.0.
• Platform constraints apply (Android/emulator, macOS for iOS/MacCatalyst).
• To simplify local dev, either run with --framework or temporarily set a single TargetFramework in the project file. You can also add a VS Code task to run the preferred target.

Shared UI + Services (Razor Class Library)

The app UI (Razor components/pages/layout) and all application services have been extracted into the Razor Class Library project SFA_RazorClassLibrary.

• SFA_PWA is now a thin Blazor WebAssembly host.
• A future .NET MAUI Blazor (Hybrid) host can reference the same library to reuse the UI + services.

Registering services from a host

The host should register the shared services via the extension method in SFA_RazorClassLibrary/DependencyInjection.cs.

Blazor WebAssembly host example (current):

builder.Services.AddSfaPwaServices(
	new Uri(builder.HostEnvironment.BaseAddress),
	new Uri(botApiUrl));

MAUI host example (not included in this repo yet):

// In MauiProgram.CreateMauiApp()
builder.Services.AddSfaPwaServices(
	baseAddress: new Uri("https://example.invalid/"),
	botApiBaseUri: new Uri("https://your-api-host/"));

Notes:

• baseAddress is used to create the default HttpClient for loading app data; choose an appropriate base URI for your host.
• botApiBaseUri should match where your WebAPI is hosted (used by the chatbot/admin start points features).
• Web-host-only files like SFA_PWA/wwwroot/index.html remain in the WASM host. If/when you create the MAUI host, you may need to provide equivalent static assets (images/css/js) or move selected assets into an RCL wwwroot/ later.

🚴‍♂️ San Fairy Ann Cycling Club App

Welcome to the proposed mobile app for the San Fairy Ann Cycling Club! 🎉

🌟 Overview

A modern Blazor Progressive Web App (PWA) designed to help club members and guests easily access ride info, club resources, and useful cycling links. Works on desktop and mobile, and saves your settings locally for convenience.

🏆 Features

• 📅 Ride Info: Upcoming routes and schedules from Google Calendar
• 🔗 Links: Quick access to WhatsApp channels, social media, club kit shop, recommended cafes, repair shops, and more
• 🌦️ Weather: Forecasts for ride days, with your favorite weather service
• ⚙️ Settings: Save your preferences and filter rides by group or location
• 🔍 Search: Instantly find any link or resource
• ➕ Custom Links: Add your own favorite cycling resources
• 🆘 Help & Feedback: Direct link to GitHub for reporting issues or suggestions

🚀 How to Use

1. Browse the navigation menu to explore all features
2. Check the Calendars page for upcoming rides
3. Visit the Links page for club resources, WhatsApp, Strava, Garmin, and more
4. Check the Weather page for ride forecasts
5. Customize your experience in Settings
6. Search or add links to make the app your own

💡 Tips

• The app works offline and saves your settings in your browser
• You can install it on your phone or desktop for quick access
• For feedback or help, use the GitHub link in the app menu

🤝 Contributing

We welcome feedback and contributions! Please open an issue or pull request on GitHub.

📝 License

This project is open source and free for all club members and cycling enthusiasts.

---

Made with ❤️ for the San Fairy Ann Cycling Club 🚴‍♀️🚴‍♂️🚴