Settings shows the installed build version (CI-stamped versionName) — confirms which release Obtainium delivered

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

.gitea/workflows/release.yml

@@ -5,7 +5,36 @@ on:
     branches: [main]
 
 jobs:
+  check:
+    # Fast fail: lockfile sync, types, lint — catches in ~2 min what would
+    # otherwise kill the APK build twenty minutes in.
+    runs-on: desktop
+    container:
+      image: node:22
+    steps:
+      - name: Checkout
+        run: |
+          git init -q .
+          git fetch -q --depth 1 "https://git.rehbock.xyz/${{ github.repository }}.git" "${{ github.sha }}"
+          git checkout -q FETCH_HEAD
+      - name: Lockfile + typecheck + lint
+        run: |
+          cd app
+          npm ci --no-audit --no-fund
+          npx tsc --noEmit
+          npx eslint .
+      - name: Notify failure
+        if: failure()
+        env:
+          NTFY_TOKEN: ${{ secrets.NTFY_TOKEN }}
+        run: |
+          [ -n "$NTFY_TOKEN" ] || { echo "NTFY_TOKEN not set — skipping notification"; exit 0; }
+          curl -s -H "Authorization: Bearer $NTFY_TOKEN" -H "Title: gtd CI: check failed" -H "Priority: high" \
+            -d "typecheck/lint/lockfile failed at ${{ github.sha }} — https://git.rehbock.xyz/marcus/gtd/actions" \
+            https://ntfy.rehbock.xyz/gtd-ci
+
   build:
+    needs: check
     # RN/NDK builds starve the 4-core VPS — run on the desktop runner
     # (marcusDesktop). Jobs queue while the desktop is off and start when it
     # comes online; switch back to ubuntu-latest to build on the VPS.
@@ -28,14 +57,19 @@ jobs:
           node --version
 
       - name: Install Android SDK
+        # $HOME/android-sdk is a persistent runner volume — skip when warm.
         run: |
-          mkdir -p "$HOME/android-sdk/cmdline-tools"
-          curl -sLo /tmp/ct.zip https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip
-          unzip -q /tmp/ct.zip -d /tmp
-          mv /tmp/cmdline-tools "$HOME/android-sdk/cmdline-tools/latest"
-          yes | "$HOME/android-sdk/cmdline-tools/latest/bin/sdkmanager" --sdk_root="$HOME/android-sdk" --licenses >/dev/null 2>&1 || true
-          "$HOME/android-sdk/cmdline-tools/latest/bin/sdkmanager" --sdk_root="$HOME/android-sdk" \
-            "platform-tools" "platforms;android-36" "build-tools;36.0.0" >/dev/null
+          if [ ! -d "$HOME/android-sdk/platforms/android-36" ]; then
+            mkdir -p "$HOME/android-sdk/cmdline-tools"
+            curl -sLo /tmp/ct.zip https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip
+            unzip -q /tmp/ct.zip -d /tmp
+            mv /tmp/cmdline-tools "$HOME/android-sdk/cmdline-tools/latest"
+            yes | "$HOME/android-sdk/cmdline-tools/latest/bin/sdkmanager" --sdk_root="$HOME/android-sdk" --licenses >/dev/null 2>&1 || true
+            "$HOME/android-sdk/cmdline-tools/latest/bin/sdkmanager" --sdk_root="$HOME/android-sdk" \
+              "platform-tools" "platforms;android-36" "build-tools;36.0.0" >/dev/null
+          else
+            echo "SDK cache warm — skipping install"
+          fi
 
       - name: Install app dependencies
         run: cd app && npm ci --no-audit --no-fund
@@ -76,3 +110,13 @@ jobs:
             -H "Authorization: token $TOKEN" \
             -F "attachment=@$APK;type=application/vnd.android.package-archive" >/dev/null
           echo "published $TAG"
+
+      - name: Notify failure
+        if: failure()
+        env:
+          NTFY_TOKEN: ${{ secrets.NTFY_TOKEN }}
+        run: |
+          [ -n "$NTFY_TOKEN" ] || { echo "NTFY_TOKEN not set — skipping notification"; exit 0; }
+          curl -s -H "Authorization: Bearer $NTFY_TOKEN" -H "Title: gtd CI: APK build failed" -H "Priority: high" \
+            -d "release build failed at ${{ github.sha }} — https://git.rehbock.xyz/marcus/gtd/actions" \
+            https://ntfy.rehbock.xyz/gtd-ci

.githooks/pre-push

@@ -0,0 +1,12 @@
+#!/bin/sh
+# Reject pushes whose lockfile CI's npm (node 22) would refuse — a lock
+# written by a newer local npm fails `npm ci` on the runner half a build in.
+# Enable with: git config core.hooksPath .githooks
+set -e
+root=$(git rev-parse --show-toplevel)
+if git diff --quiet origin/main...HEAD -- app/package.json app/package-lock.json 2>/dev/null; then
+  exit 0
+fi
+echo "pre-push: package.json/lock changed — validating with CI's npm (node:22)…"
+docker run --rm -v "$root/app:/w" -w /w node:22 npm ci --dry-run --no-audit --no-fund >/dev/null
+echo "pre-push: lockfile OK"

README.md

@@ -9,7 +9,11 @@ Minimal Getting Things Done app. One Expo/React Native codebase for iPhone, Andr
 
 ## Layout
 
-- `app/` — Expo app (expo-router, TypeScript). Tabs: Inbox / Next / Waiting / Someday / Projects; tap a task to clarify (list, project, context, waiting-for, due/defer dates).
+- `app/` — Expo app (expo-router, TypeScript). Home shows the top 3 next actions plus a launcher menu: Today / Next / Waiting / Someday / Projects / Review. There is no inbox — every task is born fully scoped (title, priority, due date). Tap a task to clarify (list, project, context, waiting-for, due/defer dates, repeat).
+  - **Quick add**: the title field parses tokens live — `Pay rent tmr p1 @home #Sydney ~30m monthly` — and mirrors them into the form.
+  - **Repeat**: daily / weekdays / weekly / monthly / yearly; completing spawns the next occurrence (lapsed tasks catch up to today).
+  - **Defer**: deferred tasks are hidden from action lists until their date; a footer link reveals them.
+  - **Weekly review**: overdue, stalled (14d), aging waiting-fors (7d), someday sweep, deferred preview, stuck projects — with one-tap triage per row. Done and Trash (restorable) live at the bottom of Review.
 - `server/` — Bun API + Dockerfile + compose. Deployed at `~/personal/gtd` on rehbock.xyz, joined to `personal-db_default` + `caddy_net`.
 
 ## Develop
