Local Notifications

A local notification is a reminder the user schedules on their own device, no server involved, no FCM. Example: "remind me to drink water at 9am every day."

Only works on native (iOS and Android). Not available on web.

Implementation

Via MCP: ask your assistant "add local_reminders to my project". It runs add_feature for you. See Kasy MCP.

Run:
```
kasy add local_notifications
```
Done. The settings screen, persisted state, and translations already come ready (see what's included in Information).
To change the reminder text (and the Home → Features demo notification), without hand-editing an i18n file:
```
kasy notifications text
```
Via MCP: ask "change the reminder text to X" and the assistant runs set_notification_texts for you. See Kasy MCP.

Information

What comes ready

Settings screen (ReminderPage) accessible from onboarding and settings
- On/off toggle
- Type: Daily, Weekly, or Specific date
- Hour and minute picker
- For weekly: day-of-week selector
- For a specific date: DatePicker + TimePicker
State persisted in SharedPreferences via ReminderNotifier
Translations in PT, EN, and ES

Available methods

On LocalNotifier:

Method	Use
`scheduleDailyAt(hour, minute)`	Every day at the same time
`scheduleWeekly(dayOfWeek, hour, minute)`	Same day of the week, same time
`scheduleAt(date)`	Exact date and time (one-off)
`cancel(notificationId)`	Cancel by ID
`cancelAll()`	Cancel all
`listPendingNotifications()`	See pending schedules

Difference from Push

	Push Notification	Local Notification
Who triggers it	Server	The device itself
Needs internet	Yes	No
Works with the app closed	Yes	Yes
Personalized per user	No (except deep link)	Yes (the user picks the time)
Web	No	No

Last updated on 08/02/2026