WeekFlow is a focused personal execution system for one overloaded user. It is designed to reduce mental chaos across coursework, internship prep, interview prep, research, part-time work, health, life admin, social life, and random future intentions.

The product is intentionally list-first:

• Capture quickly into Inbox.
• Separate real tasks from vague future items.
• Keep flexible routines alive.
• Choose tomorrow intentionally.
• Journal / brain dump without losing thoughts.

WeekFlow is not a calendar sync platform, a Notion clone, or a generic productivity dashboard.

Calendar, Weekly Review, Templates, and Health Log still exist as secondary surfaces so existing functionality is preserved, but they are no longer the product center.

The core V1 lanes are intentionally separate:

• InboxItem is uncategorized capture.
• Task is real actionable work.
• RecurringRoutine and RoutineSession track flexible repeating commitments.
• FutureItem stores important later items that should not clutter active work.
• JournalEntry stores reflection and brain dumps.
• DailyPlan and DailyPlanItem represent intentional tomorrow planning.

Future review dates are reminders, not hard deadlines. Routines are often flexible targets, not fixed calendar events. Optional imported calendar events remain separate from task completion analytics.

• Next.js 16 App Router
• TypeScript
• Tailwind CSS v4
• Prisma v7 + PostgreSQL / Neon
• NextAuth v5
• shadcn/ui-style primitives
• Recharts for lightweight analytics
• React Hook Form + Zod
• date-fns + date-fns-tz

npm install

Copy the example file to both runtime locations:

cp .env.example .env
cp .env.example .env.local

Minimum local values:

DATABASE_URL="postgresql://YOUR_USER@localhost:5432/weekflow"
DIRECT_URL=""
NEXTAUTH_SECRET="any-local-dev-secret"
NEXTAUTH_URL="http://localhost:3000"
DEMO_USER_EMAIL="[email protected]"
DEMO_USER_PASSWORD="weekflow2024"
GOOGLE_CLIENT_ID=""
GOOGLE_CLIENT_SECRET=""

.env is used by Prisma CLI. .env.local is used by Next.js at runtime.

createdb weekflow

npm run db:migrate

npm run db:seed

The seed creates a realistic V1 demo: inbox clutter, active tasks, flexible routines, routine sessions, future items with review dates, journal entries, tomorrow plans, and a small optional calendar sample.

npm run dev

Open http://localhost:3000 and sign in with:

• Email: [email protected]
• Password: weekflow2024

Required:

• DATABASE_URL: application database connection string.
• NEXTAUTH_SECRET: secret for NextAuth sessions.
• NEXTAUTH_URL: canonical app URL.

Recommended for production:

• DIRECT_URL: direct Neon/Postgres connection used for migrations.
• DEMO_USER_EMAIL: seed/demo login email.
• DEMO_USER_PASSWORD: seed/demo login password.

Optional:

• GOOGLE_CLIENT_ID
• GOOGLE_CLIENT_SECRET

Google Calendar is optional. If those variables are blank, WeekFlow still runs normally and Settings shows calendar sync as unavailable.

For Neon, prefer sslmode=verify-full in Postgres URLs. If Neon gives you a URL ending in sslmode=require, the app normalizes that value at runtime before handing it to pg so Next dev does not show the SSL warning overlay.

Calendar sync is preserved as a secondary feature. To enable it:

1. Create OAuth 2.0 credentials in Google Cloud.
2. Add redirect URIs:

http://localhost:3000/api/calendar/google/callback
https://your-app.vercel.app/api/calendar/google/callback

3. Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET.

Imported calendar events are modeled as external fixed commitments, not tasks.

For Neon + Vercel:

• Use the pooled Neon URL for DATABASE_URL, preferably with sslmode=verify-full.
• Use the direct Neon URL for DIRECT_URL, preferably with sslmode=verify-full.
• Run production migrations with npm run db:deploy.
• Do not run npm run db:migrate against production.
• Changing Vercel environment variables requires a redeploy.

Prisma v7 uses driver adapters in this app. Do not add a url field back to datasource db in prisma/schema.prisma; CLI connection configuration lives in prisma.config.ts, and runtime connection setup lives in lib/prisma.ts.

WeekFlow uses America/New_York as the primary timezone. Date-only fields are stored as midnight in that timezone expressed as UTC. Use helpers in lib/timezone.ts for today, week boundaries, date parsing, review dates, due dates, routines, journal dates, and analytics buckets.