CaminaifesUnlockTarragona

Camina i fes UNLOCK! Tarragona 🏃‍♂️🔓

Aplicació híbrida (Vite + Capacitor) que gamifica l’activitat física: mentre camines per Tarragona, vas acumulant metres fins a desbloquejar 10 imatges (500 m per imatge). El progrés es veu amb un canvas tipus mosaic/pixel-art, amb hàptica, minimapa i un petit panell de configuració.

Funcionalitats

Desbloqueig per distància: 500 m per imatge (progrés persistent per imatge).
Seguiment continu de posició amb Geolocation.watchPosition (millor precisió i eficiència que polls amb intervals).
Filtrat de soroll: ús d’accuracy i filtres anti-jitter / anti-spike.
Minimapa (Leaflet + OpenStreetMap) amb la posició actual.
Canvas: mosaic de tiles + placeholder pixelat, amb transicions suaus.
Haptics / Vibració: feedback durant el desbloqueig (configurable).
Configuració ⚙️: mode nit, mida de tile, vibració, i Mode Demo.
Ranking / Insígnies: marcador X/10 i 10 boletes que es tornen verdes quan desbloqueges fotos.
Persistència: LocalStorage (progrés i preferències).

Captures de l’app

Pantalla principal Desbloqueig completat Checklist i mapa Configuració Galeria Info Viquipèdia

Requisits

Node.js (LTS recomanat)
Android Studio + Android Emulator (o dispositiu físic)
JDK instal·lat

Instal·lació

npm install

Executar en web

npm run dev

Preparar Android (1a vegada)

npm run build
npx cap add android
npx cap sync android
npx cap open android

Si ja tens android/ creat, no cal fer cap add.

Cada cop que canvies el codi

npm run build
npx cap sync android

Proves a l’emulador (GPS)

A Android Studio:

Obre l’emulador
Extended Controls → Location
Defineix punts o una ruta per simular que camines.

Mode Demo

A ⚙️ activa “Mode demo” per sumar metres (+50m / +200m) i provar el desbloqueig sense GPS.

Imatges

Adaptades per a l’app, a un tamany de 1080×1080. Cadascuna té la seva font indicada a la part inferior esquerra.