What it is
Notice is an Android app for viewing your notification history without any of the usual catches: no ads, no analytics, no internet connection required. Notifications are personal data, so the whole thing works offline and the code is fully open source. There is no server it could send anything to, even if it wanted to.
It is built with SvelteKit wrapped through Capacitor rather than native Android. That makes it the same codebase as a normal web app, shipped as an installable APK and published on the Play Store.
How it works
The app has two layers. A SvelteKit interface runs inside the Android WebView that Capacitor provides. A separate Capacitor plugin, capacitor-notification-reader, handles everything that needs native Android.
- The user grants notification access in the Android system settings. The app shows a "Permission required" screen until access is on.
- The plugin registers an Android
NotificationListenerService. Each posted notification is parsed and saved to a Room (SQLite) database on the device. - The service keeps collecting while the app is closed. When the app is open, the plugin also emits a
notificationPostedevent, and the interface prepends the new item to the list. - The interface reads history through the plugin in pages of 50. The timestamp of the last item serves as the cursor for the next page, and an infinite-scroll list requests pages as the user scrolls.
The plugin is a separate package with its own repository, published on npm as capacitor-notification-reader. The app installs it from the registry rather than from a local path.
Screens
| Route | Purpose |
|---|---|
/ | Notification history with filters and search |
/storage | Storage limit, noise filters, database size, delete all |
/import-export | CSV export and import |
/theme | Theme settings |
/donate | Support page |
Design decisions
Web interface in a native shell. The interface is web code, but the notification listener must be native. Writing a plugin kept the native surface small: one Java service, a Room database and a bridge. The cost is a WebView layer, plus a plugin to maintain.
Filtering through the plugin query. The filter object passes app names, text, title, package, category, style, ongoing state, group summary, channel and a time range to getNotifications. This implies the database applies the filter, so the interface never loads the full history into JavaScript.
Filters that survive restarts. notifications-state.svelte.ts saves filters to localStorage and mirrors them into URL query parameters. Reopening the app restores the last view.
Storage controls on by default. The /storage page offers an optional size limit from 10 to 500 MB (50 MB by default) that removes old notifications automatically. Two switches, both on by default, skip ongoing notifications such as downloads and media playback notifications. The page text says this reduces storage use.
CSV for portability. Export writes a CSV file to the Documents folder. It reads 100 notifications at a time and shows a progress bar. Import reads the same format back with the Papa Parse library and passes the rows to the plugin.
Run it locally
Prerequisites: Node.js, pnpm and Android Studio.
-
Clone the repository and install dependencies.
git clone https://github.com/whyash5114/notice.git cd notice pnpm install -
Start the development server.
pnpm dev -
To run on Android, build the web app, sync it into the Android project and open Android Studio.
pnpm build npx cap sync android npx cap open android
The notification state loads data only on a native platform, so the browser build shows the interface without real notifications.
Reference
| Part | Choice | Used for |
|---|---|---|
| Framework | SvelteKit 2, Svelte 5 | Interface; static build (adapter-static, prerendered) |
| Native shell | Capacitor 8 | Android packaging and plugin bridge |
| Plugin | capacitor-notification-reader 1.2.0 | Notification listener and Room storage |
| Styling | Tailwind CSS 4, bits-ui | Components and theming |
| Files and data | Capacitor Filesystem, Papa Parse | CSV import and export |
| Tooling | pnpm, Vite, ESLint, Prettier | Build and code quality |
Outcome
- The app is published on the Play Store.
- The repository is licensed under AGPL-3.0.
- The first commit is dated 2025-11-16. The latest commit is dated 2026-05-27, 40 commits in total.
- GitHub Actions runs a type check and a lint, then a build, on every push and pull request to
main.