@@ -18,6 +22,15 @@ Minimal Getting Things Done app. One Expo/React Native codebase for iPhone, Andr
 cd app && npx expo start        # scan QR with Expo Go (iPhone or Pixel)
 ```
 
+- **Node 22 only** (`app/.nvmrc`): CI's npm 10 rejects lockfiles written by newer npm. Never run bare `npm install` to change deps — use `npm run lock` (regenerates the lock via a `node:22` container), or run npm from node 22.
+- **Hook**: `git config core.hooksPath .githooks` enables a pre-push check that validates the lockfile against CI's npm before it can break a build.
+- **Local Android builds** need JDK 21 (AGP chokes on newer): pinned via `org.gradle.java.home` in `~/.gradle/gradle.properties` → `~/.local/share/java/jdk-21.0.12+8`.
+- **`expo prebuild` is safe to re-run**: `app/plugins/withAndroidRelease.js` re-injects the release signing, env-driven versionCode/Name, and gradle.properties tuning into the committed `android/`.
+
+## Release (Android APK → Obtainium)
+
+Every push to `main` runs `.gitea/workflows/release.yml` on the desktop runner: fast check job (lockfile/types/lint), then a signed `assembleRelease`, published as Gitea release `v1.<run>` with the APK attached. Phones track it with Obtainium → source `https://git.rehbock.xyz/marcus/gtd` (Forgejo/Gitea source type). CI failures push to ntfy topic `gtd-ci` when the `NTFY_TOKEN` repo secret is set.
+
 ## Deploy
 
 ```sh

app/.nvmrc

@@ -0,0 +1 @@
+22

app/android/app/src/main/AndroidManifest.xml

@@ -16,6 +16,7 @@
     <meta-data android:name="expo.modules.updates.ENABLE_BSDIFF_PATCH_SUPPORT" android:value="true"/>
     <meta-data android:name="expo.modules.updates.EXPO_UPDATES_CHECK_ON_LAUNCH" android:value="ALWAYS"/>
     <meta-data android:name="expo.modules.updates.EXPO_UPDATES_LAUNCH_WAIT_MS" android:value="0"/>
+    <service android:name="com.reactnativeandroidwidget.RNWidgetCollectionService" android:permission="android.permission.BIND_REMOTEVIEWS"/>
     <activity android:name=".MainActivity" android:configChanges="keyboard|keyboardHidden|orientation|screenSize|screenLayout|uiMode|smallestScreenSize|assetsPaths" android:launchMode="singleTask" android:windowSoftInputMode="adjustResize" android:theme="@style/Theme.App.SplashScreen" android:exported="true" android:screenOrientation="portrait">
       <intent-filter>
         <action android:name="android.intent.action.MAIN"/>
@@ -28,5 +29,12 @@
         <data android:scheme="gtd"/>
       </intent-filter>
     </activity>
+    <receiver android:name=".widget.NextUp" android:exported="false" android:label="GTD — Next up">
+      <intent-filter>
+        <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
+        <action android:name="com.marcus.gtd.WIDGET_CLICK"/>
+      </intent-filter>
+      <meta-data android:name="android.appwidget.provider" android:resource="@xml/widgetprovider_nextup"/>
+    </receiver>
   </application>
 </manifest>

app/android/app/src/main/java/com/marcus/gtd/widget/NextUp.java

@@ -0,0 +1,6 @@
+package com.marcus.gtd.widget;
+
+import com.reactnativeandroidwidget.RNWidgetProvider;
+
+public class NextUp extends RNWidgetProvider {
+}

app/android/app/src/main/res/values/strings.xml

@@ -2,4 +2,5 @@
   <string name="app_name">GTD</string>
   <string name="expo_system_ui_user_interface_style" translatable="false">automatic</string>
   <string name="expo_splash_screen_resize_mode" translatable="false">contain</string>
+  <string name="widget_nextup_description" translatable="false">Your top three next actions</string>
 </resources>

app/android/app/src/main/res/xml/widgetprovider_nextup.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+    android:minWidth="250dp"
+    android:minHeight="110dp"
+    android:targetCellWidth="4"
+    android:targetCellHeight="2"
+
+
+
+    android:resizeMode="horizontal|vertical"
+
+    android:description="@string/widget_nextup_description"
+
+    android:initialLayout="@layout/rn_widget"
+
+
+
+
+    android:updatePeriodMillis="1800000"
+    android:widgetCategory="home_screen">
+</appwidget-provider>

app/android/gradle.properties

@@ -10,7 +10,7 @@
 # Specifies the JVM arguments used for the daemon process.
 # The setting is particularly useful for tweaking memory settings.
 # Default value: -Xmx512m -XX:MaxMetaspaceSize=256m
-org.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=512m
+org.gradle.jvmargs=-Xmx8192m -XX:MaxMetaspaceSize=1024m
 
 # When configured, Gradle will run in incubating parallel mode.
 # This option should only be used with decoupled projects. More details, visit
@@ -28,7 +28,7 @@ android.enablePngCrunchInReleaseBuilds=true
 # Use this property to specify which architecture you want to build.
 # You can also override it from the CLI using
 # ./gradlew <task> -PreactNativeArchitectures=x86_64
-reactNativeArchitectures=armeabi-v7a,arm64-v8a,x86,x86_64
+reactNativeArchitectures=arm64-v8a
 
 # Use this property to enable support to the new architecture.
 # This will allow you to use TurboModules and the Fabric render in

app/app.json

@@ -25,7 +25,26 @@
       "favicon": "./assets/images/favicon.png"
     },
     "plugins": [
+      "./plugins/withAndroidRelease",
       "expo-router",
+      [
+        "react-native-android-widget",
+        {
+          "widgets": [
+            {
+              "name": "NextUp",
+              "label": "GTD — Next up",
+              "description": "Your top three next actions",
+              "minWidth": "250dp",
+              "minHeight": "110dp",
+              "targetCellWidth": 4,
+              "targetCellHeight": 2,
+              "resizeMode": "horizontal|vertical",
+              "updatePeriodMillis": 1800000
+            }
+          ]
+        }
+      ],
       [
         "expo-splash-screen",
         {

app/eslint.config.js

@@ -0,0 +1,10 @@
+// https://docs.expo.dev/guides/using-eslint/
+const { defineConfig } = require('eslint/config');
+const expoConfig = require("eslint-config-expo/flat");
+
+module.exports = defineConfig([
+  expoConfig,
+  {
+    ignores: ["dist/*"],
+  }
+]);

app/index.js

@@ -0,0 +1,10 @@
+// Custom entry: register the widget's headless task handler before the app
+// starts, so widget events work even when the app UI never mounts.
+import "expo-router/entry";
+import { Platform } from "react-native";
+import { registerWidgetTaskHandler } from "react-native-android-widget";
+import { widgetTaskHandler } from "./src/widget/widget-task-handler";
+
+if (Platform.OS === "android") {
+  registerWidgetTaskHandler(widgetTaskHandler);
+}

app/package.json

@@ -1,15 +1,19 @@
 {
   "name": "app",
-  "main": "expo-router/entry",
+  "main": "index.js",
   "version": "1.0.0",
   "dependencies": {
     "@expo/ui": "~57.0.9",
     "@react-native-async-storage/async-storage": "2.2.0",
+    "@react-native-community/netinfo": "12.0.1",
     "expo": "~57.0.11",
+    "expo-application": "~57.0.2",
     "expo-constants": "~57.0.9",
+    "expo-crypto": "~57.0.1",
     "expo-device": "~57.0.1",
     "expo-font": "~57.0.1",
     "expo-glass-effect": "~57.0.1",
+    "expo-haptics": "~57.0.1",
     "expo-image": "~57.0.2",
     "expo-linking": "~57.0.5",
     "expo-router": "~57.0.11",
@@ -21,6 +25,8 @@
     "react": "19.2.3",
     "react-dom": "19.2.3",
     "react-native": "0.86.2",
+    "react-native-android-widget": "^0.22.1",
+    "react-native-draggable-flatlist": "^4.0.3",
     "react-native-gesture-handler": "~2.32.0",
     "react-native-reanimated": "4.5.1",
     "react-native-safe-area-context": "~5.7.0",
@@ -30,9 +36,15 @@
   },
   "devDependencies": {
     "@types/react": "~19.2.2",
+    "eslint": "^9.0.0",
+    "eslint-config-expo": "~57.0.1",
     "typescript": "~6.0.3"
   },
+  "engines": {
+    "node": "22.x"
+  },
   "scripts": {
+    "lock": "docker run --rm -v $PWD:/w -w /w node:22 npm install --package-lock-only --no-audit --no-fund",
     "start": "expo start",
     "reset-project": "node ./scripts/reset-project.js",
     "android": "expo run:android",

app/plugins/withAndroidRelease.js

@@ -0,0 +1,59 @@
+// Makes `expo prebuild` safe to re-run: re-applies the hand-maintained Android
+// release config that a fresh prebuild would otherwise reset to template
+// defaults (android/ is committed; CI builds it and relies on all of this).
+const { withAppBuildGradle, withGradleProperties } = require("expo/config-plugins");
+
+const RELEASE_SIGNING = `        release {
+            // Keystore path + password come from env (CI) or ~/.android-keys (local).
+            def ksPath = System.getenv("KEYSTORE_FILE") ?: "\${System.properties['user.home']}/.android-keys/gtd-release.jks"
+            def passFile = new File("\${System.properties['user.home']}/.android-keys/gtd-release.password")
+            def ksPass = System.getenv("KEYSTORE_PASSWORD") ?: (passFile.exists() ? passFile.text.trim() : null)
+            if (new File(ksPath).exists() && ksPass != null) {
+                storeFile file(ksPath)
+                storePassword ksPass
+                keyAlias System.getenv("KEY_ALIAS") ?: "gtd"
+                keyPassword System.getenv("KEY_PASSWORD") ?: ksPass
+            }
+        }
+`;
+
+function patchBuildGradle(gradle) {
+  gradle = gradle.replace(/versionCode \d+\n/, 'versionCode ((System.getenv("VERSION_CODE") ?: "1").toInteger())\n');
+  gradle = gradle.replace(/versionName "[^"]*"\n/, 'versionName (System.getenv("VERSION_NAME") ?: "1.0-dev")\n');
+  if (!gradle.includes("KEYSTORE_FILE")) {
+    // Insert the release signing config right after the debug one.
+    gradle = gradle.replace(
+      /(signingConfigs \{\n        debug \{[\s\S]*?\n        \}\n)/,
+      `$1${RELEASE_SIGNING}`,
+    );
+  }
+  // Release builds use the release key when present, debug key otherwise.
+  gradle = gradle.replace(
+    /(release \{\n)(?:\s*\/\/[^\n]*\n)*\s*signingConfig signingConfigs\.debug\n/,
+    "$1            signingConfig signingConfigs.release.storeFile ? signingConfigs.release : signingConfigs.debug\n",
+  );
+  return gradle;
+}
+
+const GRADLE_PROPS = [
+  // RN/NDK builds want headroom; the template default is 2 GB.
+  { key: "org.gradle.jvmargs", value: "-Xmx8192m -XX:MaxMetaspaceSize=1024m" },
+  // arm64 only: Pixel is arm64-v8a; x86/v7a builds are wasted time + APK bloat.
+  { key: "reactNativeArchitectures", value: "arm64-v8a" },
+];
+
+module.exports = function withAndroidRelease(config) {
+  config = withAppBuildGradle(config, (c) => {
+    c.modResults.contents = patchBuildGradle(c.modResults.contents);
+    return c;
+  });
+  config = withGradleProperties(config, (c) => {
+    for (const { key, value } of GRADLE_PROPS) {
+      const existing = c.modResults.find((p) => p.type === "property" && p.key === key);
+      if (existing) existing.value = value;
+      else c.modResults.push({ type: "property", key, value });
+    }
+    return c;
+  });
+  return config;
+};

app/src/app/(tabs)/_layout.tsx

@@ -1,36 +0,0 @@
-import { Link, Tabs } from "expo-router";
-import { Text } from "react-native";
-import { C } from "../../lib/theme";
-
-function icon(glyph: string) {
-  return ({ focused }: { focused: boolean }) => (
-    <Text style={{ fontSize: 20, opacity: focused ? 1 : 0.45 }}>{glyph}</Text>
-  );
-}
-
-export default function TabsLayout() {
-  return (
-    <Tabs
-      screenOptions={{
-        headerStyle: { backgroundColor: C.bg },
-        headerTintColor: C.text,
-        headerShadowVisible: false,
-        sceneStyle: { backgroundColor: C.bg },
-        tabBarStyle: { backgroundColor: C.bg, borderTopColor: C.border },
-        tabBarActiveTintColor: C.text,
-        tabBarInactiveTintColor: C.muted,
-        headerRight: () => (
-          <Link href="/settings" style={{ paddingHorizontal: 16, fontSize: 18 }}>
-            ⚙️
-          </Link>
-        ),
-      }}
-    >
-      <Tabs.Screen name="index" options={{ title: "Inbox", tabBarIcon: icon("📥") }} />
-      <Tabs.Screen name="next" options={{ title: "Next", tabBarIcon: icon("▶️") }} />
-      <Tabs.Screen name="waiting" options={{ title: "Waiting", tabBarIcon: icon("⏳") }} />
-      <Tabs.Screen name="someday" options={{ title: "Someday", tabBarIcon: icon("💭") }} />
-      <Tabs.Screen name="projects" options={{ title: "Projects", tabBarIcon: icon("📁") }} />
-    </Tabs>
-  );
-}

app/src/app/(tabs)/index.tsx

@@ -1,5 +0,0 @@
-import TaskListScreen from "../../components/TaskListScreen";
-
-export default function Inbox() {
-  return <TaskListScreen status="inbox" capture emptyHint="Inbox zero. Capture anything above." />;
-}

app/src/app/(tabs)/next.tsx

@@ -1,5 +0,0 @@
-import TaskListScreen from "../../components/TaskListScreen";
-
-export default function Next() {
-  return <TaskListScreen status="next" capture emptyHint="No next actions. Clarify your inbox." />;
-}

app/src/app/(tabs)/someday.tsx

@@ -1,5 +0,0 @@
-import TaskListScreen from "../../components/TaskListScreen";
-
-export default function Someday() {
-  return <TaskListScreen status="someday" emptyHint="No someday/maybe items." />;
-}

app/src/app/(tabs)/waiting.tsx

@@ -1,5 +0,0 @@
-import TaskListScreen from "../../components/TaskListScreen";
-
-export default function Waiting() {
-  return <TaskListScreen status="waiting" emptyHint="Not waiting on anyone." />;
-}

app/src/app/_layout.tsx

@@ -1,10 +1,40 @@
-import { Stack } from "expo-router";
+import NetInfo from "@react-native-community/netinfo";
+import { Link, Stack } from "expo-router";
 import { StatusBar } from "expo-status-bar";
+import { useEffect } from "react";
+import { AppState } from "react-native";
+import { GestureHandlerRootView } from "react-native-gesture-handler";
+import { getState, hydrate, subscribe, sync } from "../lib/store";
 import { C } from "../lib/theme";
+import { refreshNextUpWidget } from "../widget/refresh";
 
 export default function RootLayout() {
+  useEffect(() => {
+    void hydrate();
+    // Re-sync whenever the app returns to the foreground.
+    const appState = AppState.addEventListener("change", (s) => {
+      if (s === "active") void sync();
+    });
+    // Drain the queue the moment connectivity returns (wifi/cellular).
+    const net = NetInfo.addEventListener((s) => {
+      if (s.isConnected) void sync();
+    });
+    // Keep the home-screen widget in step with every mutation and sync.
+    const widget = subscribe(refreshNextUpWidget);
+    // Slow heartbeat as a belt-and-braces retry while changes are queued.
+    const heartbeat = setInterval(() => {
+      if (getState().pending > 0 || getState().offline) void sync();
+    }, 45_000);
+    return () => {
+      appState.remove();
+      net();
+      widget();
+      clearInterval(heartbeat);
+    };
+  }, []);
+
   return (
-    <>
+    <GestureHandlerRootView style={{ flex: 1 }}>
       <StatusBar style="light" />
       <Stack
         screenOptions={{
@@ -14,11 +44,26 @@ export default function RootLayout() {
           contentStyle: { backgroundColor: C.bg },
         }}
       >
-        <Stack.Screen name="(tabs)" options={{ headerShown: false }} />
+        <Stack.Screen
+          name="index"
+          options={{
+            title: "GTD",
+            headerRight: () => (
+              <Link href="/settings" style={{ paddingHorizontal: 8, fontSize: 18 }}>
+                ⚙️
+              </Link>
+            ),
+          }}
+        />
+        <Stack.Screen name="list/[status]" />
+        <Stack.Screen name="today" options={{ title: "Today" }} />
+        <Stack.Screen name="add" options={{ title: "New task", presentation: "modal" }} />
+        <Stack.Screen name="projects" options={{ title: "Projects" }} />
         <Stack.Screen name="task/[id]" options={{ title: "Clarify", presentation: "modal" }} />
         <Stack.Screen name="project/[id]" options={{ title: "Project" }} />
+        <Stack.Screen name="review" options={{ title: "Weekly review" }} />
         <Stack.Screen name="settings" options={{ title: "Settings", presentation: "modal" }} />
       </Stack>
-    </>
+    </GestureHandlerRootView>
   );
 }

app/src/app/add.tsx

@@ -0,0 +1,160 @@
+import { useRouter } from "expo-router";
+import { useRef, useState } from "react";
+import { Pressable, ScrollView, StyleSheet, Text } from "react-native";
+import DateField from "../components/DateField";
+import EstimateChips from "../components/EstimateChips";
+import PriorityChips from "../components/PriorityChips";
+import { Chips, Field } from "../components/ui";
+import { haptic } from "../lib/haptics";
+import { parseQuickAdd, type ParsedQuickAdd } from "../lib/quickadd";
+import { REPEAT_LABEL, REPEATS } from "../lib/repeat";
+import { activeProjects, createTask } from "../lib/store";
+import { C } from "../lib/theme";
+import { useStore } from "../lib/useStore";
+import type { Repeat, Task, TaskStatus } from "../lib/types";
+
+const BOXES: { key: TaskStatus; label: string }[] = [
+  { key: "next", label: "Next up" },
+  { key: "waiting", label: "Waiting" },
+  { key: "someday", label: "Someday" },
+];
+
+export default function AddTask() {
+  const router = useRouter();
+  const store = useStore();
+  const [raw, setRaw] = useState("");
+  const [notes, setNotes] = useState("");
+  const [priority, setPriority] = useState<Task["priority"] | null>(null);
+  const [estimate, setEstimate] = useState<number | null>(null);
+  const [due, setDue] = useState("");
+  const [repeat, setRepeat] = useState<Repeat | null>(null);
+  const [box, setBox] = useState<TaskStatus>("next");
+  const [waitingFor, setWaitingFor] = useState("");
+  const [projectId, setProjectId] = useState<string | null>(null);
+  const [context, setContext] = useState<string | null>(null);
+
+  const projects = activeProjects(store).filter((p) => p.status === "active");
+  const projectOptions = ["none", ...projects.map((p) => p.id)];
+  const projectLabels = Object.fromEntries([["none", "None"], ...projects.map((p) => [p.id, p.name])]);
+
+  // The title field understands tokens ("Pay rent tmr p1 @home ~30m monthly")
+  // and mirrors each one into the form controls below as you type, so capture
+  // is one line but every inference stays visible and correctable. A token
+  // only writes its field when it changes — chips tapped by hand stick.
+  const prevParsed = useRef<ParsedQuickAdd>({ title: "" });
+  const onTitleChange = (text: string) => {
+    setRaw(text);
+    const p = parseQuickAdd(text, projects);
+    const prev = prevParsed.current;
+    if (p.priority !== prev.priority && p.priority) setPriority(p.priority);
+    if (p.due_date !== prev.due_date && p.due_date) setDue(p.due_date);
+    if (p.estimate_min !== prev.estimate_min && p.estimate_min) setEstimate(p.estimate_min);
+    if (p.repeat !== prev.repeat && p.repeat) setRepeat(p.repeat);
+    if (p.project_id !== prev.project_id && p.project_id) setProjectId(p.project_id);
+    if (p.context !== prev.context) setContext(p.context ?? null);
+    prevParsed.current = p;
+  };
+
+  const cleanTitle = parseQuickAdd(raw, projects).title.trim() || raw.trim();
+  const tokensUsed = raw.trim() !== cleanTitle;
+
+  // Every task must be born fully scoped: title + priority + due date.
+  const dueValid = /^\d{4}-\d{2}-\d{2}$/.test(due.trim());
+  const ready = cleanTitle.length > 0 && priority !== null && dueValid;
+
+  const save = () => {
+    if (!ready || priority === null) return;
+    createTask({
+      title: cleanTitle,
+      notes,
+      status: box,
+      priority,
+      estimate_min: estimate,
+      due_date: due.trim(),
+      repeat,
+      project_id: projectId,
+      context,
+      waiting_for: box === "waiting" ? waitingFor.trim() || null : null,
+    });
+    haptic.success();
+    router.back();
+  };
+
+  return (
+    <ScrollView style={{ flex: 1, backgroundColor: C.bg }} contentContainerStyle={{ padding: 16 }}>
+      <Field
+        label="Task"
+        value={raw}
+        onChangeText={onTitleChange}
+        placeholder="Pay rent tmr p1 @home ~30m"
+        autoFocus
+      />
+      {tokensUsed && (
+        <Text style={s.parsedHint}>
+          → {cleanTitle || "…"}
+          {context ? `  ·  ${context}` : ""}
+        </Text>
+      )}
+      <PriorityChips value={priority} onChange={setPriority} />
+      <DateField label="Due date" value={due || null} onChange={(v) => setDue(v ?? "")} />
+      <Chips
+        label="Repeat"
+        options={["none", ...REPEATS]}
+        labels={{ none: "None", ...REPEAT_LABEL }}
+        value={repeat ?? "none"}
+        onChange={(v) => {
+          haptic.select();
+          setRepeat(v === "none" ? null : (v as Repeat));
+        }}
+      />
+      <EstimateChips value={estimate} onChange={setEstimate} />
+      <Chips
+        label="Box"
+        options={BOXES.map((b) => b.key)}
+        labels={Object.fromEntries(BOXES.map((b) => [b.key, b.label]))}
+        value={box}
+        onChange={(b) => {
+          haptic.select();
+          setBox(b);
+        }}
+      />
+      {box === "waiting" && (
+        <Field label="Waiting for" value={waitingFor} onChangeText={setWaitingFor} placeholder="Who or what?" />
+      )}
+      <Chips
+        label="Project"
+        options={projectOptions}
+        labels={projectLabels}
+        value={projectId ?? "none"}
+        onChange={(v) => setProjectId(v === "none" ? null : v)}
+      />
+      <Field
+        label="Description"
+        value={notes}
+        onChangeText={setNotes}
+        placeholder="Details, links, notes…"
+        multiline
+        style={{ minHeight: 64, textAlignVertical: "top" }}
+      />
+      <Pressable style={[s.save, !ready && s.saveDisabled]} onPress={save} disabled={!ready}>
+        <Text style={[s.saveText, !ready && { color: C.muted }]}>
+          {ready ? "Add task" : "Needs a title, priority & due date"}
+        </Text>
+      </Pressable>
+    </ScrollView>
+  );
+}
+
+const s = StyleSheet.create({
+  parsedHint: { color: C.accent, fontSize: 13, marginTop: -8, marginBottom: 12 },
+  save: {
+    backgroundColor: C.accent,
+    borderRadius: 10,
+    padding: 14,
+    alignItems: "center",
+    marginTop: 8,
+    marginBottom: 24,
+  },
+  saveDisabled: { backgroundColor: C.surface },
+  saveText: { color: C.text, fontSize: 16, fontWeight: "600" },
+});

app/src/app/index.tsx

@@ -0,0 +1,127 @@
+import { useFocusEffect, useRouter } from "expo-router";
+import { Pressable, StyleSheet, Text, View } from "react-native";
+import TaskRow from "../components/TaskRow";
+import { haptic } from "../lib/haptics";
+import { daysSince, useLastReview } from "../lib/review";
+import { todayTasks, visibleTasksByStatus } from "../lib/store";
+import { C } from "../lib/theme";
+import { useStore } from "../lib/useStore";
+
+const MENU = [
+  { icon: "📅", label: "Today", href: "/today" },
+  { icon: "▶️", label: "Next", href: "/list/next" },
+  { icon: "⏳", label: "Waiting", href: "/list/waiting" },
+  { icon: "💭", label: "Someday", href: "/list/someday" },
+  { icon: "📁", label: "Projects", href: "/projects" },
+  { icon: "🔄", label: "Review", href: "/review" },
+] as const;
+
+export default function Home() {
+  const router = useRouter();
+  const store = useStore();
+  const next = visibleTasksByStatus(store, "next");
+  const { overdue } = todayTasks(store);
+  const [lastReview, reloadReview] = useLastReview();
+  useFocusEffect(reloadReview);
+  const reviewDays = daysSince(lastReview);
+  const reviewDue = lastReview === null || (reviewDays !== null && reviewDays >= 7);
+
+  return (
+    <View style={s.screen}>
+      <View style={{ flex: 1 }}>
+        <Text style={s.sectionTitle}>Next up</Text>
+        {next.slice(0, 3).map((t) => (
+          <TaskRow key={t.id} task={t} />
+        ))}
+        {next.length === 0 && <Text style={s.empty}>Nothing next. Tap ＋ to add.</Text>}
+        {next.length > 3 && (
+          <Pressable onPress={() => router.push("/list/next")}>
+            <Text style={s.viewAll}>all next actions ({next.length}) →</Text>
+          </Pressable>
+        )}
+        {overdue.length > 0 && (
+          <Pressable onPress={() => router.push("/today")}>
+            <Text style={s.overdue}>{overdue.length} overdue →</Text>
+          </Pressable>
+        )}
+        {reviewDue && (
+          <Pressable onPress={() => router.push("/review")}>
+            <Text style={s.reviewNudge}>
+              {lastReview === null ? "no review yet — start one →" : `review overdue (${reviewDays}d) →`}
+            </Text>
+          </Pressable>
+        )}
+        {store.offline && (
+          <Text style={s.offline}>
+            offline{store.pending > 0 ? ` — ${store.pending} change${store.pending === 1 ? "" : "s"} queued` : ""}
+          </Text>
+        )}
+        {store.syncError && <Text style={s.error}>{store.syncError}</Text>}
+      </View>
+      <View style={s.menu}>
+        {MENU.map((m) => (
+          <Pressable key={m.label} style={s.menuItem} onPress={() => router.push(m.href)}>
+            <Text style={s.menuIcon}>{m.icon}</Text>
+            <Text style={s.menuLabel}>{m.label}</Text>
+          </Pressable>
+        ))}
+      </View>
+      <Pressable
+        style={s.fab}
+        onPress={() => {
+          haptic.tap();
+          router.push("/add");
+        }}
+      >
+        <Text style={s.fabText}>＋</Text>
+      </Pressable>
+    </View>
+  );
+}
+
+const s = StyleSheet.create({
+  screen: { flex: 1, backgroundColor: C.bg },
+  sectionTitle: {
+    color: C.muted,
+    fontSize: 13,
+    textTransform: "uppercase",
+    letterSpacing: 1,
+    paddingHorizontal: 16,
+    paddingTop: 18,
+    paddingBottom: 6,
+  },
+  empty: { color: C.muted, textAlign: "center", marginTop: 48, fontSize: 15 },
+  viewAll: { color: C.muted, fontSize: 14, padding: 16 },
+  overdue: { color: C.danger, fontSize: 14, paddingHorizontal: 16, paddingBottom: 8 },
+  reviewNudge: { color: C.warn, fontSize: 14, paddingHorizontal: 16, paddingBottom: 8 },
+  error: { color: C.danger, paddingHorizontal: 16, paddingTop: 8 },
+  offline: { color: C.muted, fontSize: 13, paddingHorizontal: 16, paddingTop: 8 },
+  menu: {
+    flexDirection: "row",
+    borderTopWidth: StyleSheet.hairlineWidth,
+    borderTopColor: C.border,
+    paddingTop: 10,
+    paddingBottom: 18,
+    backgroundColor: C.bg,
+  },
+  menuItem: { flex: 1, alignItems: "center", gap: 3 },
+  menuIcon: { fontSize: 20 },
+  menuLabel: { color: C.muted, fontSize: 11 },
+  fab: {
+    position: "absolute",
+    right: 20,
+    bottom: 92,
+    width: 58,
+    height: 58,
+    borderRadius: 29,
+    backgroundColor: C.accent,
+    alignItems: "center",
+    justifyContent: "center",
+    elevation: 6,
+    shadowColor: "#000",
+    shadowOpacity: 0.35,
+    shadowRadius: 8,
+    shadowOffset: { width: 0, height: 4 },
+  },
+  fabText: { color: "#FFFFFF", fontSize: 28, lineHeight: 32, fontWeight: "600" },
+});

app/src/app/list/[status].tsx

@@ -0,0 +1,30 @@
+import { Stack, useLocalSearchParams } from "expo-router";
+import TaskListScreen from "../../components/TaskListScreen";
+import type { TaskStatus } from "../../lib/types";
+
+const TITLES: Record<string, string> = {
+  next: "Next up",
+  waiting: "Waiting for",
+  someday: "Someday",
+  done: "Done",
+  trashed: "Trash",
+};
+
+const HINTS: Record<string, string> = {
+  next: "Nothing next. Tap ＋ on the home screen.",
+  waiting: "Not waiting on anyone.",
+  someday: "No someday/maybe items.",
+  done: "Nothing done yet.",
+  trashed: "Trash is empty.",
+};
+
+export default function ListByStatus() {
+  const { status } = useLocalSearchParams<{ status: string }>();
+  const st = (status in TITLES ? status : "next") as TaskStatus;
+  return (
+    <>
+      <Stack.Screen options={{ title: TITLES[st] }} />
+      <TaskListScreen status={st} emptyHint={HINTS[st]} />
+    </>
+  );
+}

app/src/app/project/[id].tsx

@@ -1,46 +1,32 @@
-import { Stack, useFocusEffect, useLocalSearchParams, useRouter } from "expo-router";
-import { useCallback, useState } from "react";
+import { Stack, useLocalSearchParams, useRouter } from "expo-router";
+import { useState } from "react";
 import { FlatList, Pressable, StyleSheet, Text, TextInput, View } from "react-native";
 import { Button, Chips } from "../../components/ui";
-import { api } from "../../lib/api";
+import { createTask, dropProject, updateProject, updateTask } from "../../lib/store";
 import { C } from "../../lib/theme";
-import type { Project, ProjectStatus, Task } from "../../lib/types";
+import { useStore } from "../../lib/useStore";
+import type { ProjectStatus } from "../../lib/types";
 
 const STATUSES: ProjectStatus[] = ["active", "someday", "completed"];
 
 export default function ProjectDetail() {
   const { id } = useLocalSearchParams<{ id: string }>();
   const router = useRouter();
-  const [project, setProject] = useState<Project | null>(null);
-  const [tasks, setTasks] = useState<Task[]>([]);
+  const store = useStore();
   const [draft, setDraft] = useState("");
 
-  const load = useCallback(async () => {
-    const [ps, ts] = await Promise.all([api.projects.list(), api.tasks.list({ project_id: id })]);
-    setProject(ps.find((p) => p.id === id) ?? null);
-    setTasks(ts.filter((t) => t.status !== "done"));
-  }, [id]);
+  const project = store.projects.find((p) => p.id === id);
+  if (!project) return <Text style={{ color: C.muted, margin: 16 }}>Project not found.</Text>;
 
-  useFocusEffect(
-    useCallback(() => {
-      load();
-    }, [load]),
-  );
+  const tasks = store.tasks
+    .filter((t) => t.project_id === id && t.status !== "done" && t.status !== "trashed")
+    .sort((a, b) => a.sort_order - b.sort_order || b.created_at.localeCompare(a.created_at));
 
-  if (!project) return <Text style={{ color: C.muted, margin: 16 }}>Loading…</Text>;
-
-  const add = async () => {
+  const add = () => {
     const title = draft.trim();
     if (!title) return;
     setDraft("");
-    await api.tasks.create({ title, status: "next", project_id: id });
-    load();
-  };
-
-  const complete = async (t: Task) => {
-    setTasks((cur) => cur.filter((x) => x.id !== t.id));
-    await api.tasks.update(t.id, { status: "done" });
-    load();
+    createTask({ title, status: "next", project_id: id });
   };
 
   return (
@@ -51,10 +37,7 @@ export default function ProjectDetail() {
           label="Status"
           options={STATUSES}
           value={project.status}
-          onChange={async (status) => {
-            setProject({ ...project, status });
-            await api.projects.update(project.id, { status });
-          }}
+          onChange={(status) => updateProject(project.id, { status })}
         />
       </View>
       <TextInput
@@ -64,6 +47,7 @@ export default function ProjectDetail() {
         value={draft}
         onChangeText={setDraft}
         onSubmitEditing={add}
+        submitBehavior="submit"
         returnKeyType="done"
       />
       <FlatList
@@ -71,7 +55,11 @@ export default function ProjectDetail() {
         keyExtractor={(t) => t.id}
         renderItem={({ item }) => (
           <Pressable style={s.row} onPress={() => router.push(`/task/${item.id}`)}>
-            <Pressable style={s.checkbox} hitSlop={10} onPress={() => complete(item)} />
+            <Pressable
+              style={s.checkbox}
+              hitSlop={10}
+              onPress={() => updateTask(item.id, { status: "done" })}
+            />
             <View style={{ flex: 1 }}>
               <Text style={s.title}>{item.title}</Text>
               <Text style={s.meta}>{[item.status, item.context].filter(Boolean).join("  ·  ")}</Text>
@@ -84,8 +72,8 @@ export default function ProjectDetail() {
         <Button
           title="Drop project"
           danger
-          onPress={async () => {
-            await api.projects.drop(project.id);
+          onPress={() => {
+            dropProject(project.id);
             router.back();
           }}
         />

app/src/app/projects.tsx

@@ -1,37 +1,21 @@
-import { useFocusEffect, useRouter } from "expo-router";
-import { useCallback, useState } from "react";
+import { useRouter } from "expo-router";
+import { useState } from "react";
 import { FlatList, Pressable, StyleSheet, Text, TextInput, View } from "react-native";
-import { api } from "../../lib/api";
-import { C } from "../../lib/theme";
-import type { Project } from "../../lib/types";
+import { activeProjects, createProject, openTaskCount } from "../lib/store";
+import { C } from "../lib/theme";
+import { useStore } from "../lib/useStore";
 
 export default function Projects() {
   const router = useRouter();
-  const [projects, setProjects] = useState<Project[]>([]);
+  const store = useStore();
   const [draft, setDraft] = useState("");
-  const [error, setError] = useState<string | null>(null);
+  const projects = activeProjects(store);
 
-  const load = useCallback(async () => {
-    try {
-      setProjects(await api.projects.list());
-      setError(null);
-    } catch (e) {
-      setError(e instanceof Error ? e.message : String(e));
-    }
-  }, []);
-
-  useFocusEffect(
-    useCallback(() => {
-      load();
-    }, [load]),
-  );
-
-  const add = async () => {
+  const add = () => {
     const name = draft.trim();
     if (!name) return;
     setDraft("");
-    await api.projects.create({ name });
-    load();
+    createProject({ name });
   };
 
   return (
@@ -45,7 +29,6 @@ export default function Projects() {
         onSubmitEditing={add}
         returnKeyType="done"
       />
-      {error && <Text style={s.error}>{error}</Text>}
       <FlatList
         data={projects}
         keyExtractor={(p) => p.id}
@@ -54,8 +37,7 @@ export default function Projects() {
             <View style={{ flex: 1 }}>
               <Text style={s.title}>{item.name}</Text>
               <Text style={s.meta}>
-                {item.status}
-                {item.open_tasks != null && `  ·  ${item.open_tasks} open`}
+                {item.status}  ·  {openTaskCount(store, item.id)} open
               </Text>
             </View>
             <Text style={{ color: C.muted }}>›</Text>
@@ -91,5 +73,4 @@ const s = StyleSheet.create({
   title: { color: C.text, fontSize: 16 },
   meta: { color: C.muted, fontSize: 13, marginTop: 2 },
   empty: { color: C.muted, textAlign: "center", marginTop: 48 },
-  error: { color: C.danger, marginHorizontal: 16, marginTop: 8 },
 });

app/src/app/review.tsx

@@ -0,0 +1,171 @@
+// Weekly review — GTD's keystone habit. One pass, one decision per row:
+// each row has exactly three quick actions (do next / someday / trash) plus
+// done on the checkbox, so nothing needs a trip through the edit modal.
+import { useRouter } from "expo-router";
+import { Pressable, ScrollView, StyleSheet, Text, View } from "react-native";
+import { Button } from "../components/ui";
+import { friendlyDate } from "../lib/dates";
+import { haptic } from "../lib/haptics";
+import { PRIORITY_COLOR } from "../lib/priority";
+import { daysSince, markReviewed, useLastReview } from "../lib/review";
+import { reviewBuckets, trashTask, updateTask } from "../lib/store";
+import { C } from "../lib/theme";
+import { useStore } from "../lib/useStore";
+import type { Task } from "../lib/types";
+
+function ReviewRow({ task, showDefer }: { task: Task; showDefer?: boolean }) {
+  const router = useRouter();
+  const act = (fn: () => void) => () => {
+    haptic.select();
+    fn();
+  };
+  return (
+    <View style={s.row}>
+      <Pressable
+        style={s.check}
+        hitSlop={8}
+        onPress={act(() => {
+          haptic.success();
+          updateTask(task.id, { status: "done" });
+        })}
+      >
+        <View style={[s.checkCircle, { borderColor: PRIORITY_COLOR[task.priority] }]} />
+      </Pressable>
+      <Pressable style={{ flex: 1 }} onPress={() => router.push(`/task/${task.id}`)}>
+        <Text style={s.title} numberOfLines={2}>
+          {task.title}
+        </Text>
+        <Text style={s.meta}>
+          {[
+            task.status,
+            task.waiting_for && `→ ${task.waiting_for}`,
+            showDefer && task.defer_date && `resurfaces ${friendlyDate(task.defer_date)}`,
+          ]
+            .filter(Boolean)
+            .join("  ·  ")}
+        </Text>
+      </Pressable>
+      {task.status !== "next" && (
+        <Pressable style={s.action} hitSlop={6} onPress={act(() => updateTask(task.id, { status: "next" }))}>
+          <Text style={s.actionText}>▶️</Text>
+        </Pressable>
+      )}
+      {task.status !== "someday" && (
+        <Pressable style={s.action} hitSlop={6} onPress={act(() => updateTask(task.id, { status: "someday" }))}>
+          <Text style={s.actionText}>💭</Text>
+        </Pressable>
+      )}
+      <Pressable style={s.action} hitSlop={6} onPress={act(() => trashTask(task.id))}>
+        <Text style={s.actionText}>🗑️</Text>
+      </Pressable>
+    </View>
+  );
+}
+
+function Section({ title, hint, tasks, showDefer }: { title: string; hint: string; tasks: Task[]; showDefer?: boolean }) {
+  if (tasks.length === 0) return null;
+  return (
+    <View style={{ marginBottom: 8 }}>
+      <Text style={s.sectionTitle}>
+        {title} ({tasks.length})
+      </Text>
+      <Text style={s.sectionHint}>{hint}</Text>
+      {tasks.map((t) => (
+        <ReviewRow key={t.id} task={t} showDefer={showDefer} />
+      ))}
+    </View>
+  );
+}
+
+export default function Review() {
+  const router = useRouter();
+  const store = useStore();
+  const buckets = reviewBuckets(store);
+  const [last, reload] = useLastReview();
+  const days = daysSince(last);
+
+  const empty =
+    !buckets.overdue.length &&
+    !buckets.staleNext.length &&
+    !buckets.agingWaiting.length &&
+    !buckets.someday.length &&
+    !buckets.deferred.length &&
+    !buckets.stuckProjects.length;
+
+  return (
+    <ScrollView style={{ flex: 1, backgroundColor: C.bg }} contentContainerStyle={{ padding: 16, paddingBottom: 48 }}>
+      <Text style={s.lastReview}>
+        {last ? (days === 0 ? "Last review: today" : `Last review: ${days}d ago`) : "First review — welcome."}
+      </Text>
+
+      <Section title="Overdue" hint="Reschedule, do, or let go." tasks={buckets.overdue} />
+      <Section title="Stalled" hint="Next actions untouched for 2+ weeks — still the real next step?" tasks={buckets.staleNext} />
+      <Section title="Waiting too long" hint="A week without movement — time to nudge?" tasks={buckets.agingWaiting} />
+      <Section title="Someday sweep" hint="Promote what's ripe, trash what's dead." tasks={buckets.someday} />
+      <Section title="Deferred" hint="Hidden from lists — just so you know they're coming." tasks={buckets.deferred} showDefer />
+
+      {buckets.stuckProjects.length > 0 && (
+        <View style={{ marginBottom: 8 }}>
+          <Text style={s.sectionTitle}>Stuck projects ({buckets.stuckProjects.length})</Text>
+          <Text style={s.sectionHint}>Active, but no next action — decide the next step or park them.</Text>
+          {buckets.stuckProjects.map((p) => (
+            <Pressable key={p.id} style={s.row} onPress={() => router.push(`/project/${p.id}`)}>
+              <Text style={[s.title, { flex: 1 }]}>{p.name}</Text>
+              <Text style={s.meta}>open →</Text>
+            </Pressable>
+          ))}
+        </View>
+      )}
+
+      {empty && <Text style={s.empty}>All clear. Nothing needs a decision.</Text>}
+
+      <Button
+        title="✓ Mark review complete"
+        onPress={async () => {
+          haptic.success();
+          await markReviewed();
+          reload();
+          router.back();
+        }}
+      />
+      <View style={s.archiveRow}>
+        <Pressable onPress={() => router.push("/list/done")}>
+          <Text style={s.archiveLink}>Done</Text>
+        </Pressable>
+        <Text style={s.archiveDot}>·</Text>
+        <Pressable onPress={() => router.push("/list/trashed")}>
+          <Text style={s.archiveLink}>Trash</Text>
+        </Pressable>
+      </View>
+    </ScrollView>
+  );
+}
+
+const s = StyleSheet.create({
+  lastReview: { color: C.muted, fontSize: 13, marginBottom: 12 },
+  sectionTitle: {
+    color: C.text,
+    fontSize: 15,
+    fontWeight: "700",
+    paddingTop: 12,
+  },
+  sectionHint: { color: C.muted, fontSize: 13, marginBottom: 4 },
+  row: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 10,
+    paddingVertical: 12,
+    borderBottomWidth: StyleSheet.hairlineWidth,
+    borderBottomColor: C.border,
+  },
+  check: { paddingRight: 2 },
+  checkCircle: { width: 20, height: 20, borderRadius: 10, borderWidth: 2 },
+  title: { color: C.text, fontSize: 15 },
+  meta: { color: C.muted, fontSize: 12, marginTop: 2 },
+  action: { paddingHorizontal: 4 },
+  actionText: { fontSize: 17 },
+  empty: { color: C.muted, textAlign: "center", marginVertical: 32, fontSize: 15 },
+  archiveRow: { flexDirection: "row", justifyContent: "center", gap: 8, marginTop: 4 },
+  archiveLink: { color: C.muted, fontSize: 14, padding: 6 },
+  archiveDot: { color: C.muted, alignSelf: "center" },
+});

app/src/app/settings.tsx

@@ -1,9 +1,11 @@
+import * as Application from "expo-application";
 import { useRouter } from "expo-router";
 import { useEffect, useState } from "react";
 import { ScrollView, Text } from "react-native";
 import { Button, Field } from "../components/ui";
 import { api } from "../lib/api";
 import { DEFAULT_URL, getConfig, setConfig } from "../lib/config";
+import { sync } from "../lib/store";
 import { C } from "../lib/theme";
 
 export default function Settings() {
@@ -22,7 +24,8 @@ export default function Settings() {
   const save = async () => {
     await setConfig(url, token);
     try {
-      await api.tasks.list({ status: "inbox" });
+      await api.tasks.list({ status: "next" });
+      void sync();
       router.back();
     } catch (e) {
       setStatus(`Connection failed: ${e instanceof Error ? e.message : e}`);
@@ -42,6 +45,10 @@ export default function Settings() {
       />
       <Button title="Save & test" onPress={save} />
       {status && <Text style={{ color: C.danger }}>{status}</Text>}
+      {/* CI stamps versionName from the release tag — confirms which build Obtainium installed. */}
+      <Text style={{ color: C.muted, fontSize: 13, textAlign: "center", marginTop: 32 }}>
+        GTD v{Application.nativeApplicationVersion ?? "dev"}
+      </Text>
     </ScrollView>
   );
 }

app/src/app/task/[id].tsx

@@ -1,109 +1,159 @@
 import { useLocalSearchParams, useRouter } from "expo-router";
-import { useEffect, useState } from "react";
-import { ScrollView, Text } from "react-native";
+import { useState } from "react";
+import { Pressable, ScrollView, StyleSheet, Text, View } from "react-native";
+import DateField from "../../components/DateField";
+import EstimateChips from "../../components/EstimateChips";
+import PriorityChips from "../../components/PriorityChips";
 import { Button, Chips, Field } from "../../components/ui";
-import { api } from "../../lib/api";
+import { haptic } from "../../lib/haptics";
+import { REPEAT_LABEL, REPEATS } from "../../lib/repeat";
+import { activeProjects, knownContexts, trashTask, updateTask } from "../../lib/store";
 import { C } from "../../lib/theme";
-import type { Project, Task, TaskStatus } from "../../lib/types";
+import { useStore } from "../../lib/useStore";
+import type { Repeat, Task, TaskStatus } from "../../lib/types";
 
-const STATUSES: TaskStatus[] = ["inbox", "next", "waiting", "scheduled", "someday", "done"];
+const STATUSES: TaskStatus[] = ["next", "waiting", "someday", "done"];
 
 export default function TaskDetail() {
   const { id } = useLocalSearchParams<{ id: string }>();
   const router = useRouter();
-  const [task, setTask] = useState<Task | null>(null);
-  const [projects, setProjects] = useState<Project[]>([]);
-  const [error, setError] = useState<string | null>(null);
+  const store = useStore();
+  const original = store.tasks.find((t) => t.id === id);
+  // Draft is local to the screen; nothing is written until Save.
+  const [draft, setDraft] = useState<Task | null>(original ?? null);
 
-  useEffect(() => {
-    Promise.all([api.tasks.get(id), api.projects.list()])
-      .then(([t, ps]) => {
-        setTask(t);
-        setProjects(ps.filter((p) => p.status === "active" || p.id === t.project_id));
-      })
-      .catch((e) => setError(e instanceof Error ? e.message : String(e)));
-  }, [id]);
+  if (!draft) return <Text style={{ color: C.muted, margin: 16 }}>Task not found.</Text>;
 
-  if (error) return <Text style={{ color: C.danger, margin: 16 }}>{error}</Text>;
-  if (!task) return <Text style={{ color: C.muted, margin: 16 }}>Loading…</Text>;
+  const set = (patch: Partial<Task>) => setDraft({ ...draft, ...patch });
 
-  const set = (patch: Partial<Task>) => setTask({ ...task, ...patch });
-
-  const save = async () => {
-    try {
-      await api.tasks.update(task.id, {
-        title: task.title,
-        notes: task.notes,
-        status: task.status,
-        project_id: task.project_id,
-        context: task.context,
-        waiting_for: task.waiting_for,
-        due_date: task.due_date,
-        defer_date: task.defer_date,
-      });
-      router.back();
-    } catch (e) {
-      setError(e instanceof Error ? e.message : String(e));
-    }
-  };
-
-  const trash = async () => {
-    await api.tasks.trash(task.id);
+  const save = () => {
+    updateTask(draft.id, {
+      title: draft.title,
+      notes: draft.notes,
+      status: draft.status,
+      project_id: draft.project_id,
+      context: draft.context,
+      waiting_for: draft.waiting_for,
+      due_date: draft.due_date,
+      defer_date: draft.defer_date,
+      priority: draft.priority,
+      estimate_min: draft.estimate_min,
+      repeat: draft.repeat,
+    });
     router.back();
   };
 
+  const projects = activeProjects(store).filter((p) => p.status === "active" || p.id === draft.project_id);
   const projectOptions = ["none", ...projects.map((p) => p.id)];
   const projectLabels = Object.fromEntries([["none", "None"], ...projects.map((p) => [p.id, p.name])]);
+  const contexts = knownContexts(store);
+
+  if (draft.status === "trashed") {
+    return (
+      <ScrollView style={{ flex: 1, backgroundColor: C.bg }} contentContainerStyle={{ padding: 16 }}>
+        <Text style={s.trashedTitle}>{draft.title}</Text>
+        <Text style={s.trashedMeta}>In the trash.</Text>
+        <Button
+          title="Restore to Next"
+          onPress={() => {
+            haptic.success();
+            updateTask(draft.id, { status: "next" });
+            router.back();
+          }}
+        />
+      </ScrollView>
+    );
+  }
 
   return (
     <ScrollView style={{ flex: 1, backgroundColor: C.bg }} contentContainerStyle={{ padding: 16 }}>
-      <Field label="Title" value={task.title} onChangeText={(v) => set({ title: v })} />
-      <Chips label="List" options={STATUSES} value={task.status} onChange={(status) => set({ status })} />
+      <Field label="Title" value={draft.title} onChangeText={(v) => set({ title: v })} />
+      <PriorityChips value={draft.priority} onChange={(priority) => set({ priority })} />
+      <EstimateChips value={draft.estimate_min} onChange={(estimate_min) => set({ estimate_min })} />
+      <Chips label="List" options={STATUSES} value={draft.status} onChange={(status) => set({ status })} />
       <Chips
         label="Project"
         options={projectOptions}
         labels={projectLabels}
-        value={task.project_id ?? "none"}
+        value={draft.project_id ?? "none"}
         onChange={(v) => set({ project_id: v === "none" ? null : v })}
       />
       <Field
         label="Context"
-        value={task.context ?? ""}
+        value={draft.context ?? ""}
         onChangeText={(v) => set({ context: v || null })}
         placeholder="@home, @computer, @errands…"
         autoCapitalize="none"
       />
-      {task.status === "waiting" && (
+      {contexts.length > 0 && (
+        <View style={s.contextRow}>
+          {contexts.map((c) => (
+            <Pressable
+              key={c}
+              style={[s.contextChip, draft.context === c && s.contextChipActive]}
+              onPress={() => {
+                haptic.select();
+                set({ context: draft.context === c ? null : c });
+              }}
+            >
+              <Text style={[s.contextText, draft.context === c && { color: C.text }]}>{c}</Text>
+            </Pressable>
+          ))}
+        </View>
+      )}
+      {draft.status === "waiting" && (
         <Field
           label="Waiting for"
-          value={task.waiting_for ?? ""}
+          value={draft.waiting_for ?? ""}
           onChangeText={(v) => set({ waiting_for: v || null })}
           placeholder="Who or what?"
         />
       )}
-      <Field
-        label="Due date"
-        value={task.due_date ?? ""}
-        onChangeText={(v) => set({ due_date: v || null })}
-        placeholder="YYYY-MM-DD"
-        autoCapitalize="none"
-      />
-      <Field
-        label="Defer until"
-        value={task.defer_date ?? ""}
-        onChangeText={(v) => set({ defer_date: v || null })}
-        placeholder="YYYY-MM-DD"
-        autoCapitalize="none"
+      <DateField label="Due date" value={draft.due_date} onChange={(v) => set({ due_date: v })} clearable />
+      <Chips
+        label="Repeat"
+        options={["none", ...REPEATS]}
+        labels={{ none: "None", ...REPEAT_LABEL }}
+        value={draft.repeat ?? "none"}
+        onChange={(v) => set({ repeat: v === "none" ? null : (v as Repeat) })}
       />
+      <DateField label="Defer until" value={draft.defer_date} onChange={(v) => set({ defer_date: v })} clearable />
+      {!!draft.defer_date && (
+        <Text style={s.deferHint}>Hidden from lists until then — it resurfaces on the day.</Text>
+      )}
       <Field
         label="Notes"
-        value={task.notes}
+        value={draft.notes}
         onChangeText={(v) => set({ notes: v })}
         multiline
         style={{ minHeight: 80, textAlignVertical: "top" }}
       />
       <Button title="Save" onPress={save} />
-      <Button title="Delete" onPress={trash} danger />
+      <Button
+        title="Delete"
+        danger
+        onPress={() => {
+          trashTask(draft.id);
+          router.back();
+        }}
+      />
     </ScrollView>
   );
 }
+
+const s = StyleSheet.create({
+  trashedTitle: { color: C.text, fontSize: 18, marginBottom: 6 },
+  trashedMeta: { color: C.muted, fontSize: 14, marginBottom: 18 },
+  contextRow: { flexDirection: "row", flexWrap: "wrap", gap: 8, marginTop: -6, marginBottom: 14 },
+  contextChip: {
+    paddingVertical: 6,
+    paddingHorizontal: 12,
+    borderRadius: 16,
+    backgroundColor: C.surface,
+    borderWidth: 1,
+    borderColor: C.border,
+  },
+  contextChipActive: { backgroundColor: C.surface2, borderColor: C.accent },
+  contextText: { color: C.muted, fontSize: 13 },
+  deferHint: { color: C.muted, fontSize: 13, marginTop: -8, marginBottom: 12 },
+});

app/src/app/today.tsx

@@ -0,0 +1,34 @@
+import { SectionList, StyleSheet, Text } from "react-native";
+import TaskRow from "../components/TaskRow";
+import { todayTasks } from "../lib/store";
+import { C } from "../lib/theme";
+import { useStore } from "../lib/useStore";
+
+export default function Today() {
+  const store = useStore();
+  const { overdue, today } = todayTasks(store);
+  const sections = [
+    ...(overdue.length ? [{ title: "Overdue", data: overdue, color: C.danger }] : []),
+    { title: "Today", data: today, color: C.text },
+  ];
+
+  return (
+    <SectionList
+      style={{ flex: 1, backgroundColor: C.bg }}
+      sections={sections}
+      keyExtractor={(t) => t.id}
+      renderItem={({ item }) => <TaskRow task={item} showStatus />}
+      renderSectionHeader={({ section }) => (
+        <Text style={[s.header, { color: section.color }]}>{section.title}</Text>
+      )}
+      ListEmptyComponent={<Text style={s.empty}>Nothing due. Clear runway.</Text>}
+      contentContainerStyle={{ paddingBottom: 32 }}
+      stickySectionHeadersEnabled={false}
+    />
+  );
+}
+
+const s = StyleSheet.create({
+  header: { fontSize: 15, fontWeight: "700", paddingHorizontal: 16, paddingTop: 18, paddingBottom: 6 },
+  empty: { color: C.muted, textAlign: "center", marginTop: 48, fontSize: 15 },
+});

app/src/components/DateField.tsx

@@ -0,0 +1,228 @@
+// Interactive date field: quick chips (Today / Tomorrow / Next week) plus an
+// expandable month calendar. Pure RN views — identical on Android, iOS, web.
+import { useMemo, useState } from "react";
+import { Pressable, StyleSheet, Text, View } from "react-native";
+import { haptic } from "../lib/haptics";
+import { C } from "../lib/theme";
+
+const DAY_MS = 86_400_000;
+const WEEKDAYS = ["M", "T", "W", "T", "F", "S", "S"];
+const MONTHS = [
+  "January", "February", "March", "April", "May", "June",
+  "July", "August", "September", "October", "November", "December",
+];
+
+function iso(d: Date): string {
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+
+function fromIso(s: string): Date {
+  const [y, m, d] = s.split("-").map(Number);
+  return new Date(y, m - 1, d);
+}
+
+function pretty(s: string): string {
+  const d = fromIso(s);
+  const today = new Date();
+  const diff = Math.round((d.getTime() - new Date(today.getFullYear(), today.getMonth(), today.getDate()).getTime()) / DAY_MS);
+  if (diff === 0) return "Today";
+  if (diff === 1) return "Tomorrow";
+  if (diff === -1) return "Yesterday";
+  const wd = d.toLocaleDateString("en-AU", { weekday: "short" });
+  return `${wd} ${d.getDate()} ${MONTHS[d.getMonth()].slice(0, 3)}${d.getFullYear() !== today.getFullYear() ? ` ${d.getFullYear()}` : ""}`;
+}
+
+function Calendar({ value, onPick }: { value: string | null; onPick: (v: string) => void }) {
+  const initial = value ? fromIso(value) : new Date();
+  const [year, setYear] = useState(initial.getFullYear());
+  const [month, setMonth] = useState(initial.getMonth());
+  const todayIso = iso(new Date());
+
+  const weeks = useMemo(() => {
+    const first = new Date(year, month, 1);
+    const start = new Date(first);
+    start.setDate(1 - ((first.getDay() + 6) % 7)); // back to Monday
+    return Array.from({ length: 6 }, (_, w) =>
+      Array.from({ length: 7 }, (_, i) => {
+        const d = new Date(start);
+        d.setDate(start.getDate() + w * 7 + i);
+        return d;
+      }),
+    );
+  }, [year, month]);
+
+  const shift = (delta: number) => {
+    haptic.select();
+    const d = new Date(year, month + delta, 1);
+    setYear(d.getFullYear());
+    setMonth(d.getMonth());
+  };
+
+  return (
+    <View style={s.calendar}>
+      <View style={s.calHead}>
+        <Pressable onPress={() => shift(-1)} hitSlop={10} style={s.arrow}>
+          <Text style={s.arrowText}>‹</Text>
+        </Pressable>
+        <Text style={s.calTitle}>
+          {MONTHS[month]} {year}
+        </Text>
+        <Pressable onPress={() => shift(1)} hitSlop={10} style={s.arrow}>
+          <Text style={s.arrowText}>›</Text>
+        </Pressable>
+      </View>
+      <View style={s.week}>
+        {WEEKDAYS.map((w, i) => (
+          <Text key={i} style={s.weekday}>
+            {w}
+          </Text>
+        ))}
+      </View>
+      {weeks.map((week, wi) => (
+        <View key={wi} style={s.week}>
+          {week.map((d) => {
+            const dIso = iso(d);
+            const inMonth = d.getMonth() === month;
+            const selected = dIso === value;
+            const isToday = dIso === todayIso;
+            return (
+              <Pressable
+                key={dIso}
+                style={[s.day, selected && s.daySelected, !selected && isToday && s.dayToday]}
+                onPress={() => {
+                  haptic.select();
+                  onPick(dIso);
+                }}
+              >
+                <Text
+                  style={[
+                    s.dayText,
+                    !inMonth && { color: C.border },
+                    selected && { color: "#FFFFFF", fontWeight: "700" },
+                    !selected && isToday && { color: C.accent },
+                  ]}
+                >
+                  {d.getDate()}
+                </Text>
+              </Pressable>
+            );
+          })}
+        </View>
+      ))}
+    </View>
+  );
+}
+
+export default function DateField({
+  label,
+  value,
+  onChange,
+  clearable,
+}: {
+  label: string;
+  value: string | null;
+  onChange: (v: string | null) => void;
+  clearable?: boolean;
+}) {
+  const [open, setOpen] = useState(false);
+  const today = new Date();
+  const quick = [
+    { label: "Today", v: iso(today) },
+    { label: "Tomorrow", v: iso(new Date(today.getTime() + DAY_MS)) },
+    { label: "Next week", v: iso(new Date(today.getTime() + 7 * DAY_MS)) },
+  ];
+
+  return (
+    <View style={{ marginBottom: 14 }}>
+      <View style={s.labelRow}>
+        <Text style={s.label}>{label}</Text>
+        {value != null && <Text style={s.chosen}>{pretty(value)}</Text>}
+      </View>
+      <View style={s.rowWrap}>
+        {quick.map((q) => (
+          <Pressable
+            key={q.label}
+            style={[s.chip, value === q.v && s.chipActive]}
+            onPress={() => {
+              haptic.select();
+              onChange(value === q.v && clearable ? null : q.v);
+            }}
+          >
+            <Text style={[s.chipText, value === q.v && { color: C.text }]}>{q.label}</Text>
+          </Pressable>
+        ))}
+        <Pressable
+          style={[s.chip, open && s.chipActive]}
+          onPress={() => {
+            haptic.select();
+            setOpen(!open);
+          }}
+        >
+          <Text style={[s.chipText, open && { color: C.text }]}>📆 Pick…</Text>
+        </Pressable>
+        {clearable && value != null && (
+          <Pressable
+            style={s.chip}
+            onPress={() => {
+              haptic.tap();
+              onChange(null);
+            }}
+          >
+            <Text style={s.chipText}>Clear</Text>
+          </Pressable>
+        )}
+      </View>
+      {open && (
+        <Calendar
+          value={value}
+          onPick={(v) => {
+            onChange(v);
+            setOpen(false);
+          }}
+        />
+      )}
+    </View>
+  );
+}
+
+const s = StyleSheet.create({
+  labelRow: { flexDirection: "row", justifyContent: "space-between", alignItems: "baseline", marginBottom: 6 },
+  label: { color: C.muted, fontSize: 13, textTransform: "uppercase", letterSpacing: 0.5 },
+  chosen: { color: C.accent, fontSize: 14, fontWeight: "600" },
+  rowWrap: { flexDirection: "row", flexWrap: "wrap", gap: 8 },
+  chip: {
+    paddingVertical: 8,
+    paddingHorizontal: 14,
+    borderRadius: 20,
+    backgroundColor: C.surface,
+    borderWidth: 1,
+    borderColor: C.border,
+  },
+  chipActive: { backgroundColor: C.surface2, borderColor: C.accent },
+  chipText: { color: C.muted, fontSize: 14 },
+  calendar: {
+    marginTop: 10,
+    backgroundColor: C.surface,
+    borderRadius: 14,
+    borderWidth: 1,
+    borderColor: C.border,
+    padding: 10,
+  },
+  calHead: { flexDirection: "row", justifyContent: "space-between", alignItems: "center", marginBottom: 6 },
+  calTitle: { color: C.text, fontSize: 15, fontWeight: "600" },
+  arrow: { paddingHorizontal: 14, paddingVertical: 4 },
+  arrowText: { color: C.accent, fontSize: 22, fontWeight: "600" },
+  week: { flexDirection: "row" },
+  weekday: { flex: 1, textAlign: "center", color: C.muted, fontSize: 11, paddingVertical: 4 },
+  day: {
+    flex: 1,
+    aspectRatio: 1.15,
+    alignItems: "center",
+    justifyContent: "center",
+    borderRadius: 999,
+    margin: 1,
+  },
+  daySelected: { backgroundColor: C.accent },
+  dayToday: { borderWidth: 1, borderColor: C.accent },
+  dayText: { color: C.text, fontSize: 14 },
+});

app/src/components/EstimateChips.tsx

@@ -0,0 +1,56 @@
+// Preset estimate chips — one tap beats a numeric keyboard. A non-preset
+// value (from quick-add, e.g. ~25m) shows up as its own chip so it's never
+// invisible or lost.
+import { Pressable, StyleSheet, Text, View } from "react-native";
+import { haptic } from "../lib/haptics";
+import { formatEstimate } from "../lib/priority";
+import { C } from "../lib/theme";
+
+const PRESETS = [15, 30, 45, 60, 90, 120];
+
+export default function EstimateChips({
+  value,
+  onChange,
+}: {
+  value: number | null;
+  onChange: (v: number | null) => void;
+}) {
+  const options = value && !PRESETS.includes(value) ? [...PRESETS, value].sort((a, b) => a - b) : PRESETS;
+  return (
+    <View style={{ marginBottom: 14 }}>
+      <Text style={s.label}>Estimated time</Text>
+      <View style={s.rowWrap}>
+        {options.map((m) => {
+          const active = value === m;
+          return (
+            <Pressable
+              key={m}
+              style={[s.chip, active && s.chipActive]}
+              onPress={() => {
+                haptic.select();
+                onChange(active ? null : m);
+              }}
+            >
+              <Text style={[s.chipText, active && { color: C.text }]}>{formatEstimate(m)}</Text>
+            </Pressable>
+          );
+        })}
+      </View>
+    </View>
+  );
+}
+
+const s = StyleSheet.create({
+  label: { color: C.muted, fontSize: 13, marginBottom: 6, textTransform: "uppercase", letterSpacing: 0.5 },
+  rowWrap: { flexDirection: "row", flexWrap: "wrap", gap: 8 },
+  chip: {
+    paddingVertical: 8,
+    paddingHorizontal: 14,
+    borderRadius: 20,
+    backgroundColor: C.surface,
+    borderWidth: 1,
+    borderColor: C.border,
+  },
+  chipActive: { backgroundColor: C.surface2, borderColor: C.accent },
+  chipText: { color: C.muted, fontSize: 14 },
+});

app/src/components/PriorityChips.tsx

@@ -0,0 +1,56 @@
+import { Pressable, StyleSheet, Text, View } from "react-native";
+import { haptic } from "../lib/haptics";
+import { PRIORITIES, PRIORITY_COLOR, PRIORITY_LABEL } from "../lib/priority";
+import { C } from "../lib/theme";
+import type { Task } from "../lib/types";
+
+export default function PriorityChips({
+  value,
+  onChange,
+}: {
+  value: Task["priority"] | null;
+  onChange: (p: Task["priority"]) => void;
+}) {
+  return (
+    <View style={{ marginBottom: 14 }}>
+      <Text style={s.label}>Priority</Text>
+      <View style={s.rowWrap}>
+        {PRIORITIES.map((p) => {
+          const active = value === p;
+          const color = PRIORITY_COLOR[p];
+          return (
+            <Pressable
+              key={p}
+              style={[s.chip, active && { borderColor: color, backgroundColor: `${color}22` }]}
+              onPress={() => {
+                haptic.select();
+                onChange(p);
+              }}
+            >
+              <View style={[s.flag, { backgroundColor: color }]} />
+              <Text style={[s.text, active && { color: C.text }]}>{PRIORITY_LABEL[p]}</Text>
+            </Pressable>
+          );
+        })}
+      </View>
+    </View>
+  );
+}
+
+const s = StyleSheet.create({
+  label: { color: C.muted, fontSize: 13, marginBottom: 6, textTransform: "uppercase", letterSpacing: 0.5 },
+  rowWrap: { flexDirection: "row", flexWrap: "wrap", gap: 8 },
+  chip: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 7,
+    paddingVertical: 8,
+    paddingHorizontal: 13,
+    borderRadius: 20,
+    backgroundColor: C.surface,
+    borderWidth: 1,
+    borderColor: C.border,
+  },
+  flag: { width: 10, height: 10, borderRadius: 5 },
+  text: { color: C.muted, fontSize: 14 },
+});

app/src/components/TaskListScreen.tsx

@@ -1,120 +1,83 @@
-import { useFocusEffect, useRouter } from "expo-router";
-import { useCallback, useState } from "react";
-import {
-  FlatList,
-  Pressable,
-  RefreshControl,
-  StyleSheet,
-  Text,
-  TextInput,
-  View,
-} from "react-native";
-import { api } from "../lib/api";
+import { useState } from "react";
+import { Pressable, RefreshControl, StyleSheet, Text, View } from "react-native";
+import DraggableFlatList, { ScaleDecorator } from "react-native-draggable-flatlist";
+import { haptic } from "../lib/haptics";
+import { reorderTask, sync, tasksByStatus, visibleTasksByStatus } from "../lib/store";
 import { C } from "../lib/theme";
-import type { Task, TaskStatus } from "../lib/types";
+import { useStore } from "../lib/useStore";
+import type { TaskStatus } from "../lib/types";
+import TaskRow from "./TaskRow";
 
-function TaskRow({ task, onToggle }: { task: Task; onToggle: (t: Task) => void }) {
-  const router = useRouter();
-  const meta = [task.context, task.waiting_for && `→ ${task.waiting_for}`, task.due_date && `due ${task.due_date}`]
-    .filter(Boolean)
-    .join("  ·  ");
-  return (
-    <Pressable style={s.row} onPress={() => router.push(`/task/${task.id}`)}>
-      <Pressable style={s.checkbox} hitSlop={10} onPress={() => onToggle(task)}>
-        {task.status === "done" && <View style={s.checkboxFill} />}
-      </Pressable>
-      <View style={{ flex: 1 }}>
-        <Text style={s.title} numberOfLines={2}>
-          {task.title}
-        </Text>
-        {!!meta && <Text style={s.meta}>{meta}</Text>}
-      </View>
-    </Pressable>
-  );
-}
+// Deferred tasks are hidden from these lists until their date — you can't act
+// on them yet, so they shouldn't cost attention. A one-line footer keeps them
+// discoverable (trust needs "hidden, not gone").
+const HIDES_DEFERRED: TaskStatus[] = ["next", "waiting", "someday"];
+// Archives read newest-first and aren't hand-ordered.
+const ARCHIVE: TaskStatus[] = ["done", "trashed"];
 
 export default function TaskListScreen({
   status,
-  capture,
   emptyHint,
 }: {
   status: TaskStatus;
-  capture?: boolean;
   emptyHint: string;
 }) {
-  const [tasks, setTasks] = useState<Task[]>([]);
+  const store = useStore();
   const [refreshing, setRefreshing] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-  const [draft, setDraft] = useState("");
+  const [showDeferred, setShowDeferred] = useState(false);
+  const hidesDeferred = HIDES_DEFERRED.includes(status);
+  const archive = ARCHIVE.includes(status);
 
-  const load = useCallback(async () => {
-    try {
-      setTasks(await api.tasks.list({ status }));
-      setError(null);
-    } catch (e) {
-      setError(e instanceof Error ? e.message : String(e));
-    }
-  }, [status]);
-
-  useFocusEffect(
-    useCallback(() => {
-      load();
-    }, [load]),
-  );
-
-  const add = async () => {
-    const title = draft.trim();
-    if (!title) return;
-    setDraft("");
-    setTasks((cur) => [{ id: `tmp-${title}`, title, status } as Task, ...cur]);
-    try {
-      await api.tasks.create({ title, status });
-    } finally {
-      load();
-    }
-  };
-
-  const toggle = async (task: Task) => {
-    const done = task.status !== "done";
-    setTasks((cur) => cur.filter((t) => t.id !== task.id));
-    try {
-      await api.tasks.update(task.id, { status: done ? "done" : status });
-    } finally {
-      load();
-    }
-  };
+  const all = tasksByStatus(store, status);
+  let tasks = hidesDeferred && !showDeferred ? visibleTasksByStatus(store, status) : all;
+  if (archive) {
+    tasks = [...all].sort((a, b) =>
+      (b.completed_at ?? b.updated_at).localeCompare(a.completed_at ?? a.updated_at),
+    );
+  }
+  const hiddenCount = all.length - tasks.length;
 
   return (
     <View style={s.screen}>
-      {capture && (
-        <TextInput
-          style={s.capture}
-          placeholder="Capture anything…"
-          placeholderTextColor={C.muted}
-          value={draft}
-          onChangeText={setDraft}
-          onSubmitEditing={add}
-          submitBehavior="submit"
-          returnKeyType="done"
-        />
-      )}
-      {error && <Text style={s.error}>{error}</Text>}
-      <FlatList
+      <DraggableFlatList
         data={tasks}
         keyExtractor={(t) => t.id}
-        renderItem={({ item }) => <TaskRow task={item} onToggle={toggle} />}
+        activationDistance={12}
+        onDragBegin={() => haptic.pickup()}
+        onDragEnd={({ data, from, to }) => {
+          if (!archive && from !== to) {
+            haptic.success();
+            reorderTask(data[to].id, status, to);
+          }
+        }}
+        renderItem={({ item, drag, isActive }) => (
+          <ScaleDecorator activeScale={1.03}>
+            <View style={isActive && s.activeRow}>
+              <TaskRow task={item} uncheckTo={status === "done" ? "next" : status} onLongPress={archive ? undefined : drag} />
+            </View>
+          </ScaleDecorator>
+        )}
         refreshControl={
           <RefreshControl
             refreshing={refreshing}
             tintColor={C.muted}
             onRefresh={async () => {
               setRefreshing(true);
-              await load();
+              await sync();
               setRefreshing(false);
             }}
           />
         }
         ListEmptyComponent={<Text style={s.empty}>{emptyHint}</Text>}
+        ListFooterComponent={
+          hidesDeferred && (hiddenCount > 0 || showDeferred) ? (
+            <Pressable onPress={() => setShowDeferred((v) => !v)}>
+              <Text style={s.deferredFooter}>
+                {showDeferred ? "hide deferred" : `⏸ ${hiddenCount} deferred — show`}
+              </Text>
+            </Pressable>
+          ) : null
+        }
         contentContainerStyle={{ paddingBottom: 32 }}
       />
     </View>
@@ -123,38 +86,7 @@ export default function TaskListScreen({
 
 const s = StyleSheet.create({
   screen: { flex: 1, backgroundColor: C.bg },
-  capture: {
-    margin: 12,
-    marginBottom: 4,
-    padding: 14,
-    borderRadius: 12,
-    backgroundColor: C.surface,
-    color: C.text,
-    fontSize: 16,
-    borderWidth: 1,
-    borderColor: C.border,
-  },
-  row: {
-    flexDirection: "row",
-    alignItems: "center",
-    gap: 12,
-    paddingVertical: 14,
-    paddingHorizontal: 16,
-    borderBottomWidth: StyleSheet.hairlineWidth,
-    borderBottomColor: C.border,
-  },
-  checkbox: {
-    width: 22,
-    height: 22,
-    borderRadius: 11,
-    borderWidth: 2,
-    borderColor: C.muted,
-    alignItems: "center",
-    justifyContent: "center",
-  },
-  checkboxFill: { width: 12, height: 12, borderRadius: 6, backgroundColor: C.done },
-  title: { color: C.text, fontSize: 16 },
-  meta: { color: C.muted, fontSize: 13, marginTop: 2 },
+  activeRow: { backgroundColor: C.surface2, borderRadius: 12 },
   empty: { color: C.muted, textAlign: "center", marginTop: 48, fontSize: 15 },
-  error: { color: C.danger, marginHorizontal: 16, marginTop: 8 },
+  deferredFooter: { color: C.muted, fontSize: 13, textAlign: "center", paddingVertical: 14 },
 });

app/src/components/TaskRow.tsx

@@ -0,0 +1,96 @@
+import { useRouter } from "expo-router";
+import { Pressable, StyleSheet, Text, View } from "react-native";
+import Animated, { FadeIn } from "react-native-reanimated";
+import { dueMeta, friendlyDate, isDeferred } from "../lib/dates";
+import { haptic } from "../lib/haptics";
+import { formatEstimate, PRIORITY_COLOR } from "../lib/priority";
+import { updateTask } from "../lib/store";
+import { C } from "../lib/theme";
+import type { Task, TaskStatus } from "../lib/types";
+
+export default function TaskRow({
+  task,
+  uncheckTo = "next",
+  showStatus,
+  onLongPress,
+}: {
+  task: Task;
+  /** Status to revert to when un-checking a done task. */
+  uncheckTo?: TaskStatus;
+  showStatus?: boolean;
+  /** Drag handle for reorderable lists. */
+  onLongPress?: () => void;
+}) {
+  const router = useRouter();
+  // Due date is rendered separately so it can carry a tone color; the reader
+  // sees "due today" in amber, never does date math on an ISO string.
+  const due = task.due_date ? dueMeta(task.due_date) : null;
+  const dueColor = due?.tone === "overdue" ? C.danger : due?.tone === "today" ? C.warn : C.muted;
+  const base = [
+    showStatus ? task.status : null,
+    task.repeat && "↻",
+    task.context,
+    task.waiting_for && `→ ${task.waiting_for}`,
+    formatEstimate(task.estimate_min),
+    isDeferred(task.defer_date) && `⏸ until ${friendlyDate(task.defer_date!)}`,
+  ]
+    .filter(Boolean)
+    .join("  ·  ");
+  const meta = base || due;
+
+  const toggle = () => {
+    const done = task.status !== "done";
+    if (done) haptic.success();
+    else haptic.tap();
+    updateTask(task.id, { status: done ? "done" : uncheckTo });
+  };
+
+  return (
+    <Animated.View entering={FadeIn.duration(150)}>
+      <Pressable style={s.row} onPress={() => router.push(`/task/${task.id}`)} onLongPress={onLongPress} delayLongPress={200}>
+        <Pressable
+          style={[s.checkbox, { borderColor: PRIORITY_COLOR[task.priority] }]}
+          hitSlop={10}
+          onPress={toggle}
+        >
+          {task.status === "done" && <View style={s.checkboxFill} />}
+        </Pressable>
+        <View style={{ flex: 1 }}>
+          <Text style={s.title} numberOfLines={2}>
+            {task.title}
+          </Text>
+          {!!meta && (
+            <Text style={s.meta}>
+              {base}
+              {!!base && !!due && "  ·  "}
+              {due && <Text style={{ color: dueColor }}>{due.label}</Text>}
+            </Text>
+          )}
+        </View>
+      </Pressable>
+    </Animated.View>
+  );
+}
+
+const s = StyleSheet.create({
+  row: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 12,
+    paddingVertical: 14,
+    paddingHorizontal: 16,
+    borderBottomWidth: StyleSheet.hairlineWidth,
+    borderBottomColor: C.border,
+  },
+  checkbox: {
+    width: 22,
+    height: 22,
+    borderRadius: 11,
+    borderWidth: 2,
+    alignItems: "center",
+    justifyContent: "center",
+  },
+  checkboxFill: { width: 12, height: 12, borderRadius: 6, backgroundColor: C.done },
+  title: { color: C.text, fontSize: 16 },
+  meta: { color: C.muted, fontSize: 13, marginTop: 2 },
+});

app/src/lib/api.ts

@@ -34,7 +34,7 @@ export const api = {
       return req<Task[]>(`/v1/tasks${q ? `?${q}` : ""}`);
     },
     get: (id: string) => req<Task>(`/v1/tasks/${id}`),
-    create: (data: Partial<Task> & { title: string }) =>
+    create: (data: Partial<Task> & { title: string; id?: string }) =>
       req<Task>("/v1/tasks", { method: "POST", body: JSON.stringify(data) }),
     update: (id: string, data: Partial<Task>) =>
       req<Task>(`/v1/tasks/${id}`, { method: "PATCH", body: JSON.stringify(data) }),
@@ -42,7 +42,7 @@ export const api = {
   },
   projects: {
     list: () => req<Project[]>("/v1/projects"),
-    create: (data: Partial<Project> & { name: string }) =>
+    create: (data: Partial<Project> & { name: string; id?: string }) =>
       req<Project>("/v1/projects", { method: "POST", body: JSON.stringify(data) }),
     update: (id: string, data: Partial<Project>) =>
       req<Project>(`/v1/projects/${id}`, { method: "PATCH", body: JSON.stringify(data) }),

app/src/lib/dates.ts

@@ -0,0 +1,51 @@
+// Date helpers for human-friendly display. All task dates are local ISO
+// "YYYY-MM-DD" strings; comparisons are lexicographic.
+
+const DAY_MS = 86_400_000;
+
+export function todayIso(): string {
+  const d = new Date();
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+
+export function fromIso(s: string): Date {
+  const [y, m, d] = s.split("-").map(Number);
+  return new Date(y, m - 1, d);
+}
+
+export function toIso(d: Date): string {
+  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+
+/** Deferred = hidden from action lists until the date arrives. */
+export function isDeferred(deferDate: string | null, today = todayIso()): boolean {
+  return !!deferDate && deferDate > today;
+}
+
+export function daysFromToday(dateIso: string): number {
+  return Math.round((fromIso(dateIso).getTime() - fromIso(todayIso()).getTime()) / DAY_MS);
+}
+
+/** "Today" / "Tomorrow" / "Mon 18 Aug" — no ISO date math for the reader. */
+export function friendlyDate(dateIso: string): string {
+  const diff = daysFromToday(dateIso);
+  if (diff === 0) return "Today";
+  if (diff === 1) return "Tomorrow";
+  if (diff === -1) return "Yesterday";
+  const d = fromIso(dateIso);
+  const wd = d.toLocaleDateString("en-AU", { weekday: "short" });
+  const mo = d.toLocaleDateString("en-AU", { month: "short" });
+  const yr = d.getFullYear() !== new Date().getFullYear() ? ` ${d.getFullYear()}` : "";
+  return `${wd} ${d.getDate()} ${mo}${yr}`;
+}
+
+export type DueTone = "overdue" | "today" | "later";
+
+/** Row label for a due date, with a tone the UI can color. */
+export function dueMeta(dueIso: string): { label: string; tone: DueTone } {
+  const diff = daysFromToday(dueIso);
+  if (diff < 0) return { label: diff === -1 ? "1d overdue" : `${-diff}d overdue`, tone: "overdue" };
+  if (diff === 0) return { label: "due today", tone: "today" };
+  if (diff === 1) return { label: "due tomorrow", tone: "later" };
+  return { label: `due ${friendlyDate(dueIso)}`, tone: "later" };
+}

app/src/lib/haptics.ts

@@ -0,0 +1,24 @@
+// Haptics that silently no-op on web.
+import * as Haptics from "expo-haptics";
+import { Platform } from "react-native";
+
+const canBuzz = Platform.OS !== "web";
+
+export const haptic = {
+  /** Light tick — captures, small confirmations. */
+  tap: () => {
+    if (canBuzz) void Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Light);
+  },
+  /** Medium thunk — picking up a draggable. */
+  pickup: () => {
+    if (canBuzz) void Haptics.impactAsync(Haptics.ImpactFeedbackStyle.Medium);
+  },
+  /** Success notification — completing a task, landing a drop. */
+  success: () => {
+    if (canBuzz) void Haptics.notificationAsync(Haptics.NotificationFeedbackType.Success);
+  },
+  /** Selection change — flicking through chips. */
+  select: () => {
+    if (canBuzz) void Haptics.selectionAsync();
+  },
+};

app/src/lib/priority.ts

@@ -0,0 +1,24 @@
+import type { Task } from "./types";
+
+export const PRIORITIES: Task["priority"][] = [1, 2, 3, 4];
+
+export const PRIORITY_LABEL: Record<Task["priority"], string> = {
+  1: "Urgent",
+  2: "High",
+  3: "Medium",
+  4: "Low",
+};
+
+export const PRIORITY_COLOR: Record<Task["priority"], `#${string}`> = {
+  1: "#E05B5B",
+  2: "#E0A93E",
+  3: "#5B8DEF",
+  4: "#6B7280",
+};
+
+export function formatEstimate(min: number | null): string | null {
+  if (!min) return null;
+  const h = Math.floor(min / 60);
+  const m = min % 60;
+  return h ? (m ? `${h}h${m}` : `${h}h`) : `${m}m`;
+}

