Chore: initial

Author: bchewy

.gitignore

@@ -23,6 +23,7 @@
 # misc
 .DS_Store
 *.pem
+data/reminders.json
 
 # debug
 npm-debug.log*

CLAUDE.md

@@ -0,0 +1,47 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+npm run dev      # Start development server at localhost:3000
+npm run build    # Production build
+npm run lint     # Run ESLint
+```
+
+## Environment Variables
+
+Required in `.env.local`:
+- `RESEND_API_KEY` - API key from Resend
+- `RESEND_FROM` - Verified sender email in Resend
+
+Optional:
+- `GITHUB_TOKEN` - Avoids rate limits and enables private repo access
+
+## Architecture
+
+Next.js 16 app with App Router. Single-page UI with REST API endpoints.
+
+**Data Flow:**
+1. User adds reminder (repo, email, threshold) via UI
+2. Check runs (manual or cron) → fetches GitHub API → compares push date
+3. If stale (no push within threshold days) and not recently notified → sends email via Resend
+
+**Key Files:**
+- `src/lib/checker.ts` - Core logic: iterates reminders, checks staleness, triggers emails
+- `src/lib/github.ts` - GitHub API client for repo push status
+- `src/lib/mailer.ts` - Resend email wrapper
+- `src/lib/reminders.ts` - File-based storage CRUD (`data/reminders.json`)
+
+**API Endpoints:**
+- `POST /api/check` - Run check, send emails for stale repos
+- `POST /api/check?dryRun=1` - Preview without sending
+- `GET/POST/DELETE /api/reminders` - CRUD operations
+- `POST /api/test-email` - Verify Resend configuration
+
+**Storage:** Reminders persist to `data/reminders.json`. For serverless deployment, replace with a database.
+
+## Path Alias
+
+`@/*` maps to `./src/*`

README.md

@@ -1,36 +1,49 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+# GitHub Reminder
 
-## Getting Started
+Email nudges when a repository has not been pushed in a while.
 
-First, run the development server:
+## Setup
+
+1. Install dependencies:
+   ```bash
+   npm install
+   ```
+2. Create `.env.local` with these values:
+   ```bash
+   RESEND_API_KEY=
+   RESEND_FROM=
+   GITHUB_TOKEN=
+   ```
+
+Optional: set `GITHUB_TOKEN` to avoid rate limits or access private repos.
+`RESEND_FROM` must be a verified sender in Resend.
+
+## Run
 
 ```bash
 npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+Open `http://localhost:3000`.
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+## Usage
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+- Add a reminder in the UI (owner/repo, email, threshold days).
+- Click **Run check now** to send emails for stale repos.
+- Click **Dry run** to preview without sending.
+- Use **Send test email** to verify Resend.
 
-## Learn More
+## Cron / Scheduler
 
-To learn more about Next.js, take a look at the following resources:
+Hit the check endpoint on a schedule:
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
-
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+```bash
+curl -X POST https://your-app.example.com/api/check
+```
 
-## Deploy on Vercel
+Vercel Cron or a system cron job works fine.
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+## Storage
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+Reminders are stored in `data/reminders.json` (local file). If you deploy to
+serverless, move this to a real database.

package-lock.json

@@ -11,7 +11,8 @@
   "dependencies": {
     "next": "16.1.3",
     "react": "19.2.3",
-    "react-dom": "19.2.3"
+    "react-dom": "19.2.3",
+    "resend": "^6.7.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4",

package.json

@@ -0,0 +1,25 @@
+import { runReminderCheck } from "@/lib/checker";
+import { NextRequest, NextResponse } from "next/server";
+
+export const runtime = "nodejs";
+
+async function handleCheck(request: NextRequest) {
+  const dryRun = request.nextUrl.searchParams.get("dryRun") === "1";
+  try {
+    const summary = await runReminderCheck({ dryRun });
+    return NextResponse.json(summary);
+  } catch (error) {
+    return NextResponse.json(
+      { error: error instanceof Error ? error.message : "Check failed." },
+      { status: 500 },
+    );
+  }
+}
+
+export async function GET(request: NextRequest) {
+  return handleCheck(request);
+}
+
+export async function POST(request: NextRequest) {
+  return handleCheck(request);
+}

src/app/api/check/route.ts

@@ -0,0 +1,80 @@
+import { normalizeRepo } from "@/lib/github";
+import { addReminder, deleteReminder, listReminders } from "@/lib/reminders";
+import { NextRequest, NextResponse } from "next/server";
+
+export const runtime = "nodejs";
+
+function isValidEmail(value: string) {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
+}
+
+function isValidRepo(value: string) {
+  return /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(value);
+}
+
+function parseThreshold(value: unknown) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) {
+    return null;
+  }
+  const rounded = Math.round(parsed);
+  if (rounded < 1 || rounded > 365) {
+    return null;
+  }
+  return rounded;
+}
+
+export async function GET() {
+  const reminders = await listReminders();
+  return NextResponse.json({ reminders });
+}
+
+export async function POST(request: NextRequest) {
+  const payload = (await request.json()) as {
+    email?: string;
+    repo?: string;
+    thresholdDays?: number;
+  };
+
+  const email = payload.email?.trim() ?? "";
+  const repo = normalizeRepo(payload.repo ?? "");
+  const thresholdDays = parseThreshold(payload.thresholdDays ?? 3);
+
+  if (!isValidEmail(email)) {
+    return NextResponse.json(
+      { error: "Invalid email address." },
+      { status: 400 },
+    );
+  }
+
+  if (!isValidRepo(repo)) {
+    return NextResponse.json(
+      { error: "Repo must be in owner/name format." },
+      { status: 400 },
+    );
+  }
+
+  if (!thresholdDays) {
+    return NextResponse.json(
+      { error: "Threshold must be between 1 and 365." },
+      { status: 400 },
+    );
+  }
+
+  const reminder = await addReminder({
+    email,
+    repo,
+    thresholdDays,
+  });
+
+  return NextResponse.json({ reminder }, { status: 201 });
+}
+
+export async function DELETE(request: NextRequest) {
+  const id = request.nextUrl.searchParams.get("id") ?? "";
+  if (!id) {
+    return NextResponse.json({ error: "Missing reminder id." }, { status: 400 });
+  }
+  const removed = await deleteReminder(id);
+  return NextResponse.json({ ok: removed });
+}

src/app/api/reminders/route.ts

@@ -0,0 +1,29 @@
+import { sendReminderEmail } from "@/lib/mailer";
+import { NextRequest, NextResponse } from "next/server";
+
+export const runtime = "nodejs";
+
+export async function POST(request: NextRequest) {
+  const payload = (await request.json()) as { email?: string };
+  const email = payload.email?.trim() ?? "";
+
+  if (!email) {
+    return NextResponse.json({ error: "Missing email." }, { status: 400 });
+  }
+
+  try {
+    await sendReminderEmail({
+      to: email,
+      subject: "GitHub reminder: test email",
+      text: "This is a test email from GitHub Reminder.",
+      html: "<p>This is a test email from <strong>GitHub Reminder</strong>.</p>",
+    });
+  } catch (error) {
+    return NextResponse.json(
+      { error: error instanceof Error ? error.message : "Email failed." },
+      { status: 500 },
+    );
+  }
+
+  return NextResponse.json({ ok: true });
+}