# Sunday - Android Version self-contained within the android/ directory.

ANDROID/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Sat Aug 02 14:11:47 CLT 2025
+gradle.version=8.13

ANDROID/.gradle/config.properties

@@ -0,0 +1,2 @@
+#Sat Aug 02 14:11:14 CLT 2025
+java.home=C\:\\Program Files\\Android\\Android Studio1\\jbr

ANDROID/.gradle/configuration-cache/1ba32f2a-6f21-4a21-a7c7-35515bf66b3b/build.work.bin

@@ -0,0 +1,2 @@
+���]
+xN��Ԓ��P�:{�~^0�m�����

ANDROID/.gradle/configuration-cache/1qoj2766qdel2f63aixcvg1di/candidates.bin

@@ -0,0 +1 @@
+

75d8e340-753f-4767-a219-3b90055843c�

ANDROID/.gradle/configuration-cache/d5cd9omad1dlgp0vpc4jtemum/candidates.bin

@@ -0,0 +1 @@
+

1ba32f2a-6f21-4a21-a7c7-35515bf66b3�

ANDROID/.gradle/configuration-cache/d9k9tgk0y309byuv9t345oex6/candidates.bin

@@ -0,0 +1 @@
+

55a74dae-6abe-49c1-ad0a-f072c383008�

ANDROID/METHODOLOGY.md

@@ -0,0 +1,139 @@
+# Sun Day - Vitamin D Calculation Methodology
+
+## Overview
+
+Sun Day calculates vitamin D synthesis from UV exposure using a multi-factor model based on scientific research. The app aims to provide personalized, accurate estimates while remaining conservative for safety. See [citations](https://github.com/jackjackbits/sunday/blob/main/METHODOLOGY.md#references).
+
+## Core Formula
+
+```
+Vitamin D Rate (IU/hour) = Base Rate × UV Factor × Clothing Factor × Skin Type Factor × Age Factor × Quality Factor × Adaptation Factor
+```
+
+## Factor Breakdown
+
+### 1. Base Rate (21,000 IU/hr)
+- Represents minimal clothing exposure (~80% body surface area)
+- Conservative estimate within research range of 20,000-40,000 IU/hr
+- Studies show 10,000 IU in 20-30 minutes typical
+- Full body exposure can reach 30,000-40,000 IU/hr in optimal conditions
+
+### 2. UV Factor (Non-linear)
+- Implements Michaelis-Menten-like saturation curve
+- Formula: `uvFactor = (uvIndex × 3.0) / (4.0 + uvIndex)`
+- Accounts for:
+  - Vitamin D synthesis plateaus at high UV levels
+  - Photodegradation of vitamin D above UV ~8
+  - Limited 7-dehydrocholesterol in skin
+
+### 3. Clothing Factor
+- **Nude (100%)**: Full body exposure
+- **Minimal/Swimwear (80%)**: Typical beach attire
+- **Light/Shorts & T-shirt (40%)**: Summer casual wear
+- **Moderate/Long sleeves (15%)**: Business casual
+- **Heavy/Fully covered (5%)**: Winter clothing
+
+### 4. Skin Type Factor (Fitzpatrick Scale)
+- **Type I (125%)**: Very fair, always burns - highest vitamin D production
+- **Type II (110%)**: Fair, usually burns
+- **Type III (100%)**: Light, sometimes burns - reference type
+- **Type IV (70%)**: Medium, rarely burns
+- **Type V (40%)**: Dark, very rarely burns  
+- **Type VI (20%)**: Very dark, never burns
+
+Based on melanin's UV filtering effect and research showing 5-10x longer exposure needed for darker skin types.
+
+### 5. Age Factor
+- **≤20 years**: 100% efficiency
+- **20-70 years**: Linear decrease (~1% per year)
+- **≥70 years**: 25% efficiency
+
+Reflects decreased 7-dehydrocholesterol in aging skin.
+
+### 6. UV Quality Factor (Time of Day)
+- Accounts for solar zenith angle effects on UV-B transmission
+- Peak quality around solar noon (10 AM - 3 PM)
+- More gradual decrease at low sun angles (exp(-0.2) vs exp(-0.3))
+- Morning/evening UV has less effective UV-B wavelengths
+
+### 7. Adaptation Factor
+- Based on 7-14 day exposure history from HealthKit
+- Range: 0.8-1.2x
+- Regular exposure upregulates vitamin D synthesis pathways
+- Prevents "shock" calculations for pale individuals suddenly exposed
+
+## Scientific Basis
+
+### UV-B and Vitamin D Synthesis
+- Only UV-B wavelengths (290-315nm) produce vitamin D
+- 7-dehydrocholesterol + UV-B → pre-vitamin D3 → vitamin D3
+- Process self-regulates through photoisomerization equilibrium
+
+### Altitude Effects
+- UV increases ~10% per 1000m elevation
+- Implemented as simple multiplier on base UV index
+
+### Cloud Cover
+- Already factored into UV index from weather API
+- Clear sky UV only used for reference
+
+### Daily Synthesis Limits
+- Body naturally limits to ~20,000 IU/day
+- Excess pre-vitamin D3 converts to inactive photoisomers
+- Prevents toxicity from sun exposure alone
+
+## Data Sources
+
+1. **UV Index**: Open-Meteo API (includes cloud effects)
+2. **Location**: iOS Core Location
+3. **User Characteristics**: Apple Health (when available)
+4. **Historical Data**: HealthKit vitamin D records
+
+## Burn Time Calculation
+
+Burn time is based on the **full MED** (Minimal Erythema Dose):
+
+```
+Burn Time = MED at UV 1 / Current UV
+```
+
+Real-world MED values at UV index 1:
+- Type I: 150 minutes (burns in ~30 min at UV 5)
+- Type II: 250 minutes (burns in ~45-50 min at UV 5)
+- Type III: 425 minutes (burns in ~75-85 min at UV 5)
+- Type IV: 600 minutes (burns in ~100-120 min at UV 5)
+- Type V: 850 minutes (burns in ~150-180 min at UV 5)
+- Type VI: 1100 minutes (rarely burns)
+
+These values reflect actual outdoor conditions with natural cooling and movement.
+The app notifies users at 80% of burn time as a safety warning.
+
+## Vitamin D Winter
+
+Above 35° latitude, UV-B is insufficient for vitamin D synthesis during winter months:
+- **November-February**: Minimal to no synthesis
+- **March & October**: Marginal synthesis (UV often < 3)
+- App displays warning and recommends supplementation
+
+## Safety Considerations
+
+- Base rate calibrated to typical exposure patterns
+- Burn time based on full MED
+- Seasonal warnings for vitamin D winter
+- Cannot reach toxic levels from UV exposure alone
+
+## Future Improvements
+
+1. **Spectral UV Data**: Use UV-B specific measurements when available
+2. **Body Surface Area**: More precise calculation based on height/weight
+3. **Seasonal Adjustments**: Winter UV-B availability at high latitudes
+4. **Individual Calibration**: Learn from user's actual vitamin D blood tests
+
+## Citations
+
+- Holick, M.F. (2007). "Vitamin D deficiency." New England Journal of Medicine
+- Webb, A.R. et al. (2018). "The role of sunlight exposure in determining the vitamin D status"
+- Engelsen, O. (2010). "The relationship between ultraviolet radiation exposure and vitamin D status"
+- MacLaughlin, J. & Holick, M.F. (1985). "Aging decreases the capacity of human skin to produce vitamin D3"
+- Çekmez, Y. et al. (2024). "Time and duration of vitamin D synthesis" PMC10861575
+- Various studies on MED and safe sun exposure from SunSmart Australia

ANDROID/METHODOLOGYES.md

@@ -0,0 +1,96 @@
+Metodología
+
+El objetivo es determinar la cantidad de tiempo que una persona necesita pasar bajo el sol para producir una cantidad saludable de vitamina D, sin quemarse.
+
+1. Tiempo para Quemarse
+
+Para determinar el tiempo que tarda la piel en quemarse, utilizamos el concepto de Dosis Mínima Eritematosa (MED, por sus siglas en inglés). Una MED es la cantidad de exposición a la radiación UV que causa un enrojecimiento perceptible de la piel (eritema). Se considera que 1 MED equivale a aproximadamente 2 SED (Dosis de Eritema Estándar).
+
+Usamos la siguiente fórmula para calcular el tiempo para alcanzar 1 MED:
+
+minutos_para_quemarse = (MED_personal * 60) / (UVI * 1.5)
+Donde:
+
+MED_personal se basa en el tipo de piel de Fitzpatrick del individuo.
+
+UVI es el Índice UV actual.
+
+1.5 es un factor de ajuste.
+
+2. Tiempo para Obtener Vitamina D
+
+El tiempo necesario para sintetizar vitamina D es generalmente menor que el tiempo para quemarse. Para la mayoría de las personas de piel clara, se estima que la producción de 1000 a 2000 UI (Unidades Internacionales) de vitamina D requiere aproximadamente 0.5 MED.
+
+Utilizamos la siguiente fórmula para calcular el tiempo para obtener una dosis saludable de vitamina D:
+
+minutos_para_vitamina_d = (MED_personal * 0.5 * 60) / (UVI * 1.5)
+Esta fórmula es esencialmente la mitad del tiempo que se tarda en quemarse.
+
+Fuentes de Datos
+
+Índice UV (UVI): Obtenido de la API de OpenUV, que proporciona datos del índice UV en tiempo real basados en la ubicación del usuario.
+
+Tipos de Piel de Fitzpatrick: Utilizamos la escala de Fitzpatrick para clasificar los tipos de piel y determinar la MED personal de un individuo.
+
+Valores de MED Personal por Tipo de Piel
+
+Tipo de Piel	Descripción	MED (J/m²)
+I	Siempre se quema, nunca se broncea	200
+II	Se quema fácilmente, se broncea mínimamente	250
+III	Se quema moderadamente, se broncea gradualmente	350
+IV	Se quema mínimamente, siempre se broncea bien	450
+V	Rara vez se quema, se broncea abundantemente	600
+VI	Nunca se quema, pigmentación oscura	1000
+
+Exportar a Hojas de cálculo
+Nota: Estos valores de MED son aproximaciones y pueden variar entre individuos.
+
+Explicación de la Metodología
+Ahora te explico qué significa todo esto en términos más sencillos.
+
+El objetivo de la app es muy simple: darte una "ventana de tiempo segura" para tomar el sol. Quieres el beneficio (vitamina D) sin el riesgo (quemadura). Para ello, la app realiza dos cálculos principales:
+
+Paso 1: Calcular cuánto tardas en quemarte
+El Concepto Clave: "Dosis Mínima Eritematosa" (MED). Imagina que es tu "límite personal de sol". Es la cantidad exacta de energía UV que tu piel puede recibir antes de empezar a ponerse roja.
+
+¿Cómo sabe tu límite? Usa la Escala de Fitzpatrick, que es un estándar científico para clasificar tipos de piel. Si tienes la piel muy clara (Tipo I), tu límite (MED) es bajo. Si tu piel es muy oscura (Tipo VI), tu límite es mucho más alto. Tú le dices a la app qué tipo de piel tienes.
+
+El Factor Externo: El Índice UV (UVI). Este número te dice qué tan fuerte está el sol en tu ubicación y en ese preciso momento. Un UVI de 10 es mucho más intenso que un UVI de 2. La app obtiene este dato en tiempo real usando tu GPS.
+
+La Fórmula Simple:
+Tiempo para Quemarse = (Tu Límite Personal) / (Intensidad del Sol Actual)
+
+La app toma tu MED (límite personal), lo divide por la intensidad del sol (UVI) y te da el resultado en minutos. Así sabes cuál es tu tiempo máximo de exposición antes de sufrir una quemadura.
+
+Paso 2: Calcular cuánto tiempo necesitas para generar Vitamina D
+La Buena Noticia: Producir vitamina D es mucho más rápido que quemarse. La ciencia ha demostrado que para la mayoría de la gente, solo se necesita la mitad de la dosis de UV que te causaría una quemadura para generar una buena cantidad de vitamina D (entre 1000 y 2000 UI).
+
+La Fórmula Simple:
+Tiempo para Vitamina D = (Tiempo para Quemarse) / 2
+
+La app simplemente toma el tiempo máximo que calculó en el paso anterior y lo divide por la mitad.
+
+El Resultado Final para Ti
+La app te presenta estos dos números para que puedas tomar una decisión informada.
+
+Ejemplo Práctico:
+
+Tus datos: Tienes piel Tipo III (MED de 350) y en tu ciudad el Índice UV ahora mismo es de 7.
+
+Cálculo de la app:
+
+Tiempo para Quemarse: (350 * 60) / (7 * 1.5) ≈ 33 minutos. Este es tu límite máximo.
+
+Tiempo para Vitamina D: 33 minutos / 2 ≈ 16.5 minutos.
+
+Lo que te muestra la app:
+
+"Para obtener una dosis saludable de Vitamina D, exponte al sol durante unos 16 minutos. Evita pasar más de 33 minutos para no quemarte."
+## References
+
+- Holick, M.F. (2007). "Vitamin D deficiency." New England Journal of Medicine
+- Webb, A.R. et al. (2018). "The role of sunlight exposure in determining the vitamin D status"
+- Engelsen, O. (2010). "The relationship between ultraviolet radiation exposure and vitamin D status"
+- MacLaughlin, J. & Holick, M.F. (1985). "Aging decreases the capacity of human skin to produce vitamin D3"
+- Çekmez, Y. et al. (2024). "Time and duration of vitamin D synthesis" PMC10861575
+- Various studies on MED and safe sun exposure from SunSmart Australia

ANDROID/README.md

@@ -0,0 +1,87 @@
+# Sunday - Android Version
+
+This is the Android version of [Sunday](https://github.com/jackjackbits/sunday), a powerful application for tracking UV exposure and Vitamin D generation, rebuilt from the ground up in Kotlin for the Android platform.
+
+This version is designed to be completely self-contained within the `android/` directory. 
+
+## Core Features
+
+This Android implementation currently provides the core functionalities essential for sun exposure tracking:
+
+| Feature                  | Android Implementation              | Status      |
+| ------------------------ | ----------------------------------- | ----------- |
+| **Real-time UV Tracking**    | Open-Meteo API Integration          | Implemented |
+| **Vitamin D Calculation**  | `SunExposureCalculator.kt` Logic    | Implemented |
+| **Burn Limit Calculation**   | Based on Fitzpatrick Scale & UV     | Implemented |
+| **Skin Type Selection**      | Fitzpatrick Scale Types I-VI        | Implemented |
+| **Clothing Level Adjustment**| Nude, Minimal, Light, etc.          | Implemented |
+| **Manual Refresh**         | Floating Action Button (FAB)        | Implemented |
+| **Bilingual Support**      | English & Spanish (Dynamic)         | Implemented |
+| **In-App Methodology**     | Displays methodology text           | Implemented |
+
+**Note:** Advanced features from the original iOS version such as Google Fit integration, database persistence (Room), widgets, and notifications are **not yet implemented** in this version.
+
+## Technical Architecture
+
+The application is built using a modern Android tech stack, focusing on simplicity and performance.
+
+-   **UI:** Fully built with **Jetpack Compose** for a modern, declarative user interface.
+-   **State Management:** State is managed directly within `@Composable` functions using `remember` and `mutableStateOf`.
+-   **Networking:** **Retrofit** and **Gson** are used for efficient and reliable communication with the Open-Meteo API.
+-   **Location:** Leverages **Google Play Services**' FusedLocationProviderClient for accurate location data.
+-   **Core Logic:** All sun exposure calculations are handled in a dedicated `SunExposureCalculator.kt` object, ensuring logic is centralized and testable.
+
+## Requirements
+
+-   **Android 6.0 (API 23)** or higher.
+-   **Google Play Services** installed and up-to-date.
+-   **Location Services** enabled for accurate UV data.
+-   **Internet Connection** for fetching weather data.
+
+## Project Structure
+
+The project structure is organized by feature/responsibility:
+
+```
+
+app/src/main/kotlin/com/example/sundayandroidapp/
+├── MainActivity.kt                 # App entry point
+├── api/                            # Retrofit API interface and data models
+│   ├── OpenMeteoApiService.kt
+│   └── OpenMeteoResponse.kt
+├── data/                           # Enums and data classes (SkinType, ClothingLevel)
+│   ├── SkinType.kt
+│   └── ClothingLevel.kt
+├── location/                       # Location services
+│   └── LocationService.kt
+├── logic/                          # Core calculation logic
+│   └── SunExposureCalculator.kt
+└── screens/                        # UI Composables
+    ├── HomeScreen.kt
+    ├── MethodologyScreen.kt
+    ├── SessionTrackingCard.kt
+    └── OptionsSelectorDialog.kt
+
+```
+
+## How to Build
+
+```
+bash
+# Clone the main repository
+git clone [repository-url]
+cd [repository-name]/android
+
+# Open the 'android' directory in Android Studio
+# Allow Gradle to sync and download dependencies
+
+# Build the debug version
+./gradlew assembleDebug
+
+```
+
+## License
+
+This project is licensed under the [MIT License](LICENSE). 
+by @gmolate
+```