Tap In

Tap In is an iOS 17 SwiftUI app for spontaneous on-campus events. It focuses on a fast authoring loop—capture the essentials, confirm, and publish-while keeping students updated on nearby events through a map view and swipe-up directory.

Feature Summary

Area	Highlights
Event authoring	Form with live defaults (start time = now) and a 1–12 hour duration cap
MapKit UI	MapKit pins show user location, nearby events, and allow user interaction
Directory overlay	Search, category chips, random selector, and animated detail cards
Detail page	Action buttons (“I’m here”, “Cancel”) and smooth slide transitions

Architecture

• SwiftUI using NavigationStack, custom overlay sheets, and state-driven animations.
• Services layer (Services/) wraps Firebase Auth/Firestore; async/await powers Firestore helpers.
• Firebase/Firestore handles user authentication, database hosting, and management.
• CoreLocation integration seeds new events with device coordinates when available.
• Cloud Functions handle backend logic, managing popularity and live activity.

Build & Run

1. Open hacknc-2025/hacknc-2025.xcodeproj in Xcode 15 or later.
2. (Optional) Resolve Swift Packages if you want Firebase (File > Packages > Resolve).
3. Run the hacknc-2025 target on an iOS 17 simulator or device.

Firebase Setup (Optional)

1. Add GoogleService-Info.plist to the app bundle.
2. Select your Apple Developer Team under Signing & Capabilities.
3. Build and run; Auth and Firestore services will use your project configuration.

AI Use

• Debugging application behaviour
• Fixing layout issues
• Addressing formatting problems
• Assisting in feature implementation
• Assisting in writing this README

License

Tap In is released under the MIT License. See LICENSE for details.