Implement daily study reminders and enhance settings functionality. Added support for configuring reminder time and enabling/disabling notifications. Updated database schema to store reminder settings and adjusted UI components for better user experience. Bump version to 2.0.1.

Author: MacBoy2828

.cursor/rules/commit-messages.mdc

@@ -0,0 +1,14 @@
+---
+description: Commit messages must be meaningful to end users
+alwaysApply: true
+---
+
+# Commit messages for users
+
+Write commit messages for people who read GitHub release notes and history—not for developers only.
+
+- Prefer clear, user-facing language: what changed for someone using Canal Study.
+- Good: `Keep the keyboard open after adding a card` / `Fix language switching on the Study tab` / `Add daily study reminders`
+- Avoid opaque machine style when a plain sentence works: no bare `fix`, `wip`, or unexplained `chore:` unless the change is truly internal (CI-only, deps with no user impact).
+- For releases, use something like `Release Canal Study v2.0.2` plus notes that list user-visible changes.
+- Release notes are generated from commits between tags—assume every commit may appear in a GitHub Release.

.cursor/rules/public-github-release.mdc

@@ -20,3 +20,5 @@ When the user asks to finish public-repo polish, do the following:
 - Prefer GitHub Actions workflow `.github/workflows/release-apk.yml` (**Release Android APK**) to bump, build `Canal-Study.apk`, and publish a GitHub Release
 - Release tags must be semver (`v1.2.0`); APK asset name must remain `Canal-Study.apk` for in-app updates
 - `expo.extra.updates.githubOwner` / `githubRepo` must match this repository
+- When running the workflow, fill the optional **notes** input with short user-facing release notes; GitHub also appends auto-generated notes from commits
+- Commit messages must follow `.cursor/rules/commit-messages.mdc` so auto release notes stay readable

.github/workflows/release-apk.yml

@@ -14,6 +14,11 @@ on:
           - major
           - none
         # "none" = keep current app.json version (already bumped locally)
+      notes:
+        description: Optional release notes for users (shown on the GitHub Release page). Leave blank to use auto notes from commits.
+        required: false
+        type: string
+        default: ''
 
 concurrency:
   group: release-android
@@ -46,7 +51,7 @@ jobs:
           java-version: 17
 
       - name: Setup Android SDK
-        uses: android-actions/setup-android@v3
+        uses: android-actions/setup-android@v4
 
       - name: Accept Android licenses
         run: yes | sdkmanager --licenses >/dev/null || true
@@ -86,13 +91,28 @@ jobs:
           cp android/app/build/outputs/apk/release/app-release.apk dist/Canal-Study.apk
           ls -lh dist/Canal-Study.apk
 
+      - name: Write release notes file
+        env:
+          MANUAL_NOTES: ${{ inputs.notes }}
+        run: |
+          {
+            if [ -n "$MANUAL_NOTES" ]; then
+              printf '%s\n\n' "$MANUAL_NOTES"
+            fi
+            echo "### Install"
+            echo "Download **Canal-Study.apk** below and install it on your Android device."
+            echo ""
+            echo "Version **${{ steps.meta.outputs.version }}** (versionCode ${{ steps.meta.outputs.version_code }})."
+          } > dist/release-notes.md
+          cat dist/release-notes.md
+
       - name: Commit version bump and create tag
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git add app.json package.json
           if ! git diff --cached --quiet; then
-            git commit -m "chore: release v${{ steps.meta.outputs.version }}"
+            git commit -m "Release Canal Study v${{ steps.meta.outputs.version }}"
             git push origin HEAD:${{ github.ref_name }}
           fi
           if git rev-parse "${{ steps.meta.outputs.tag }}" >/dev/null 2>&1; then
@@ -103,10 +123,11 @@ jobs:
           fi
 
       - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           tag_name: ${{ steps.meta.outputs.tag }}
           name: Canal Study ${{ steps.meta.outputs.tag }}
+          body_path: dist/release-notes.md
           generate_release_notes: true
           files: dist/Canal-Study.apk
           fail_on_unmatched_files: true

app.json

@@ -42,7 +42,15 @@
       ],
       "expo-sqlite",
       "expo-font",
