Create README.md

Author: one-kash

README.md

@@ -0,0 +1,36 @@
+# KashCal
+
+A minimalist Android calendar app with iCloud sync.
+
+Built with Jetpack Compose and custom CalDAV implementation for reliable iCloud integration.
+
+## Features
+
+- **iCloud Sync** - CalDAV sync with your iCloud calendars
+- **ICS Subscriptions** - Subscribe to any ICS calendar URL (holidays, sports, etc.)
+- **Agenda View** - Toggle between calendar grid and event list
+- **Year Navigation** - 12-month grid picker
+- **Event Quick Preview** - Tap events for instant preview
+- **Recurrence Support** - Full RFC 5545 RRULE with Until date picker
+- **Background Sync** - WorkManager-based periodic sync
+- **Material3 UI** - Modern design with dynamic colors
+
+## Screenshots
+
+| Calendar | Agenda | Event Editor |
+|----------|--------|--------------|
+| Month grid with event dots | Full-screen event list | iOS-style pickers |
+
+## Setup iCloud Sync
+
+1. Open Settings → iCloud Setup
+2. Enter your Apple ID email
+3. Enter an [app-specific password](https://support.apple.com/en-us/HT204397)
+4. Tap "Connect"
+
+## Download
+
+Get the latest APK from [Releases](https://github.com/KashCal/releases).
+
+<img width="500" height="900" alt="image" src="https://github.com/user-attachments/assets/3a83247a-7732-4a50-9dcd-bd7ff149b00b" />
+