refactor: notifications and settings view models; enhance login and registration UI

README.md

@@ -1,2 +1,46 @@
-# mayday
-The app you hope you never get a notification from
+<p align="center">
+	<img src="Mayday/Assets.xcassets/Logo.imageset/logo.png" alt="Mayday logo" width="96" height="96" />
+</p>
+
+<h1 align="center">Mayday</h1>
+
+<p align="center">
+	The app you hope you never get a notification from.
+</p>
+
+<p align="center">
+	iOS app for emergency and critical alerts with clear severity states,
+	quick triage, and secure session-aware access.
+</p>
+
+## Highlights
+
+- Fast notification feed with unread/read sections
+- Auto-mark as read on open with consistent UI state
+- Severity-driven icon and color mapping from `metadata.severity`
+- Auth flow with login, register, and email verification
+- Account settings: sessions and password management
+
+## Tech
+
+- SwiftUI
+- MVVM
+- Async/await networking
+- Keychain-backed auth token storage
+
+## Run
+
+1. Open `Mayday.xcodeproj` in Xcode
+2. Select the `Mayday` scheme
+3. Build and run on simulator or device
+
+## Project
+
+- App source: `Mayday/`
+- Live Activity target: `MaydayLiveActivity/`
+
+## Icon Attribution
+
+Icon from [lucide.dev](https://lucide.dev), released under the ISC License.
+
+Copyright (c) 2026 Lucide Contributors