app/src/lib/quickadd.ts

@@ -0,0 +1,110 @@
+// Natural-language quick add, Todoist style:
+//   "Pay rent tomorrow p1 @home #Sydney ~30m monthly"
+// → title "Pay rent", due tomorrow, priority 1, context @home,
+//   project "Sydney" (matched by name prefix), estimate 30 min, repeats monthly.
+//
+// The add form parses the title field live and mirrors every recognized token
+// into a visible form control, so a false positive (e.g. "fri" in a name) is
+// seen and fixable, never silent.
+import type { Project, Repeat, Task } from "./types";
+
+export interface ParsedQuickAdd {
+  title: string;
+  priority?: Task["priority"];
+  due_date?: string;
+  context?: string;
+  project_id?: string;
+  estimate_min?: number;
+  repeat?: Repeat;
+}
+
+const WEEKDAYS = ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
+const REPEAT_WORDS: Record<string, Repeat> = {
+  daily: "daily",
+  weekdays: "weekdays",
+  weekly: "weekly",
+  monthly: "monthly",
+  yearly: "yearly",
+};
+
+function iso(d: Date): string {
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+
+function parseDateWord(word: string): string | undefined {
+  const w = word.toLowerCase();
+  const today = new Date();
+  if (w === "today" || w === "tod") return iso(today);
+  // No "tom" alias — it's a name far more often than a date.
+  if (w === "tomorrow" || w === "tmr") {
+    const d = new Date(today);
+    d.setDate(d.getDate() + 1);
+    return iso(d);
+  }
+  if (/^\d{4}-\d{2}-\d{2}$/.test(w)) return w;
+  const wd = WEEKDAYS.findIndex((n) => n === w || n.slice(0, 3) === w);
+  if (wd >= 0) {
+    const d = new Date(today);
+    const delta = (wd - d.getDay() + 7) % 7 || 7; // always the *next* occurrence
+    d.setDate(d.getDate() + delta);
+    return iso(d);
+  }
+  return undefined;
+}
+
+function parseEstimate(token: string): number | undefined {
+  const m = token.match(/^~(?:(\d+)h)?(\d+)?m?$/i);
+  if (!m || (!m[1] && !m[2])) return undefined;
+  return (Number(m[1] ?? 0) * 60 + Number(m[2] ?? 0)) || undefined;
+}
+
+export function parseQuickAdd(input: string, projects: Project[]): ParsedQuickAdd {
+  const out: ParsedQuickAdd = { title: "" };
+  const rest: string[] = [];
+
+  for (const token of input.trim().split(/\s+/)) {
+    const p = token.match(/^p([1-4])$/i);
+    if (p && out.priority === undefined) {
+      out.priority = Number(p[1]) as Task["priority"];
+      continue;
+    }
+    if (token.startsWith("@") && token.length > 1 && out.context === undefined) {
+      out.context = token;
+      continue;
+    }
+    if (token.startsWith("#") && token.length > 1 && out.project_id === undefined) {
+      const name = token.slice(1).toLowerCase();
+      const match = projects.find(
+        (pr) => pr.status === "active" && pr.name.toLowerCase().startsWith(name),
+      );
+      if (match) {
+        out.project_id = match.id;
+        continue;
+      }
+    }
+    const est = parseEstimate(token);
+    if (est && out.estimate_min === undefined) {
+      out.estimate_min = est;
+      continue;
+    }
+    const rep = REPEAT_WORDS[token.toLowerCase()];
+    if (rep && out.repeat === undefined) {
+      out.repeat = rep;
+      continue;
+    }
+    if (out.due_date === undefined) {
+      const due = parseDateWord(token);
+      if (due) {
+        out.due_date = due;
+        continue;
+      }
+    }
+    rest.push(token);
+  }
+
+  out.title = rest.join(" ");
+  return out;
+}

app/src/lib/repeat.ts

@@ -0,0 +1,65 @@
+// Recurrence rules. Completing a repeating task spawns the next occurrence
+// (see store.updateTask) — the done row keeps its history, the clone carries
+// the rule forward.
+import { fromIso, toIso } from "./dates";
+import type { Repeat } from "./types";
+
+export const REPEATS: Repeat[] = ["daily", "weekdays", "weekly", "monthly", "yearly"];
+
+export const REPEAT_LABEL: Record<Repeat, string> = {
+  daily: "Daily",
+  weekdays: "Weekdays",
+  weekly: "Weekly",
+  monthly: "Monthly",
+  yearly: "Yearly",
+};
+
+function addDays(d: Date, n: number): Date {
+  const r = new Date(d);
+  r.setDate(r.getDate() + n);
+  return r;
+}
+
+/** Same day-of-month n months later, clamped to the month's last day. */
+function addMonthsClamped(d: Date, n: number): Date {
+  const r = new Date(d.getFullYear(), d.getMonth() + n, 1);
+  const last = new Date(r.getFullYear(), r.getMonth() + 1, 0).getDate();
+  r.setDate(Math.min(d.getDate(), last));
+  return r;
+}
+
+function step(d: Date, repeat: Repeat): Date {
+  switch (repeat) {
+    case "daily":
+      return addDays(d, 1);
+    case "weekdays": {
+      let n = addDays(d, 1);
+      while (n.getDay() === 0 || n.getDay() === 6) n = addDays(n, 1);
+      return n;
+    }
+    case "weekly":
+      return addDays(d, 7);
+    case "monthly":
+      return addMonthsClamped(d, 1);
+    case "yearly":
+      return addMonthsClamped(d, 12);
+  }
+}
+
+/**
+ * Next occurrence strictly after the base date, catching up to today for
+ * lapsed tasks (a monthly bill 3 months overdue advances to the next
+ * anchor-day on or after today, not three stale dates in the past).
+ */
+export function nextOccurrence(baseIso: string | null, repeat: Repeat, todayIsoStr: string): string {
+  let d = fromIso(baseIso ?? todayIsoStr);
+  let guard = 0;
+  do {
+    d = step(d, repeat);
+  } while (toIso(d) < todayIsoStr && ++guard < 5000);
+  return toIso(d);
+}
+
+export function shiftDays(dateIso: string, n: number): string {
+  return toIso(addDays(fromIso(dateIso), n));
+}

app/src/lib/review.ts

@@ -0,0 +1,29 @@
+// Last-completed-review timestamp, local only — the review is a habit, not
+// synced data.
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { useCallback, useEffect, useState } from "react";
+
+const KEY = "review_last_v1";
+
+export async function getLastReview(): Promise<string | null> {
+  return AsyncStorage.getItem(KEY);
+}
+
+export async function markReviewed(): Promise<void> {
+  await AsyncStorage.setItem(KEY, new Date().toISOString());
+}
+
+export function daysSince(iso: string | null): number | null {
+  if (!iso) return null;
+  return Math.floor((Date.now() - new Date(iso).getTime()) / 86_400_000);
+}
+
+/** [lastReviewIso, reload] — call reload on focus to pick up changes. */
+export function useLastReview(): [string | null, () => void] {
+  const [last, setLast] = useState<string | null>(null);
+  const reload = useCallback(() => {
+    void getLastReview().then(setLast);
+  }, []);
+  useEffect(reload, [reload]);
+  return [last, reload];
+}

app/src/lib/store.ts

@@ -0,0 +1,409 @@
+// Local-first store — the single source of truth for the UI.
+//
+// Screens render synchronously from the in-memory state (hydrated from
+// AsyncStorage at launch). Mutations apply locally immediately and enqueue an
+// op; a background worker drains the queue to the API and then pulls the
+// server state, so the network is never on the interaction path. Single-user
+// last-write-wins: rows with queued local ops keep their local version during
+// a pull; everything else takes the server's.
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import * as Crypto from "expo-crypto";
+import { api } from "./api";
+import { getConfig } from "./config";
+import { daysFromToday, isDeferred, todayIso } from "./dates";
+import { nextOccurrence, shiftDays } from "./repeat";
+import type { Project, Task } from "./types";
+
+export interface State {
+  tasks: Task[];
+  projects: Project[];
+  hydrated: boolean;
+  syncing: boolean;
+  pending: number;
+  /** True when the last sync failed for network reasons — expected offline. */
+  offline: boolean;
+  syncError: string | null;
+}
+
+type Op =
+  | { kind: "task.create" | "task.update"; id: string; data: Partial<Task> }
+  | { kind: "project.create" | "project.update"; id: string; data: Partial<Project> };
+
+const DATA_KEY = "store_v1";
+const QUEUE_KEY = "queue_v1";
+
+let state: State = {
+  tasks: [],
+  projects: [],
+  hydrated: false,
+  syncing: false,
+  pending: 0,
+  offline: false,
+  syncError: null,
+};
+let queue: Op[] = [];
+const listeners = new Set<() => void>();
+
+export function getState(): State {
+  return state;
+}
+
+export function subscribe(listener: () => void): () => void {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+
+function setState(patch: Partial<State>) {
+  state = { ...state, ...patch, pending: queue.length };
+  for (const l of listeners) l();
+}
+
+function persistData() {
+  void AsyncStorage.setItem(DATA_KEY, JSON.stringify({ tasks: state.tasks, projects: state.projects }));
+}
+
+function persistQueue() {
+  void AsyncStorage.setItem(QUEUE_KEY, JSON.stringify(queue));
+}
+
+export async function hydrate() {
+  if (state.hydrated) return;
+  const [data, q] = await Promise.all([AsyncStorage.getItem(DATA_KEY), AsyncStorage.getItem(QUEUE_KEY)]);
+  if (q) queue = JSON.parse(q);
+  const parsed = data ? JSON.parse(data) : { tasks: [], projects: [] };
+  setState({ tasks: parsed.tasks, projects: parsed.projects, hydrated: true });
+  void sync();
+}
+
+// ---- mutations (instant; network happens later) ----
+
+function now() {
+  return new Date().toISOString();
+}
+
+// Fields the API accepts — everything else (timestamps, completed_at) is local
+// bookkeeping until the server's authoritative row arrives via pull().
+const TASK_FIELDS = ["title", "notes", "status", "project_id", "context", "waiting_for", "due_date", "defer_date", "priority", "estimate_min", "repeat", "sort_order"] as const;
+const PROJECT_FIELDS = ["name", "status", "notes", "sort_order"] as const;
+
+function pickFields<T>(data: Partial<T>, fields: readonly (keyof T & string)[]): Partial<T> {
+  const out: Partial<T> = {};
+  for (const f of fields) if (f in data) out[f] = data[f];
+  return out;
+}
+
+function enqueue(op: Op) {
+  // Coalesce consecutive updates to the same row into one op.
+  const last = queue[queue.length - 1];
+  if (last && op.kind === last.kind && op.kind.endsWith("update") && last.id === op.id) {
+    last.data = { ...last.data, ...op.data };
+  } else {
+    queue.push(op);
+  }
+  persistQueue();
+  setState({});
+  void sync();
+}
+
+export function createTask(data: Partial<Task> & { title: string }): Task {
+  // "next" — this app has no inbox; a task without an explicit box is actionable.
+  const status = data.status ?? "next";
+  const task: Task = {
+    id: Crypto.randomUUID(),
+    title: data.title,
+    notes: data.notes ?? "",
+    status,
+    project_id: data.project_id ?? null,
+    context: data.context ?? null,
+    waiting_for: data.waiting_for ?? null,
+    due_date: data.due_date ?? null,
+    defer_date: data.defer_date ?? null,
+    priority: data.priority ?? 4,
+    estimate_min: data.estimate_min ?? null,
+    repeat: data.repeat ?? null,
+    completed_at: null,
+    // New tasks land at the top of their list.
+    sort_order:
+      data.sort_order ??
+      Math.min(0, ...state.tasks.filter((t) => t.status === status).map((t) => t.sort_order)) - 1,
+    created_at: now(),
+    updated_at: now(),
+  };
+  setState({ tasks: [task, ...state.tasks] });
+  persistData();
+  enqueue({ kind: "task.create", id: task.id, data: pickFields(task, TASK_FIELDS) });
+  return task;
+}
+
+export function updateTask(id: string, patch: Partial<Task>) {
+  const before = state.tasks.find((t) => t.id === id);
+  setState({
+    tasks: state.tasks.map((t) => {
+      if (t.id !== id) return t;
+      const next = { ...t, ...patch, updated_at: now() };
+      // Mirror the server's completed_at rule so the UI is right pre-sync.
+      next.completed_at = next.status === "done" ? (t.completed_at ?? now()) : null;
+      return next;
+    }),
+  });
+  persistData();
+  enqueue({ kind: "task.update", id, data: pickFields(patch, TASK_FIELDS) });
+  // Completing a repeating task spawns the next occurrence. Un-checking the
+  // done row later leaves the spawn in place — it's one tap to trash, versus
+  // silently deleting a row the user may have edited.
+  if (before && before.repeat && before.status !== "done" && patch.status === "done") {
+    spawnNextOccurrence(before);
+  }
+}
+
+function spawnNextOccurrence(t: Task) {
+  const today = todayIso();
+  const due = t.due_date ? nextOccurrence(t.due_date, t.repeat!, today) : null;
+  // Keep the same lead time between defer and due (e.g. "surfaces 3 days before").
+  const defer =
+    due && t.due_date && t.defer_date
+      ? shiftDays(t.defer_date, daysFromToday(due) - daysFromToday(t.due_date))
+      : t.due_date
+        ? null
+        : t.defer_date
+          ? nextOccurrence(t.defer_date, t.repeat!, today)
+          : null;
+  createTask({
+    title: t.title,
+    notes: t.notes,
+    status: t.status,
+    project_id: t.project_id,
+    context: t.context,
+    waiting_for: t.waiting_for,
+    due_date: due,
+    defer_date: defer,
+    priority: t.priority,
+    estimate_min: t.estimate_min,
+    repeat: t.repeat,
+  });
+}
+
+export function trashTask(id: string) {
+  updateTask(id, { status: "trashed" });
+}
+
+export function createProject(data: Partial<Project> & { name: string }): Project {
+  const project: Project = {
+    id: Crypto.randomUUID(),
+    name: data.name,
+    status: data.status ?? "active",
+    notes: data.notes ?? "",
+    sort_order: data.sort_order ?? 0,
+    created_at: now(),
+    updated_at: now(),
+  };
+  setState({ projects: [project, ...state.projects] });
+  persistData();
+  enqueue({ kind: "project.create", id: project.id, data: pickFields(project, PROJECT_FIELDS) });
+  return project;
+}
+
+export function updateProject(id: string, patch: Partial<Project>) {
+  setState({ projects: state.projects.map((p) => (p.id === id ? { ...p, ...patch, updated_at: now() } : p)) });
+  persistData();
+  enqueue({ kind: "project.update", id, data: pickFields(patch, PROJECT_FIELDS) });
+}
+
+export function dropProject(id: string) {
+  updateProject(id, { status: "dropped" });
+}
+
+// ---- sync ----
+
+let syncRunning = false;
+let syncAgain = false;
+
+export async function sync() {
+  if (syncRunning) {
+    syncAgain = true;
+    return;
+  }
+  const { token } = await getConfig();
+  if (!token) return;
+  syncRunning = true;
+  setState({ syncing: true });
+  try {
+    while (queue.length) {
+      await push(queue[0]);
+      queue.shift();
+      persistQueue();
+      setState({});
+    }
+    await pull();
+    setState({ syncError: null, offline: false });
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    // fetch() network failures (airplane mode, no wifi, DNS) are the expected
+    // offline case, not an error — the queue simply waits for connectivity.
+    const isNetwork = e instanceof TypeError || /network request failed|unable to resolve|fetch failed|timeout/i.test(msg);
+    setState(isNetwork ? { offline: true, syncError: null } : { syncError: msg });
+  } finally {
+    syncRunning = false;
+    setState({ syncing: false });
+    if (syncAgain) {
+      syncAgain = false;
+      void sync();
+    }
+  }
+}
+
+async function push(op: Op) {
+  try {
+    if (op.kind === "task.create") await api.tasks.create({ id: op.id, ...op.data } as never);
+    else if (op.kind === "task.update") await api.tasks.update(op.id, op.data as Partial<Task>);
+    else if (op.kind === "project.create") await api.projects.create({ id: op.id, ...op.data } as never);
+    else await api.projects.update(op.id, op.data as Partial<Project>);
+  } catch (e) {
+    // 4xx (bad data, row gone) would poison the queue forever — drop the op.
+    // Anything else (offline, 5xx) rethrows and we retry on the next sync.
+    const status = (e as { status?: number }).status;
+    if (status && status >= 400 && status < 500 && status !== 401) return;
+    throw e;
+  }
+}
+
+async function pull() {
+  // The default list excludes trashed; fetch trash separately so the Trash
+  // screen (and restore) survive a sync.
+  const [open, trashed, projects] = await Promise.all([
+    api.tasks.list(),
+    api.tasks.list({ status: "trashed" }),
+    api.projects.list(),
+  ]);
+  const tasks = [...open, ...trashed];
+  // Rows with ops still queued keep their local version; the next sync pass
+  // pushes those ops and then this merge converges to the server state.
+  const dirty = new Set(queue.map((o) => o.id));
+  const keepLocal = <T extends { id: string }>(local: T[], server: T[]) => {
+    const serverIds = new Set(server.map((r) => r.id));
+    return [
+      ...server.map((r) => (dirty.has(r.id) ? local.find((l) => l.id === r.id) ?? r : r)),
+      ...local.filter((l) => dirty.has(l.id) && !serverIds.has(l.id)),
+    ];
+  };
+  setState({
+    tasks: keepLocal(state.tasks, tasks),
+    projects: keepLocal(state.projects, projects),
+  });
+  persistData();
+}
+
+// ---- selectors ----
+
+function byPriorityDue(a: Task, b: Task): number {
+  return (
+    a.priority - b.priority ||
+    (a.due_date ?? "9999").localeCompare(b.due_date ?? "9999") ||
+    a.sort_order - b.sort_order ||
+    b.created_at.localeCompare(a.created_at)
+  );
+}
+
+// Manual arrangement wins: sort_order is the canonical list order (set by
+// drag-to-reorder); priority/due only break ties for rows that never moved.
+function byManualOrder(a: Task, b: Task): number {
+  return a.sort_order - b.sort_order || byPriorityDue(a, b);
+}
+
+export function tasksByStatus(s: State, status: Task["status"]): Task[] {
+  return s.tasks.filter((t) => t.status === status).sort(byManualOrder);
+}
+
+/**
+ * The action lists hide deferred tasks until their date arrives — that's the
+ * whole point of a tickler. Review and the "show deferred" toggle see them.
+ */
+export function visibleTasksByStatus(s: State, status: Task["status"]): Task[] {
+  const today = todayIso();
+  return tasksByStatus(s, status).filter((t) => !isDeferred(t.defer_date, today));
+}
+
+/** Re-slot a task at `index` within its status list (fractional sort_order). */
+export function reorderTask(id: string, status: Task["status"], index: number) {
+  const list = tasksByStatus(getState(), status).filter((t) => t.id !== id);
+  const prev = list[index - 1]?.sort_order;
+  const next = list[index]?.sort_order;
+  const sort_order =
+    prev !== undefined && next !== undefined ? (prev + next) / 2
+    : prev !== undefined ? prev + 1
+    : next !== undefined ? next - 1
+    : 0;
+  updateTask(id, { sort_order });
+}
+
+/** Overdue + due-today + deferred-arriving-today, across all open lists. */
+export function todayTasks(s: State): { overdue: Task[]; today: Task[] } {
+  const now = new Date();
+  const todayIso = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
+  const open = s.tasks.filter((t) => t.status !== "done" && t.status !== "trashed");
+  return {
+    overdue: open.filter((t) => t.due_date && t.due_date < todayIso).sort(byPriorityDue),
+    today: open
+      .filter((t) => t.due_date === todayIso || (t.defer_date === todayIso && !t.due_date))
+      .sort(byPriorityDue),
+  };
+}
+
+export function activeProjects(s: State): Project[] {
+  return s.projects
+    .filter((p) => p.status !== "dropped")
+    .sort((a, b) => a.sort_order - b.sort_order || b.created_at.localeCompare(a.created_at));
+}
+
+export function openTaskCount(s: State, projectId: string): number {
+  return s.tasks.filter((t) => t.project_id === projectId && t.status !== "done" && t.status !== "trashed").length;
+}
+
+/** Distinct contexts on open tasks — suggestion chips beat retyping "@homr". */
+export function knownContexts(s: State): string[] {
+  const set = new Set<string>();
+  for (const t of s.tasks) {
+    if (t.context && t.status !== "done" && t.status !== "trashed") set.add(t.context);
+  }
+  return [...set].sort();
+}
+
+// ---- weekly review ----
+
+const STALE_DAYS = 14;
+const WAITING_DAYS = 7;
+
+function olderThanDays(ts: string, days: number): boolean {
+  return Date.now() - new Date(ts).getTime() > days * 86_400_000;
+}
+
+export interface ReviewBuckets {
+  overdue: Task[];
+  staleNext: Task[];
+  agingWaiting: Task[];
+  someday: Task[];
+  deferred: Task[];
+  stuckProjects: Project[];
+}
+
+export function reviewBuckets(s: State): ReviewBuckets {
+  const today = todayIso();
+  const open = s.tasks.filter((t) => t.status !== "done" && t.status !== "trashed");
+  const overdue = open.filter((t) => t.due_date && t.due_date < today).sort(byPriorityDue);
+  const overdueIds = new Set(overdue.map((t) => t.id));
+  const actionable = new Set(["next", "waiting"]);
+  return {
+    overdue,
+    staleNext: open
+      .filter((t) => t.status === "next" && !overdueIds.has(t.id) && olderThanDays(t.updated_at, STALE_DAYS))
+      .sort(byPriorityDue),
+    agingWaiting: open
+      .filter((t) => t.status === "waiting" && olderThanDays(t.updated_at, WAITING_DAYS))
+      .sort((a, b) => a.updated_at.localeCompare(b.updated_at)),
+    someday: tasksByStatus(s, "someday"),
+    deferred: open.filter((t) => isDeferred(t.defer_date, today)).sort((a, b) => a.defer_date!.localeCompare(b.defer_date!)),
+    stuckProjects: activeProjects(s).filter(
+      (p) => p.status === "active" && !s.tasks.some((t) => t.project_id === p.id && actionable.has(t.status)),
+    ),
+  };
+}

app/src/lib/theme.ts

@@ -8,4 +8,5 @@ export const C = {
   accent: "#5B8DEF",
   done: "#4CAF7D",
   danger: "#E05B5B",
-};
+  warn: "#E0A93E",
+} as const;

app/src/lib/types.ts

@@ -1,5 +1,6 @@
 export type TaskStatus = "inbox" | "next" | "waiting" | "scheduled" | "someday" | "done" | "trashed";
 export type ProjectStatus = "active" | "someday" | "completed" | "dropped";
+export type Repeat = "daily" | "weekdays" | "weekly" | "monthly" | "yearly";
 
 export interface Task {
   id: string;
@@ -11,6 +12,9 @@ export interface Task {
   waiting_for: string | null;
   due_date: string | null;
   defer_date: string | null;
+  priority: 1 | 2 | 3 | 4;
+  estimate_min: number | null;
+  repeat: Repeat | null;
   completed_at: string | null;
   sort_order: number;
   created_at: string;

app/src/lib/useStore.ts

@@ -0,0 +1,8 @@
+import { useSyncExternalStore } from "react";
+import { getState, subscribe, type State } from "./store";
+
+// Subscribe a component to the local-first store. The whole state object is
+// the snapshot (replaced immutably on every change), so derive lists inline.
+export function useStore(): State {
+  return useSyncExternalStore(subscribe, getState, getState);
+}

app/src/widget/NextUpWidget.tsx

@@ -0,0 +1,98 @@
+"use no memo"; // widget trees are built by calling the component as a plain function — the React Compiler must not transform it
+// Home-screen widget: the same top-three "Next up" list as the home screen.
+// Built only from react-native-android-widget primitives (no RN views, no
+// hooks) — it renders to Android RemoteViews in a headless task.
+//
+// Interactions mirror the app: tap the circle to complete, tap the row to
+// open Clarify, tap ＋ to capture, tap anywhere else to open the app.
+import { FlexWidget, TextWidget } from "react-native-android-widget";
+import { dueMeta, type DueTone } from "../lib/dates";
+import { formatEstimate, PRIORITY_COLOR } from "../lib/priority";
+import { C } from "../lib/theme";
+import type { Task } from "../lib/types";
+
+const DUE_COLOR: Record<DueTone, `#${string}`> = { overdue: C.danger, today: C.warn, later: C.muted };
+
+function Row({ task }: { task: Task }) {
+  const due = task.due_date ? dueMeta(task.due_date) : null;
+  // One line per row so three rows fit the 2-cell height: right-side meta is
+  // the due label when there is one, otherwise context/estimate.
+  const side = due ? due.label : [task.context, formatEstimate(task.estimate_min)].filter(Boolean).join(" · ");
+  return (
+    <FlexWidget
+      style={{ width: "match_parent", flex: 1, flexDirection: "row", alignItems: "center" }}
+      clickAction="OPEN_URI"
+      clickActionData={{ uri: `gtd://task/${task.id}` }}
+    >
+      <FlexWidget
+        clickAction="COMPLETE_TASK"
+        clickActionData={{ taskId: task.id }}
+        accessibilityLabel={`Complete ${task.title}`}
+        style={{ width: 32, height: 32, alignItems: "center", justifyContent: "center" }}
+      >
+        <FlexWidget
+          style={{ width: 19, height: 19, borderRadius: 10, borderWidth: 2, borderColor: PRIORITY_COLOR[task.priority] }}
+        />
+      </FlexWidget>
+      <FlexWidget style={{ flex: 1, marginLeft: 6 }}>
+        <TextWidget text={task.title} truncate="END" maxLines={1} style={{ fontSize: 15, color: C.text }} />
+      </FlexWidget>
+      {!!side && <TextWidget text={side} truncate="END" maxLines={1} style={{ fontSize: 11, color: due ? DUE_COLOR[due.tone] : C.muted, marginLeft: 8 }} />}
+    </FlexWidget>
+  );
+}
+
+export function NextUpWidget({ tasks, totalNext, overdueCount }: { tasks: Task[]; totalNext: number; overdueCount: number }) {
+  return (
+    <FlexWidget
+      clickAction="OPEN_APP"
+      style={{
+        width: "match_parent",
+        height: "match_parent",
+        flexDirection: "column",
+        backgroundColor: C.surface,
+        borderRadius: 24,
+        paddingHorizontal: 16,
+        paddingVertical: 12,
+      }}
+    >
+      <FlexWidget
+        style={{ width: "match_parent", flexDirection: "row", alignItems: "center", justifyContent: "space-between", marginBottom: 4 }}
+      >
+        <FlexWidget style={{ flexDirection: "row", alignItems: "center" }}>
+          <TextWidget text="NEXT UP" style={{ fontSize: 12, letterSpacing: 1, color: C.muted }} />
+          {totalNext > tasks.length && (
+            <TextWidget text={`  +${totalNext - tasks.length} more`} style={{ fontSize: 12, color: C.muted }} />
+          )}
+          {overdueCount > 0 && (
+            <TextWidget
+              text={`  ·  ${overdueCount} overdue`}
+              clickAction="OPEN_URI"
+              clickActionData={{ uri: "gtd://today" }}
+              style={{ fontSize: 12, color: C.danger }}
+            />
+          )}
+        </FlexWidget>
+        <FlexWidget
+          clickAction="OPEN_URI"
+          clickActionData={{ uri: "gtd://add" }}
+          accessibilityLabel="Add task"
+          style={{ width: 28, height: 28, borderRadius: 14, backgroundColor: C.accent, alignItems: "center", justifyContent: "center" }}
+        >
+          <TextWidget text="＋" style={{ fontSize: 16, color: "#FFFFFF" }} />
+        </FlexWidget>
+      </FlexWidget>
+      {tasks.length === 0 ? (
+        <FlexWidget style={{ width: "match_parent", flex: 1, alignItems: "center", justifyContent: "center" }}>
+          <TextWidget text="Nothing next. Tap ＋ to add." style={{ fontSize: 14, color: C.muted }} />
+        </FlexWidget>
+      ) : (
+        <FlexWidget style={{ width: "match_parent", flex: 1, flexDirection: "column" }}>
+          {tasks.map((t) => (
+            <Row key={t.id} task={t} />
+          ))}
+        </FlexWidget>
+      )}
+    </FlexWidget>
+  );
+}

app/src/widget/refresh.ts

@@ -0,0 +1,18 @@
+import { Platform } from "react-native";
+import { requestWidgetUpdate } from "react-native-android-widget";
+import { renderNextUpWidget, WIDGET_NAME } from "./render";
+
+let timer: ReturnType<typeof setTimeout> | undefined;
+
+/**
+ * Redraw the home-screen widget from current store state. Debounced because
+ * it's driven by the store listener, which fires on every mutation and sync
+ * step; drawing RemoteViews once per burst is plenty.
+ */
+export function refreshNextUpWidget() {
+  if (Platform.OS !== "android") return;
+  clearTimeout(timer);
+  timer = setTimeout(() => {
+    void requestWidgetUpdate({ widgetName: WIDGET_NAME, renderWidget: renderNextUpWidget });
+  }, 300);
+}

app/src/widget/render.tsx

@@ -0,0 +1,14 @@
+"use no memo";
+// One source of truth for what the widget shows: the same selectors the home
+// screen uses, so widget and app always agree on the top three.
+import { getState, todayTasks, visibleTasksByStatus } from "../lib/store";
+import { NextUpWidget } from "./NextUpWidget";
+
+/** Must match the widget `name` in app.json's react-native-android-widget plugin config. */
+export const WIDGET_NAME = "NextUp";
+
+export function renderNextUpWidget() {
+  const s = getState();
+  const next = visibleTasksByStatus(s, "next");
+  return <NextUpWidget tasks={next.slice(0, 3)} totalNext={next.length} overdueCount={todayTasks(s).overdue.length} />;
+}

app/src/widget/widget-task-handler.tsx

@@ -0,0 +1,19 @@
+// Headless entry point for widget events. When the app's JS context is
+// alive this shares the in-memory store; when launched cold, hydrate() loads
+// AsyncStorage — so completing from the widget goes through the exact same
+// local-first mutation path (instant local write, op queued, synced later).
+import type { WidgetTaskHandlerProps } from "react-native-android-widget";
+import { hydrate, updateTask } from "../lib/store";
+import { renderNextUpWidget } from "./render";
+
+export async function widgetTaskHandler(props: WidgetTaskHandlerProps) {
+  if (props.widgetAction === "WIDGET_DELETED") return;
+  await hydrate();
+  if (props.widgetAction === "WIDGET_CLICK") {
+    // OPEN_APP / OPEN_URI are handled natively; only completion reaches JS.
+    if (props.clickAction !== "COMPLETE_TASK") return;
+    const taskId = props.clickActionData?.taskId;
+    if (typeof taskId === "string") updateTask(taskId, { status: "done" });
+  }
+  props.renderWidget(renderNextUpWidget());
+}

server/index.ts

@@ -5,13 +5,19 @@ const sql = new SQL(process.env.DATABASE_URL!);
 const API_TOKEN = process.env.API_TOKEN!;
 if (!API_TOKEN) throw new Error("API_TOKEN not set");
 
+// schema.sql is idempotent (create/alter-if-not-exists) — apply it at boot so
+// a deployed server is never newer than the database it queries.
+await sql.unsafe(await Bun.file(new URL("schema.sql", import.meta.url)).text());
+
 const TASK_COLS = `id, title, notes, status, project_id, context, waiting_for,
   due_date::text as due_date, defer_date::text as defer_date,
-  completed_at, sort_order, created_at, updated_at`;
+  priority, estimate_min, repeat, completed_at, sort_order, created_at, updated_at`;
 const PROJECT_COLS = `id, name, status, notes, sort_order, created_at, updated_at`;
 
 const TASK_STATUSES = ["inbox", "next", "waiting", "scheduled", "someday", "done", "trashed"];
+const REPEATS = ["daily", "weekdays", "weekly", "monthly", "yearly"];
 const PROJECT_STATUSES = ["active", "someday", "completed", "dropped"];
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
 
 const CORS = {
   "Access-Control-Allow-Origin": "*",
@@ -27,12 +33,15 @@ function err(message: string, status: number) {
 }
 
 // Fields a client may set. completed_at is derived from status server-side.
-const TASK_FIELDS = ["title", "notes", "status", "project_id", "context", "waiting_for", "due_date", "defer_date", "sort_order"];
+const TASK_FIELDS = ["title", "notes", "status", "project_id", "context", "waiting_for", "due_date", "defer_date", "priority", "estimate_min", "repeat", "sort_order"];
 const PROJECT_FIELDS = ["name", "status", "notes", "sort_order"];
 
+// Only these may be cleared to NULL; notes/title are NOT NULL and keep "".
+const NULLABLE = new Set(["project_id", "context", "waiting_for", "due_date", "defer_date", "estimate_min", "repeat"]);
+
 function pick(body: Record<string, unknown>, fields: string[]) {
   const out: Record<string, unknown> = {};
-  for (const f of fields) if (f in body) out[f] = body[f] === "" ? null : body[f];
+  for (const f of fields) if (f in body) out[f] = body[f] === "" && NULLABLE.has(f) ? null : body[f];
   return out;
 }
 
@@ -69,13 +78,20 @@ async function handle(req: Request): Promise<Response> {
     const t = pick(body, TASK_FIELDS);
     if (typeof t.title !== "string" || !t.title.trim()) return err("title required", 400);
     if (t.status && !TASK_STATUSES.includes(t.status as string)) return err("bad status", 400);
+    if (t.repeat && !REPEATS.includes(t.repeat as string)) return err("bad repeat", 400);
+    const id = typeof body.id === "string" && UUID_RE.test(body.id) ? body.id : null;
+    // Client-supplied id + on-conflict no-op make offline-queue retries idempotent.
     const rows = await sql.unsafe(
-      `insert into tasks (title, notes, status, project_id, context, waiting_for, due_date, defer_date, sort_order)
-       values ($1, $2, $3, $4, $5, $6, $7, $8, $9)
+      `insert into tasks (id, title, notes, status, project_id, context, waiting_for, due_date, defer_date, priority, estimate_min, repeat, sort_order)
+       values (coalesce($1::uuid, gen_random_uuid()), $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13)
+       on conflict (id) do nothing
        returning ${TASK_COLS}`,
-      [t.title, t.notes ?? "", t.status ?? "inbox", t.project_id ?? null, t.context ?? null,
-       t.waiting_for ?? null, t.due_date ?? null, t.defer_date ?? null, t.sort_order ?? 0]);
-    return json(rows[0], 201);
+      [id, t.title, t.notes ?? "", t.status ?? "next", t.project_id ?? null, t.context ?? null,
+       t.waiting_for ?? null, t.due_date ?? null, t.defer_date ?? null, t.priority ?? 4,
+       t.estimate_min ?? null, t.repeat ?? null, t.sort_order ?? 0]);
+    if (rows.length) return json(rows[0], 201);
+    const existing = await sql.unsafe(`select ${TASK_COLS} from tasks where id = $1`, [id]);
+    return json(existing[0], 200);
   }
 
   let m = path.match(/^\/v1\/tasks\/([0-9a-f-]{36})$/);
