Skip to content
dbwg2009 edited this page May 4, 2026 · 2 revisions

Noted

A personal, AI-powered gift planning and birthday tracking app.

What it does

  • Stores people you care about with their birthdays, interests, sizes, and notes
  • Tracks wishlist items they've mentioned wanting
  • Uses AI (OpenRouter) to find real UK products with prices and buy links
  • Suggests gift ideas based on interests, history, and budget
  • Emails you reminder digests at 30, 14, 7, and 1 day before each birthday
  • Syncs birthdays to any calendar app via an iCal feed

Pages

Page What's in it
Getting Started Docker quick-start, native dev setup, first-run walkthrough
Architecture Data model, system diagram, Docker stack breakdown
Configuration Every environment variable explained
Development Guide Conventions, file layout, known gotchas
API Reference Cron endpoint, iCal feed, auth routes
Decisions Locked design decisions and change log

Status

All build phases complete (v1.0.0):

Phase Scope
0 Next.js + Tailwind + Drizzle + Auth.js + Docker stack
1 People & wishlists CRUD
2 AI product lookup (OpenRouter + eBay fallback)
3 Gift suggestions + gift history
4 Email reminders via Resend + daily cron
5 Photo uploads, iCal feed, mobile polish

Tech stack

Next.js 15 · TypeScript · PostgreSQL (Drizzle ORM) · Auth.js v5 · Tailwind v3 · OpenRouter AI · eBay Browse API · Resend · Docker

Clone this wiki locally