Skip to content

README.md

Latest commit

 

History

History
54 lines (43 loc) · 1.91 KB

README.md

File metadata and controls

54 lines (43 loc) · 1.91 KB
Raw

HearMe - Connecting worlds through sound and silence.

📖 About the Project

HearMe is an iOS application developed to raise awareness about hearing loss. Inspired by real stories and personal experiences, the app aims to translate the invisible struggle of hearing impairment into a visual and interactive experience.

Through a "sketchy" hand-drawn aesthetic and sensory-based mini-games, users step into the shoes of someone losing their hearing, understanding that listening goes beyond ears—it involves patience, attention, and love.

🛠 Tech Stack

  • Language: Swift 5
  • UI Framework: SwiftUI
  • Game Engine: SpriteKit (integrated via SpriteView)
  • Audio: AVFoundation
  • Haptics: CoreHaptics / UIKit Feedback Generators
  • Architecture: MVVM (Model-View-ViewModel) / ECS
  • Concurrency: Swift Concurrency (Async/Await)

🚀 How to Run

  1. Clone this repository.
  2. Open HearMe.xcodeproj in Xcode 15+.
  3. Ensure you have the custom fonts (Amatic SC) installed or properly linked in Info.plist.
  4. Run on an iPad Simulator (iPad 11 Pro) or a physical device.

Note: Haptics work best on a physical device & Headphones make the experience way better.

📂 Project Structure

HearMe/
├── App/
│   ├── Assets.xcassets (Colors, Images)
│   └── HearMeApp.swift
├── Components/
│   ├── Sketchy/ (Custom Buttons, Popups, Sliders)
│   └── Manga/ (Story Panels)
├── Features/
│   ├── Menu/
│   ├── DailyRoutine/ (Story Mode)
│   ├── RhythmGame/ (SpriteKit Scene & Logic)
│   └── NoiseDistraction/ (Audio Logic)
├── Services/
│   ├── Audio/
│   └── Haptics/
└── Utils/
    ├── Enums/
    └── Fonts/

📜 Credits

  • Developer: Andrei Rech
  • Fonts: Amatic SC (Google Fonts)
  • Inspiration: Dedicated to my mother and everyone fighting the invisible battle of hearing loss.