@@ -87,16 +103,18 @@ async function handle(req: Request): Promise<Response> {
     const id = m[1];
     const patch = method === "DELETE" ? { status: "trashed" } : pick(body, TASK_FIELDS);
     if (patch.status && !TASK_STATUSES.includes(patch.status as string)) return err("bad status", 400);
+    if (patch.repeat && !REPEATS.includes(patch.repeat as string)) return err("bad repeat", 400);
     const existing = await sql.unsafe(`select ${TASK_COLS} from tasks where id = $1`, [id]);
     if (!existing.length) return err("not found", 404);
     const cur = { ...existing[0], ...patch };
     const completedAt = cur.status === "done" ? (existing[0].completed_at ?? new Date()) : null;
     const rows = await sql.unsafe(
       `update tasks set title=$2, notes=$3, status=$4, project_id=$5, context=$6, waiting_for=$7,
-         due_date=$8, defer_date=$9, completed_at=$10, sort_order=$11, updated_at=now()
+         due_date=$8, defer_date=$9, priority=$10, estimate_min=$11, repeat=$12, completed_at=$13,
+         sort_order=$14, updated_at=now()
        where id=$1 returning ${TASK_COLS}`,
       [id, cur.title, cur.notes, cur.status, cur.project_id, cur.context, cur.waiting_for,
-       cur.due_date, cur.defer_date, completedAt, cur.sort_order]);
+       cur.due_date, cur.defer_date, cur.priority, cur.estimate_min, cur.repeat, completedAt, cur.sort_order]);
     return json(rows[0]);
   }
 
