Skip to content

Android app for wake surfers and foilers to track boat waves on Swiss lakes. Built with Kotlin

Notifications You must be signed in to change notification settings

pfederi/NextWaveAndroid

Repository files navigation

Next Wave - Android

Next Wave ist eine App für Wakesurfer und Foiler, die Bootswellen auf Schweizer Seen verfolgen können. Diese Android-Version wurde mit Kotlin und modernen Android-Entwicklungstechnologien entwickelt.

Funktionen

  • Kartenfunktionen:

    • OpenStreetMap-Integration für detaillierte Wassernavigation
    • Overlay für Schifffahrtsrouten
    • Clustering von Stationen für bessere Übersicht
    • Automatisches Caching der Karten für Offline-Nutzung
    • Optimiert für hellen und dunklen Modus
  • Schiffsdaten und Wellenberechnung:

    • Anzeige von Schiffsdaten
    • Berechnung von Welleneigenschaften (Höhe, Länge, Periode, etc.)
    • Wellenbewertung (1-3 Wellen)
  • API-Integration:

    • Echtzeit-Schiffseinsätze
    • Aktuelle Schiff-Kurs-Zuweisungen
  • Datenschutz:

    • Keine Verfolgung oder Analyse
    • Keine Sammlung persönlicher Daten
    • Standortdaten werden nur für die Anzeige der nächsten Station verwendet

Technologien

  • Kotlin: Moderne, typsichere Programmiersprache für Android
  • Jetpack Compose: Deklaratives UI-Framework für moderne Android-Apps
  • MVVM-Architektur: Klare Trennung von UI, Logik und Daten
  • Coroutines & Flow: Asynchrone Programmierung für reaktive Datenströme
  • OSMDroid: OpenStreetMap-Integration für Android
  • Retrofit & OkHttp: Netzwerkkommunikation mit der Next Wave API
  • Material Design 3: Moderne UI-Komponenten und Theming

Anforderungen

  • Android 8.0 (API Level 26) oder höher
  • Internetverbindung für Echtzeit-Daten
  • Standortzugriff für lokale Funktionen

Installation

  1. Lade die APK von der Releases-Seite herunter
  2. Aktiviere "Installation aus unbekannten Quellen" in den Einstellungen deines Geräts
  3. Öffne die heruntergeladene APK-Datei und installiere die App

Alternativ kannst du das Projekt klonen und in Android Studio öffnen:

git clone https://github.com/yourusername/nextwave-android.git

Entwicklung

Projektstruktur

  • app/src/main/java/com/example/nextwave/
    • data/: Datenmodelle, Repository und API-Dienste
    • ui/: UI-Komponenten und ViewModels
    • MainActivity.kt: Haupteinstiegspunkt der App
    • NextWaveApplication.kt: Anwendungsklasse für globale Konfiguration

Bauen und Ausführen

  1. Öffne das Projekt in Android Studio
  2. Synchronisiere das Projekt mit Gradle
  3. Führe die App auf einem Emulator oder Gerät aus

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die LICENSE Datei für Details.

Danksagungen

  • Basierend auf der iOS-Version von Next Wave
  • Verwendet OSMDroid für Kartenfunktionen
  • Inspiriert von der Schweizer Schifffahrtsgemeinschaft

About

Android app for wake surfers and foilers to track boat waves on Swiss lakes. Built with Kotlin

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages