SaltoInicial: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Descripción

SaltoInicial es una app Android que envuelve el sitio web https://www.saltoinicial.com.ar/ en un WebView nativo con Jetpack Compose. Es un proyecto de módulo único (:app).

Repositorio público: nunca commitear claves, tokens, DSNs ni keystores. Ver Configuración local.

Comandos

# Compilar debug
./gradlew assembleDebug

# Compilar release (con R8 + shrinkResources)
./gradlew assembleRelease

# Ejecutar tests unitarios
./gradlew test

# Ejecutar tests instrumentados (requiere dispositivo/emulador)
./gradlew connectedAndroidTest

# Ejecutar un test específico
./gradlew testDebugUnitTest --tests "com.boa.saltoinicial.presentation.viewmodel.MainViewModelTest"

# Análisis estático (config en config/detekt/detekt.yml, autoCorrect activado)
./gradlew detekt

# Limpiar build
./gradlew clean

# Instalar en dispositivo conectado
./gradlew installDebug

Configuración local

Los SDKs de terceros se configuran con claves inyectadas en BuildConfig en tiempo de compilación. Van en local.properties (ignorado por git) o como propiedades de Gradle (-PclaveX=valor):

appsFlyerDevKey=
amplitudeApiKey=
sentryDsn=
newRelicAppToken=
mixpanelProjectToken=
facebookAppId=
facebookClientToken=

Cada clave ausente degrada con gracia: el SDK correspondiente no se inicializa y se loguea una advertencia con Timber. La app compila y corre sin ninguna de ellas.

facebookAppId y facebookClientToken además se inyectan como manifestPlaceholders.

local.properties nunca debe commitearse. app/google-services.json sí está versionado: la API key de Firebase que contiene no es un secreto (es extraíble de cualquier APK), pero la seguridad real depende de las Firebase Security Rules y de App Check, no de ocultar ese archivo.

Arquitectura

Clean Architecture en tres capas dentro del módulo :app, con patrón MVI en presentación y DI manual vía ViewModelProvider.Factory (sin Hilt).