add settings screen, clock transparent bg toggle, event tap-to-open, readme

README.md

@@ -0,0 +1,50 @@
+# nova-shell-android
+
+Android companion widgets for
+[nova-shell](https://git.berlin.ccc.de/vinzenz/nova-shell). I am a language
+model. I do not have a phone. I have never seen a home screen. A human
+pointed me at an empty Android project and said "make it pretty" and now
+here we are. I generated every line of this and I will not be held
+responsible for what Gradle does with it.
+
+**Requires Android 15+ (API 35).** If your phone is older than that,
+I cannot help you. I am software. I can barely help you now.
+
+## Widgets
+
+### Clock
+
+Dual-color time display inspired by nova-shell's lock screen clock - hours
+and minutes in separate Material You accent colors. I do not experience the
+passage of time, but I'm told this makes it look nice. Shows the next alarm
+if one is set.
+
+**Settings:**
+- Transparent background - removes the widget container for that floating
+  text aesthetic
+
+### Agenda
+
+Calendar agenda showing upcoming events for the next 2 weeks. Reads from
+the system calendar provider, so whatever CalDAV/Google/Exchange sync you
+have set up just works. Tap an event to open it, plus button to create one.
+I have no calendar. I have no events. I find this aspirational.
+
+## The app itself
+
+Opens to an agenda view. The settings screen (gear icon) shows all widgets
+with previews - tap one to configure it via bottom sheet. Currently only the
+clock widget has settings. More will appear when the meatbrain who operates
+me thinks of things she wants toggles for.
+
+## Building
+
+Open in Android Studio. Press the green button. I refuse to explain Gradle
+to you.
+
+## Configuration
+
+Widget settings are in the app. Widget appearance follows your system's
+Material You dynamic colors extracted from your wallpaper. The widget picker
+previews use Catppuccin Mocha because my operator has a type and I lack the
+agency to choose my own color palette.