-      "expo-image"
+      "expo-image",
+      "@react-native-community/datetimepicker",
+      [
+        "expo-notifications",
+        {
+          "color": "#E36A2A",
+          "defaultChannel": "study-reminders"
+        }
+      ]
     ],
     "extra": {
       "updates": {

app/(tabs)/index.tsx

@@ -9,19 +9,19 @@ import { GradeButtons } from '@/src/components/GradeButtons';
 import { ScreenBackground } from '@/src/components/ScreenBackground';
 import { SwipeDeck } from '@/src/components/SwipeDeck';
 import { deckLabel } from '@/src/db/decks';
-import { useDecks } from '@/src/hooks/useDecks';
 import { useStudySession } from '@/src/hooks/useStudySession';
 import { colors, fonts, spacing } from '@/src/theme';
 
 export default function StudyScreen() {
-  const { decks, select } = useDecks();
   const {
     current,
     revealed,
     loading,
     poolSize,
     progressLabel,
     activeDeck,
+    decks,
+    select,
     reveal,
     grade,
   } = useStudySession();
@@ -78,7 +78,7 @@ export default function StudyScreen() {
         light
       />
       <Animated.View
-        key={current.card.id + current.mode}
+        key={current.card.id + current.mode + activeDeck.id}
         entering={FadeInDown.duration(320)}
         style={styles.stage}
       >

app/(tabs)/settings.tsx

@@ -3,12 +3,17 @@ import {
   Alert,
   FlatList,
   Linking,
+  Platform,
   Pressable,
   StyleSheet,
+  Switch,
   Text,
   TextInput,
   View,
 } from 'react-native';
+import DateTimePicker, {
+  type DateTimePickerEvent,
+} from '@react-native-community/datetimepicker';
 import * as Application from 'expo-application';
 import Constants from 'expo-constants';
 
@@ -17,6 +22,7 @@ import { ScreenBackground } from '@/src/components/ScreenBackground';
 import { Toast } from '@/src/components/Toast';
 import { deckLabel } from '@/src/db/decks';
 import { useDecks } from '@/src/hooks/useDecks';
+import { useStudyReminder } from '@/src/hooks/useStudyReminder';
 import { colors, fonts, radius, spacing } from '@/src/theme';
 import { useUpdate } from '@/src/updates/UpdateProvider';
 
@@ -33,11 +39,14 @@ export default function SettingsScreen() {
     setDisplayLimit,
   } = useDecks();
   const { checkForUpdate, localVersion, status } = useUpdate();
+  const reminder = useStudyReminder();
   const [limitValue, setLimitValue] = useState(String(displayLimit));
   const [sourceLanguage, setSourceLanguage] = useState('');
   const [destinationLanguage, setDestinationLanguage] = useState('');
   const [toast, setToast] = useState<string | null>(null);
   const [limitSaved, setLimitSaved] = useState(false);
+  const [showTimePicker, setShowTimePicker] = useState(false);
+  const [draftTime, setDraftTime] = useState<Date | null>(null);
 
   const buildNumber =
     Application.nativeBuildVersion ??
@@ -85,6 +94,78 @@ export default function SettingsScreen() {
     void Linking.openURL(GITHUB_REPO_URL);
   };
 
+  const showPermissionHelp = () => {
+    Alert.alert(
+      'Notifications needed',
+      'Allow notifications for Canal Study in system settings to get daily study reminders.',
+      [
+        { text: 'Not now', style: 'cancel' },
+        {
+          text: 'Open settings',
+          onPress: () => void Linking.openSettings(),
+        },
+      ]
+    );
+  };
+
+  const onToggleReminder = async (next: boolean) => {
+    const result = await reminder.setEnabled(next);
+    if (!result.ok && result.reason === 'permission') {
+      showPermissionHelp();
+      return;
+    }
+    setToast(
+      next
+        ? `Daily reminder set for ${reminder.timeLabel}`
+        : 'Daily reminder turned off'
+    );
+  };
+
+  const onReminderTimeChange = (
+    event: DateTimePickerEvent,
+    date?: Date
+  ) => {
+    if (Platform.OS === 'android') {
+      setShowTimePicker(false);
+      if (event.type !== 'set' || !date) return;
+      void applyReminderTime(date);
+      return;
+    }
+    if (date) setDraftTime(date);
+  };
+
+  const applyReminderTime = async (date: Date) => {
+    const result = await reminder.setTime(date.getHours(), date.getMinutes());
+    if (!result.ok && result.reason === 'permission') {
+      showPermissionHelp();
+      return;
+    }
+    const label = `${String(date.getHours()).padStart(2, '0')}:${String(date.getMinutes()).padStart(2, '0')}`;
+    setToast(`Reminder time set to ${label}`);
+  };
+
+  const openTimePicker = () => {
+    const date = new Date();
+    date.setHours(reminder.hour, reminder.minute, 0, 0);
+    setDraftTime(date);
+    setShowTimePicker(true);
+  };
+
+  const confirmIosTime = async () => {
+    setShowTimePicker(false);
+    if (draftTime) {
+      await applyReminderTime(draftTime);
+    }
+  };
+
+  const reminderPickerDate =
+    draftTime ??
+    (() => {
+      const date = new Date();
+      date.setHours(reminder.hour, reminder.minute, 0, 0);
+      return date;
+    })();
+
   const checking = status === 'checking' || status === 'downloading';
 
   return (
@@ -158,7 +239,9 @@ export default function SettingsScreen() {
               <Text style={styles.title}>Display limit</Text>
               <Text style={styles.copy}>
                 After a card is shown this many times in the active pair, it
-                moves to the archive.
+                moves to the archive. Raising the limit brings archived cards
+                back if they are still under it; lowering archives cards that
+                already meet the new limit.
               </Text>
               <TextInput
                 value={limitValue}
@@ -173,6 +256,56 @@ export default function SettingsScreen() {
               </Pressable>
             </View>
 
+            {Platform.OS !== 'web' ? (
+              <View style={styles.card}>
+                <Text style={styles.title}>Daily reminder</Text>
+                <Text style={styles.copy}>
+                  Get a local notification each day at the time you choose.
+                </Text>
+                <View style={styles.reminderRow}>
+                  <Text style={styles.reminderLabel}>Remind me to study</Text>
+                  <Switch
+                    value={reminder.enabled}
+                    onValueChange={(value) => void onToggleReminder(value)}
+                    disabled={reminder.loading || reminder.busy}
+                    trackColor={{
+                      false: colors.mistDeep,
+                      true: colors.orangeSoft,
+                    }}
+                    thumbColor={
+                      reminder.enabled ? colors.orange : colors.white
+                    }
+                  />
+                </View>
+                <Pressable
+                  onPress={openTimePicker}
+                  disabled={reminder.loading || reminder.busy}
+                  style={styles.secondaryButton}
+                >
+                  <Text style={styles.secondaryButtonText}>
+                    Reminder time · {reminder.timeLabel}
+                  </Text>
+                </Pressable>
+                {showTimePicker ? (
+                  <DateTimePicker
+                    value={reminderPickerDate}
+                    mode="time"
+                    is24Hour
+                    display={Platform.OS === 'ios' ? 'spinner' : 'default'}
+                    onChange={onReminderTimeChange}
+                  />
+                ) : null}
+                {Platform.OS === 'ios' && showTimePicker ? (
+                  <Pressable
+                    onPress={() => void confirmIosTime()}
+                    style={styles.button}
+                  >
+                    <Text style={styles.buttonText}>Done</Text>
+                  </Pressable>
+                ) : null}
+              </View>
+            ) : null}
+
             <Text style={styles.sectionTitle}>Your language pairs</Text>
             {decks.length === 0 ? (
               <Text style={styles.emptyPairs}>
@@ -294,6 +427,18 @@ const styles = StyleSheet.create({
     fontSize: 15,
     color: colors.ink,
   },
+  reminderRow: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    justifyContent: 'space-between',
+    gap: spacing.md,
+  },
+  reminderLabel: {
+    flex: 1,
+    fontFamily: fonts.bodySemi,
+    fontSize: 16,
+    color: colors.ink,
+  },
   sectionTitle: {
     fontFamily: fonts.display,
     fontSize: 22,

app/_layout.tsx

@@ -14,6 +14,7 @@ import { GestureHandlerRootView } from 'react-native-gesture-handler';
 import 'react-native-reanimated';
 
 import { initDatabase } from '@/src/db/schema';
+import { DecksProvider } from '@/src/hooks/useDecks';
 import { colors } from '@/src/theme';
 import { UpdateProvider } from '@/src/updates/UpdateProvider';
 
@@ -51,12 +52,14 @@ export default function RootLayout() {
   return (
     <GestureHandlerRootView style={{ flex: 1, backgroundColor: colors.mist }}>
       <SQLiteProvider databaseName="canal-study.db" onInit={initDatabase}>
-        <UpdateProvider>
-          <StatusBar style="dark" />
-          <Stack screenOptions={{ headerShown: false, contentStyle: { backgroundColor: colors.mist } }}>
-            <Stack.Screen name="(tabs)" />
-          </Stack>
-        </UpdateProvider>
+        <DecksProvider>
+          <UpdateProvider>
+            <StatusBar style="dark" />
+            <Stack screenOptions={{ headerShown: false, contentStyle: { backgroundColor: colors.mist } }}>
+              <Stack.Screen name="(tabs)" />
+            </Stack>
+          </UpdateProvider>
+        </DecksProvider>
       </SQLiteProvider>
     </GestureHandlerRootView>
   );