[FEAT] Custom in-app notifications for scheduled blocks

Open
#161 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
42/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
react-native, typescript
Domain
mobile

Research direction

Start by reading ROADMAP.md and issue #11 to understand the existing morning summary notification and how scheduled blocks are managed. Then trace where blocks are added, edited, deleted, cleared, and applied from templates, along with the settings entry point. Done means configurable local reminders are scheduled and canceled or rescheduled with block changes, with the requested lead times and sound options.

Written by the indexing model from the issue text.

Description

enhancement

Is your feature request related to a problem? Please describe.

ClimbStack's primary goal is eliminating decision fatigue and preventing users from getting lost scrolling their phones during free time. While blocks can be scheduled in the planner, users who are distracted might miss the transition to their next block unless they rely on external calendar alerts.

Describe the solution you'd like

Add native local notifications for scheduled blocks via expo-notifications:

  1. Settings Configuration:
    • Master toggle: Enable/disable block start reminders.
    • Lead time setting: When to trigger the notification (e.g., "At start", "5 minutes before", "10 minutes before", "15 minutes before").
    • Sound option: Normal sound or silent / vibration only.
  2. Scheduling Engine:
    • Automatically schedule local notifications when blocks are added or applied from a template.
    • Cancel/reschedule notifications when blocks are deleted, edited, or cleared.
    • Clean notification content (e.g., "⏰ Starting soon: Study OSTEP").

Describe alternatives you've considered

Relying solely on Google Calendar synchronization notifications, but not all users sync with external calendars, and local-first offline notifications ensure immediate reliability.

Additional Context

  • Distinct from #11 (which handles the morning summary notification).
  • Mentioned in ROADMAP.md backlog: "Native internal notifications/reminders for scheduled blocks (if Google Calendar isn't enough)".
  • AI Generation Disclosure: This issue description was generated by an AI agent (Gemini 3.1 Pro).
Dominant language
TypeScript
Stars
4
Forks
4
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from GiZano/LevelUp

All issues in GiZano/LevelUp

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.