A self-hostable context-based task management app with customizable urgency scoring and flexible habit tracking.

I kept bouncing between task apps because they always turned into guilt machines. I wanted a way to easily see what tasks deserved my attention without the shame of seeing 40 overdue tasks.

unwhelm organises tasks by context (kitchen, coding, whatever) and calculates urgency scores so you always know what to work on next. It also handles habits without punishing you for broken streaks.

• Smart task sorting - urgency score based on due dates, priority, age, and custom tags. Heavily inspired by TaskWarrior.
• Context-based organisation - group tasks by where you do them or what project they belong to. Each context tracks its own "health" based on how well you're keeping up with habits.
• Add tasks with natural language - easily add tasks with smart parsing: task name !context #tags p1 tomorrow
• Flexible habits - four types with different UI emphasis:
  • Streak habits (exercise) show your current streak prominently
  • Learning habits (reading) have a more moderate streak display
  • Wellness habits (skincare) balance streaks with frequency
  • Maintenance habits (cleaning) just show when you last did them
• The basics - subtasks, recurring tasks, tags, search, archiving contexts, completion history, analytics.

• Better analytics
• Offline support

For detailed setup instructions, see installation.md.

Demo Account:

• Email: demo@unwhelm.app
• Password: password123

Development:

npm install
npm run db:push
npm run db:seed
npm run dev

Open http://localhost:3000 to see the application.

• Frontend: Next.js 15 with App Router, React 19 Server Components, TypeScript
• Database: PostgreSQL with Prisma ORM
• Authentication: NextAuth.js v4 with credentials provider
• Styling: Tailwind CSS + shadcn/ui components
• Icons: Lucide React

# Development
npm run dev              # Start development server
npm run build           # Build for production
npm run start           # Start production server
npm run lint            # Run ESLint

# Database
npm run db:push         # Push schema changes to database
npm run db:seed         # Seed database with sample data
npm run db:migrate      # Run database migrations
npm run db:generate     # Generate Prisma client
npm run db:studio       # Open Prisma Studio

DATABASE_URL="postgresql://username:password@localhost:5432/unwhelm"
NEXTAUTH_SECRET="your-secret-key-here"
NEXTAUTH_URL="http://localhost:3000"