🧬 Genwise — Generational Life-Stage & Demographic Intelligence

Genwise is an Android demographic classification and life-stage intelligence application designed to deliver real-time generational cohort evaluation through clean UI states, ViewBinding, and Material 3 design.

Categorizing demographic data and understanding human generational life stages is fundamental across personalized UX onboarding, health assessments, and educational profiling.

Genwise provides a lightweight, responsive native Android implementation for evaluating age-based cohort criteria. Featuring ViewBinding, custom stroke input styling, and integrated IME keyboard action listeners, the app validates inputs, evaluates life-stage bounds, and dynamically renders personalized greetings and cohort classifications.

flowchart TD
    subgraph Input ["User Input & Trigger"]
        NI["Name Input Field"]
        AI["Age Input Field"]
        DoneBtn["IME Done Action / Submit Button"]
    end

    subgraph Validation ["Validation Engine"]
        CheckValid{"Non-empty Name & Valid Integer >= 0?"}
        ToastErr["Show Toast Feedback & Retain Focus"]
    end

    subgraph Classifier ["Life-Stage Evaluator (MainActivity)"]
        MatchAge{"Evaluate Age Bracket"}
        Child["👶 Child (< 13)"]
        Teen["🎒 Teenager (13 - 19)"]
        Adult["💼 Adult (20 - 59)"]
        Senior["🧓 Senior (60+)"]
    end

    subgraph UI ["Dynamic State Rendering"]
        Greet["binding.greetingText.apply { text = 'Hello, {Name}!' }"]
        Result["binding.ageGroupText.apply { text = 'You are a {Cohort}.' }"]
        Clear["binding.nameInput.clearFocus() & ageInput.clearFocus()"]
    end

    NI --> DoneBtn
    AI --> DoneBtn
    DoneBtn --> CheckValid

    CheckValid -- No --> ToastErr
    CheckValid -- Yes --> MatchAge

    MatchAge -->|< 13| Child
    MatchAge -->|13..19| Teen
    MatchAge -->|20..59| Adult
    MatchAge -->|>= 60| Senior

    Child --> Greet
    Teen --> Greet
    Adult --> Greet
    Senior --> Greet

    Greet --> Result
    Result --> Clear

• 🎯 Accurate Life-Stage Classification: Multi-tier evaluation logic parsing input into distinct biological and social cohorts: Child, Teenager, Adult, and Senior.
• ⚡ Seamless IME Done Action: Directly trigger classification from the soft keyboard's IME_ACTION_DONE key for frictionless single-handed operation.
• 🛡️ Robust Input Sanitization: Form validation guarding against non-numeric entries, empty text buffers, and negative values with instant Toast diagnostics.
• 🎨 Material 3 Design System: Styled text input layouts with custom color states, focus strokes, and dynamic visibility transitions.
• 🧩 ViewBinding Architecture: Complete elimination of findViewById boilerplate for type-safe, null-safe view references.

• Android Studio Ladybug or newer.
• JDK 11 or JDK 17.
• Android SDK 35.

1. Clone the repository:

   git clone https://github.com/shayann07/Genwise.git
   cd Genwise

2. Open in Android Studio and sync Gradle.
3. Build the debug APK:

   ./gradlew assembleDebug

4. Run on an Android emulator or physical device.

This project is licensed under the MIT License — Copyright (c) 2026 shayann07.