@@ -115,11 +133,16 @@ async function handle(req: Request): Promise<Response> {
     const p = pick(body, PROJECT_FIELDS);
     if (typeof p.name !== "string" || !p.name.trim()) return err("name required", 400);
     if (p.status && !PROJECT_STATUSES.includes(p.status as string)) return err("bad status", 400);
+    const id = typeof body.id === "string" && UUID_RE.test(body.id) ? body.id : null;
     const rows = await sql.unsafe(
-      `insert into projects (name, status, notes, sort_order) values ($1, $2, $3, $4)
+      `insert into projects (id, name, status, notes, sort_order)
+       values (coalesce($1::uuid, gen_random_uuid()), $2, $3, $4, $5)
+       on conflict (id) do nothing
        returning ${PROJECT_COLS}`,
-      [p.name, p.status ?? "active", p.notes ?? "", p.sort_order ?? 0]);
-    return json(rows[0], 201);
+      [id, p.name, p.status ?? "active", p.notes ?? "", p.sort_order ?? 0]);
+    if (rows.length) return json(rows[0], 201);
+    const existing = await sql.unsafe(`select ${PROJECT_COLS} from projects where id = $1`, [id]);
+    return json(existing[0], 200);
   }
 
   m = path.match(/^\/v1\/projects\/([0-9a-f-]{36})$/);
@@ -153,6 +176,10 @@ Bun.serve({
   fetch: (req) =>
     handle(req).catch((e) => {
       console.error(e);
+      // Constraint violations are bad input, not server faults — 400 so
+      // offline clients drop the op instead of retrying it forever.
+      const errno = (e as { errno?: string }).errno ?? "";
+      if (errno.startsWith("23")) return err(`constraint violation: ${(e as Error).message}`, 400);
       return err("internal error", 500);
     }),
 });

server/schema.sql

@@ -23,6 +23,9 @@ create table if not exists tasks (
     waiting_for  text,           -- who/what is being waited on when status = 'waiting'
     due_date     date,
     defer_date   date,           -- hide from lists until this date
+    priority     int not null default 4 check (priority between 1 and 4),  -- 1=urgent … 4=low
+    estimate_min int check (estimate_min > 0),
+    repeat       text check (repeat in ('daily', 'weekdays', 'weekly', 'monthly', 'yearly')),
     completed_at timestamptz,
     sort_order   double precision not null default 0,
     created_at   timestamptz not null default now(),
@@ -31,3 +34,7 @@ create table if not exists tasks (
 
 create index if not exists tasks_status_idx on tasks (status);
 create index if not exists tasks_project_idx on tasks (project_id);
+
+-- Columns added after the initial deploy (create-if-not-exists won't alter).
+alter table tasks add column if not exists repeat text
+    check (repeat in ('daily', 'weekdays', 'weekly', 'monthly', 'yearly'));