Current product scope
Hosted AI and semantic search were retired on 2026-10-18. See docs/PUBLIC_CONTENT_FACTS.md and src/lib/product-availability.ts. Earlier AI setup notes below are historical.
First Light
Cloud engineering, isolated checks and release gates: operating workflow | prioritized backlog.
A calm place to get things done. Tasks, calendar, habits, Pomodoro — synced anywhere. task-manager–class, self-hosted, and yours. Web first; the architecture extends naturally to mobile (Capacitor) and desktop (Tauri / Electron) without changing the core code.
What's in v1
- Auth — email/password + magic link via Supabase
- Smart views — Today, Tomorrow, Next 7 Days, Inbox
- Lists (projects) with colors
- Tags auto-extracted from quick-add (
#tag)
- Quick add with natural-language parsing —
"Email Sam tomorrow 9am #work !1 ~Inbox"
- Priorities (4 levels)
- Calendar view with drag-to-reschedule
- Pomodoro timer with focus / short break / long break, session log
- Habits tracker with weekly grid
- Eisenhower matrix (urgency × importance)
- Search + command palette (
⌘K / Ctrl K)
- Real-time sync across tabs/devices via Supabase Realtime
- Dark / light theme
- PWA (installable; offline shell)
Stack
- Next.js 14 (App Router) + TypeScript
- Tailwind CSS
- Supabase (Postgres + Auth + Realtime)
- TanStack Query (server state) + Zustand (UI state)
- @dnd-kit (drag/drop)
- date-fns + chrono-node
- lucide-react icons
- next-themes, sonner
Getting started
1. Prerequisites
- Node.js 18+ and npm
- A free Supabase project
2. Install
npm install
3. Create the Supabase database
- Go to your Supabase project → SQL Editor
- Open
supabase/migrations/0001_init.sql from this repo
- Paste it into the SQL editor and Run
This creates all tables, indexes, RLS policies, and the trigger that creates a profile + default list when a new user signs up. It also enables Realtime on the relevant tables.
4. Configure environment
Copy .env.example → .env.local and fill in:
NEXT_PUBLIC_SUPABASE_URL=https://YOUR-PROJECT.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=YOUR-ANON-KEY
# Optional — enables AI features (Daily Edition, Weekly Retro, LLM quick-add,
# Smart Eisenhower). The app works without this; AI features are skipped.
ANTHROPIC_API_KEY=sk-ant-...
You'll find Supabase keys under Supabase → Project Settings → API. Get an Anthropic key at https://console.anthropic.com/.
AI features
When ANTHROPIC_API_KEY is set, the app turns on:
- Daily Edition — editorial morning briefing on the Today page, in a calm, magazine-style voice. Cached server-side per user per local date.
- Weekly review (
/app/retro) — last week's edition: what shipped, what slipped, what's worth dropping.
- LLM quick-add parser — quick-add and every inline "Add task" row run a Claude Haiku parse on submit, with the existing chrono-node parser as fallback. Understands richer natural language ("the Friday before the offsite", "after dentist before kids pickup").
- Smart Eisenhower —
AI · suggest button on the matrix page proposes moves for tasks that look misplaced; one-click apply.
- Voice capture — microphone button on every Add Task input. Uses the browser's built-in
webkitSpeechRecognition (no API key, no server round-trip).
- Anti-overload banner — Today view warns plainly when the day is over your daily capacity (default 4h), and offers to defer the lowest-priority task.
Costs are designed to be small: Haiku for parsing/quadrants, Sonnet for editorial briefings; daily and weekly outputs are cached.
5. Run
npm run dev
Open http://localhost:3000 — sign up, then you're in.
Keyboard shortcuts
| Shortcut | Action |
|---|
⌘K / Ctrl K | Command palette / search |
q | Quick-add task |
Esc | Close any open dialog |
Quick-add syntax
Email Sam tomorrow 9am #work !1 ~Inbox
| Token | Meaning |
|---|
| free text | task title |
tomorrow 9am, next monday, in 2 days | due date/time (chrono-node) |
#tag | adds a tag (creates if missing) |
!1–!4 | priority: 1 = High, 2 = Medium, 3 = Low, 4 = None |
~ListName | route to list (creates if missing) |
Deploy to Vercel
- Push this folder to GitHub.
- Import in Vercel → set the same env vars.
- Add your production URL to Supabase → Authentication → URL Configuration:
- Site URL:
https://yourdomain.com
- Redirect URLs:
https://yourdomain.com/auth/callback
That's it — clean cloud sync from any device that can open the URL.
Add PWA icons (optional but recommended)
Drop two PNGs in public/icons/:
icon-192.png (192 × 192)icon-512.png (512 × 512)
Anything visual will do — the manifest references them. (You can generate them quickly from any logo with a tool like realfavicongenerator.net.)
Roadmap — features still to build
This is a strong v1. Major task-management features still to build:
Extending to other devices
You picked "decide later" — here's the easy path when you're ready:
- PWA — already enabled. Visit on mobile Chrome / iOS Safari → "Add to Home Screen". Done.
- Native iOS/Android — wrap with Capacitor:
npx cap init && npx cap add ios && npx cap add android. The web app runs unchanged inside the shell; you only add native plugins for things like push notifications.
- Native desktop — wrap with Tauri or Electron. Same web bundle.
- Pure native rewrite — would replace this UI but keep Supabase, schema, RLS, and the realtime channel layout exactly as-is.
Project layout
first-light/
├── middleware.ts
├── next.config.mjs
├── package.json
├── tailwind.config.ts
├── tsconfig.json
├── public/
│ ├── manifest.webmanifest
│ ├── sw.js
│ └── icons/ # add icon-192.png and icon-512.png
├── supabase/
│ └── migrations/0001_init.sql
└── src/
├── app/
│ ├── layout.tsx
│ �
