TaskMaster — AI-Powered Habit Platform with Gamification

TaskMaster is an intelligent platform for building good habits and breaking bad ones, powered by AI (Anthropic Claude / Google Gemini) and a gamification system with points redeemable for real rewards. Built with Angular 19 and ready to ship as a native mobile app via Capacitor.

Leer en Español

Project status

Phase	Description	Status
Phase 1	Foundation (architecture, routing, models)	Completed
Phase 2	Habit system (CRUD, streaks, calendar)	Completed
Phase 3	Gamification (XP, levels, achievements, challenges)	Completed
Phase 4	AI integration (Anthropic Claude + Google Gemini)	Completed
Phase 4.1	Pre-backend elevation — Iter 1 (AI foundation)	Completed
Phase 4.2	Pre-backend elevation — Iter 2–7	In progress
Phase 5	NestJS backend + Rewards shop	Pending
Phase 6	Performance, PWA and polish	Pending

Highlights — Iter 1 elevation

The AI layer graduated from text-only responses to a real execution layer. Highlights:

Native tool-use from both providers. The coach chat now calls create_habit, adjust_habit and archive_habit through the Claude Tools API and Gemini Function Calling with a single provider-agnostic catalog.
HabitInsightEngineService: deterministic signals (best day of week, best hour, anchor habit, habits at risk, perfect weeks/months, category stats) feed every AI prompt with real data — no more hallucinated numbers.
Prompts extracted to src/app/core/prompts/ (system, coach, insight, recommendation) with an insight block that injects patterns into the model context.
Action chips in the chat: when the AI executes a tool, a tappable chip appears under the reply summarizing the change (success/error status + link to the created resource).
Tool loop with token budget (max 5 tool turns, maxTokens bumped to 2048 when tools are active).
Dispatcher (AIActionDispatcherService) validates tool args, calls the Observable-returning HabitService variants (createHabitReturning, updateHabitReturning, archiveHabitReturning) and correlates results by toolCallId.
AICoachRepository interface + injection token ready for multi-session persistence (implementation landing in Iter 4).
Debt removed: dashboard perfectWeeks/perfectMonths hardcode replaced by engine signals; gamification.service no longer writes localStorage directly (goes through repo via new saveChallenges); root app.component.html boilerplate deleted.
Unit tests: Jasmine/Karma specs for xp.utils, streak.utils and HabitInsightEngineService.

Features

Habit system

Create, edit, archive and delete habits
Types: build good habits or break bad ones
Frequencies: daily, weekdays, weekends, weekly, custom
7 categories: health, fitness, productivity, mindfulness, social, learning, custom
Completion tracking with full history
Streaks with smart calculation per frequency (non-scheduled days don't break the chain)
GitHub-style heatmap calendar
Completion rate and statistics

Gamification

XP system: gain experience on every habit completion
Levels: from Novice (1) to Legend (10) with exponential progression
16 predefined achievements across 6 categories (streak, consistency, variety, milestone, explorer, level)
Weekly challenges auto-generated
Redeemable points earned on level-up
Visual feedback: floating XP popups, level-up modal with particles, achievement toasts

Artificial Intelligence

Multi-provider: Anthropic Claude and Google Gemini with runtime switching
Native tool-use (Iter 1): the AI can create, adjust and archive habits directly from the chat
Action chips: every AI action is surfaced as a tappable chip linking to the created resource
Daily insight: personalized analysis of your habits backed by real signals from the insight engine
AI suggestions: new habit recommendations based on your profile and detected patterns
AI coach: conversational chat for motivation, advice and analysis (now with tool execution)
Offline fallback: pre-built motivational messages and contextual insights when no API key is configured
Flexible config: pick provider, model and API key from the profile screen
Supported models: Claude Sonnet 4, Claude Haiku 4.5, Gemini 2.0 Flash, Gemini 2.5 Pro/Flash

Dashboard

Personalized greeting by time of day
XP bar with current level
Quick stats (habits today, completions, points, best streak)
Daily progress bar
Active challenges
Today's habits with quick toggle
Best streaks view

UI/UX

Sidebar (desktop) and bottom nav (mobile)
Lazy-loaded routing per feature
Fluid animations (fade-in, slide-up, bounce, shimmer)
Toast notification system
Reusable modals
Accessibility support (prefers-reduced-motion)
Responsive components

Tech stack

Technology	Use
Angular 19.2	Frontend framework (standalone components, Signals, OnPush)
TypeScript	End-to-end static typing
Tailwind CSS v4	Utility-first styling (config-in-CSS)
Angular Signals	Reactive state
RxJS	Repository layer (Observable-based)
Jasmine + Karma	Unit testing
localStorage	Temporary persistence (until Phase 5)
Capacitor	Native Android/iOS apps

Architecture

src/app/
  core/
    interfaces/          # Repository contracts (InjectionToken)
    repositories/        # localStorage implementations
    services/            # Business logic (signals-based)
      habit-insight-engine.service.ts   # NEW — deterministic pattern engine
      ai-action-dispatcher.service.ts   # NEW — tool-call executor
      ai.service.ts                     # refactored — tool loop + snapshot
    utils/               # Helpers (dates, streaks, XP)
    providers/
      ai/
        anthropic.provider.ts           # rewritten — tool-use blocks
        gemini.provider.ts              # rewritten — functionCall/functionResponse
        tools/                          # NEW — tool catalog + translators
    prompts/                            # NEW — extracted prompt builders
  models/                # Domain types (ai.model extended with tool types)
  shared/
    components/
      layout/            # App shell, sidebar, bottom nav
      ui/                # Reusable (toast, modal, progress-bar, ai-coach-chat...)
    pipes/
  features/
    dashboard/
    habits/
    achievements/
    rewards/
    profile/

Key patterns

Repository pattern: data layer decoupled behind injection tokens, localStorage today — backend swap tomorrow
Signals + OnPush: fine-grained reactivity without zone.js overhead
Lazy loading: every feature loads on demand
Standalone components: no NgModules, explicit imports
Provider-agnostic AI tools: single catalog, per-provider translators (toAnthropicTools, toGeminiTools)

Install and scripts

# Install dependencies
npm install

# Development
npm start

# Production build
npm run build:prod

# Other scripts
npm run build          # standard build
npm run watch          # watch build
npm test               # unit tests (Karma)

Capacitor (Android/iOS)

Capacitor is integrated. File: capacitor.config.ts with webDir: dist/todo-app/browser.

# One-time platform install
npm i @capacitor/android @capacitor/ios
npx cap add android
npx cap add ios

# Update flow
npm run build:prod
npx cap sync

# Open native projects
npm run cap:android   # Android Studio
npm run cap:ios       # Xcode (macOS)

# Diagnostics
npx cap doctor

Windows notes

Run Capacitor commands from PowerShell or CMD (avoid Git Bash)
spawn EINVAL usually means Git Bash — switch shell
webDir = dist/todo-app/browser in capacitor.config.ts

Roadmap

Phase 4.1 — Iter 1 (Completed)

AI foundation with native tool-use
HabitInsightEngineService feeding all prompts
Prompts extracted, action chips in chat, debt removed
Unit tests for insight engine + xp/streak utils

Phase 4.2 — Iter 2–7 (In progress)

Iter 2: Live dashboard (hero card, focus-today, SVG sparklines, weekday bars)
Iter 3: Deep habits (wizard, templates, detail tabs, AI-powered creation)
Iter 4: Real coach (multi-session persistence, weekly review, streaming chat)
Iter 5: Gamification with soul (reward catalog with themes/avatars/titles, tiered achievements, streak milestone modals)
Iter 6: Profile + journeys + onboarding (dark mode, onboarding flow, 21/30/66-day journeys)
Iter 7: Mobile polish (local notifications, haptics, custom modals over native confirms)

Phase 5 — NestJS backend + Rewards shop

REST API with NestJS and PostgreSQL
JWT auth with Passport.js (local + Google OAuth)
Real rewards redeemable with points
Cloud sync with localStorage migration
Redemption history with status tracking

Phase 6 — Performance, PWA and polish

Zoneless change detection (experimental)
@defer blocks for heavy-component lazy load
PWA with Service Worker (cache-first + network-first)
Push notifications for reminders (Capacitor)
Virtual scrolling for long lists

Contributing

Fork the repo
Create a branch (git checkout -b feature/new-feature)
Commit your changes (git commit -m 'Add new feature')
Push the branch (git push origin feature/new-feature)
Open a Pull Request

TaskMaster — Transform your habits, transform your life

☕ Support the project

TaskMaster is and will remain an open-source project. However, keeping the infrastructure running, covering AI API costs (Claude and Gemini) and dedicating time to new features like the Real Rewards Shop takes resources.

If you find value in this tool and want to help it keep growing, any donation is hugely appreciated.

Platform	Link
PayPal	Donate here

Note: Your support directly funds AI credits so more users can enjoy personalized insights and the AI Coach.

TaskMaster — Plataforma de Habitos con IA y Gamificacion

TaskMaster es una plataforma inteligente para adoptar buenos habitos y dejar malos habitos, potenciada con IA (Anthropic Claude / Google Gemini) y un sistema de gamificacion con puntos canjeables por premios reales. Construida con Angular 19 y preparada para ejecutarse como app movil nativa con Capacitor.

Read in English

Estado del proyecto

Fase	Descripcion	Estado
Fase 1	Fundacion (arquitectura, routing, modelos)	Completada
Fase 2	Sistema de habitos (CRUD, rachas, calendario)	Completada
Fase 3	Gamificacion (XP, niveles, logros, desafios)	Completada
Fase 4	Integracion IA (Anthropic Claude + Google Gemini)	Completada
Fase 4.1	Elevacion pre-backend — Iter 1 (fundacion IA)	Completada
Fase 4.2	Elevacion pre-backend — Iter 2–7	En progreso
Fase 5	Backend NestJS + Tienda de premios	Pendiente
Fase 6	Rendimiento, PWA y polish	Pendiente

Novedades — Iter 1 de elevacion

La capa de IA paso de respuestas solo-texto a una capa real de ejecucion. Resumen:

Tool-use nativo en ambos proveedores. El chat del coach ya llama a create_habit, adjust_habit y archive_habit via Claude Tools API y Gemini Function Calling con un catalogo unico agnostico.
HabitInsightEngineService: signals deterministicos (mejor dia de la semana, mejor hora, habito ancla, habitos en riesgo, semanas/meses perfectos, categoria fuerte/debil) alimentan cada prompt con datos reales — se acabaron los numeros inventados.
Prompts extraidos a src/app/core/prompts/ (system, coach, insight, recommendation) con un bloque de patrones que inyecta los insights al contexto del modelo.
Action chips en el chat: cuando la IA ejecuta una tool, aparece un chip clickeable debajo de la respuesta con el resumen del cambio (estado exito/error + link al recurso creado).
Loop de tools con budget (max 5 turnos de tool-call, maxTokens subido a 2048 cuando hay tools activas).
Dispatcher (AIActionDispatcherService) que valida argumentos, llama a las variantes Observable de HabitService (createHabitReturning, updateHabitReturning, archiveHabitReturning) y correlaciona resultados por toolCallId.
Interface + injection token AICoachRepository listos para persistencia multi-sesion (implementacion en Iter 4).
Deuda removida: hardcode de perfectWeeks/perfectMonths en dashboard reemplazado por signals del engine; gamification.service ya no escribe localStorage directo (va por repo via nuevo saveChallenges); boilerplate de app.component.html borrado.
Tests unitarios: specs Jasmine/Karma para xp.utils, streak.utils y HabitInsightEngineService.

Caracteristicas

Sistema de habitos

Crear, editar, archivar y eliminar habitos
Tipos: construir buenos habitos o dejar malos habitos
Frecuencias: diario, entre semana, fines de semana, semanal, custom
7 categorias: salud, ejercicio, productividad, mindfulness, social, aprendizaje, custom
Tracking de completados con historial
Rachas con calculo inteligente por frecuencia (dias no programados no rompen la cadena)
Calendario heatmap estilo GitHub
Tasa de completado y estadisticas

Gamificacion

Sistema de XP: gana experiencia al completar habitos
Niveles: del Novato (1) al Leyenda (10) con progresion exponencial
16 logros predefinidos en 6 categorias (rachas, consistencia, variedad, hitos, explorador, nivel)
Desafios semanales generados automaticamente
Puntos canjeables que se ganan al subir de nivel
Feedback visual: popups de XP flotantes, modal de level-up con particulas, toasts de logros desbloqueados

Inteligencia Artificial

Multi-proveedor: Anthropic Claude y Google Gemini con cambio dinamico
Tool-use nativo (Iter 1): la IA puede crear, ajustar y archivar habitos directamente desde el chat
Action chips: cada accion de la IA aparece como chip clickeable con enlace al recurso
Insight diario: analisis personalizado respaldado por signals reales del motor de insights
Sugerencias IA: recomendaciones de nuevos habitos basadas en tu perfil y patrones detectados
Coach IA: chat conversacional para motivacion, consejos y analisis (ahora con ejecucion de acciones)
Fallback offline: mensajes motivacionales e insights contextuales cuando no hay API key configurada
Configuracion flexible: elige proveedor, modelo y API key desde el perfil
Modelos soportados: Claude Sonnet 4, Claude Haiku 4.5, Gemini 2.0 Flash, Gemini 2.5 Pro/Flash

Dashboard

Saludo personalizado con hora del dia
Barra de XP con nivel actual
Estadisticas rapidas (habitos hoy, completados, puntos, mejor racha)
Barra de progreso diario
Desafios activos
Lista de habitos de hoy con toggle rapido
Vista de mejores rachas

UI/UX

Navegacion con sidebar (desktop) y bottom nav (mobile)
Routing lazy-loaded para cada seccion
Animaciones fluidas (fade-in, slide-up, bounce, shimmer)
Sistema de notificaciones toast
Modales reutilizables
Soporte para accesibilidad (prefers-reduced-motion)
Componentes responsivos

Stack tecnologico

Tecnologia	Uso
Angular 19.2	Framework frontend (standalone components, Signals, OnPush)
TypeScript	Tipado estatico end-to-end
Tailwind CSS v4	Utility-first (config en CSS)
Angular Signals	Estado reactivo
RxJS	Capa de repositorios (Observable-based)
Jasmine + Karma	Testing unitario
localStorage	Persistencia temporal (hasta Fase 5)
Capacitor	Apps nativas Android/iOS

Arquitectura

src/app/
  core/
    interfaces/          # Contratos de repositorios (InjectionToken)
    repositories/        # Implementaciones localStorage
    services/            # Logica de negocio (Signals-based)
      habit-insight-engine.service.ts   # NUEVO — motor de patrones deterministico
      ai-action-dispatcher.service.ts   # NUEVO — ejecutor de tool-calls
      ai.service.ts                     # refactor — tool loop + snapshot
    utils/               # Utilidades (fechas, rachas, XP)
    providers/
      ai/
        anthropic.provider.ts           # reescrito — bloques tool-use
        gemini.provider.ts              # reescrito — functionCall/functionResponse
        tools/                          # NUEVO — catalogo + translators
    prompts/                            # NUEVO — builders de prompts extraidos
  models/                # Tipos del dominio (ai.model extendido con tool types)
  shared/
    components/
      layout/            # App shell, sidebar, bottom nav
      ui/                # Reusables (toast, modal, progress-bar, ai-coach-chat...)
    pipes/
  features/
    dashboard/
    habits/
    achievements/
    rewards/
    profile/

Patrones clave

Repository Pattern: capa de datos desacoplada detras de injection tokens, localStorage hoy — swap a backend manana
Signals + OnPush: reactividad fine-grained sin overhead de zone.js
Lazy loading: cada feature carga bajo demanda
Standalone components: sin NgModules, imports explicitos
Tools IA agnosticas del proveedor: un catalogo, translators por proveedor (toAnthropicTools, toGeminiTools)

Instalacion y scripts

# Instalar dependencias
npm install

# Desarrollo
npm start

# Build produccion
npm run build:prod

# Otros scripts
npm run build          # build estandar
npm run watch          # build en watch
npm test               # tests unitarios (Karma)

Capacitor (Android/iOS)

Capacitor esta integrado. Archivo: capacitor.config.ts con webDir: dist/todo-app/browser.

# Instalacion inicial de plataformas (una sola vez)
npm i @capacitor/android @capacitor/ios
npx cap add android
npx cap add ios

# Flujo de actualizacion
npm run build:prod
npx cap sync

# Abrir proyectos nativos
npm run cap:android   # Android Studio
npm run cap:ios       # Xcode (macOS)

# Diagnostico
npx cap doctor

Notas para Windows

Ejecutar comandos de Capacitor en PowerShell o CMD (evitar Git Bash)
Si aparece spawn EINVAL, asegurarse de no usar Git Bash
webDir = dist/todo-app/browser en capacitor.config.ts

Roadmap

Fase 4.1 — Iter 1 (Completada)

Fundacion IA con tool-use nativo
HabitInsightEngineService alimentando todos los prompts
Prompts extraidos, action chips en el chat, deuda removida
Tests unitarios para insight engine + xp/streak utils

Fase 4.2 — Iter 2–7 (En progreso)

Iter 2: Dashboard vivo (hero card, focus-today, sparklines SVG, barras por dia)
Iter 3: Habitos profundos (wizard, templates, tabs de detalle, creacion via IA)
Iter 4: Coach de verdad (persistencia multi-sesion, weekly review, chat streaming)
Iter 5: Gamificacion con alma (catalogo de recompensas con temas/avatares/titulos, logros con tiers, modales de milestone de racha)
Iter 6: Perfil + journeys + onboarding (dark mode, onboarding, journeys 21/30/66 dias)
Iter 7: Mobile polish (notificaciones locales, haptics, modales custom sobre confirms nativos)

Fase 5 — Backend NestJS + Tienda de premios

API REST con NestJS y PostgreSQL
Autenticacion JWT con Passport.js (local + Google OAuth)
Tienda de premios reales canjeables con puntos
Sincronizacion cloud con migracion desde localStorage
Historial de canjes con estados

Fase 6 — Rendimiento, PWA y polish

Zoneless change detection (experimental)
@defer blocks para lazy load de componentes pesados
PWA con Service Worker (cache-first + network-first)
Push notifications para recordatorios (Capacitor)
Virtual scrolling para listas largas

Contribuir

Fork el repositorio
Crea una branch (git checkout -b feature/nueva-feature)
Commit tus cambios (git commit -m 'Add nueva feature')
Push a la branch (git push origin feature/nueva-feature)
Abre un Pull Request

TaskMaster — Transforma tus habitos, transforma tu vida

☕ Apoya el proyecto

TaskMaster es y seguira siendo un proyecto de codigo abierto. Sin embargo, mantener la infraestructura, cubrir los costos de las APIs de Inteligencia Artificial (Claude y Gemini) y dedicar tiempo a desarrollar nuevas funciones como la Tienda de Premios Reales requiere recursos.

Si encuentras valor en esta herramienta y quieres ayudar a que siga creciendo, cualquier donacion es enormemente agradecida.

Plataforma	Enlace
PayPal	Haz una donacion aqui

Nota: Tu apoyo ayuda directamente a financiar los creditos de IA para que mas usuarios puedan disfrutar de los insights personalizados y el Coach IA.

Name		Name	Last commit message	Last commit date
Latest commit History 40 Commits
.vscode		.vscode
android		android
ios		ios
public		public
src		src
.editorconfig		.editorconfig
.gitignore		.gitignore
.postcssrc.json		.postcssrc.json
LICENSE		LICENSE
README.md		README.md
angular.json		angular.json
capacitor.config.ts		capacitor.config.ts
package-lock.json		package-lock.json
package.json		package.json
tsconfig.app.json		tsconfig.app.json
tsconfig.json		tsconfig.json
tsconfig.spec.json		tsconfig.spec.json

Folders and files

Latest commit

History

Repository files navigation

TaskMaster — AI-Powered Habit Platform with Gamification

Table of contents

Project status

Highlights — Iter 1 elevation

Features

Habit system

Gamification

Artificial Intelligence

Dashboard

UI/UX

Tech stack

Architecture

Key patterns

Install and scripts

Capacitor (Android/iOS)

Windows notes

Roadmap

Phase 4.1 — Iter 1 (Completed)

Phase 4.2 — Iter 2–7 (In progress)

Phase 5 — NestJS backend + Rewards shop

Phase 6 — Performance, PWA and polish

Contributing

☕ Support the project

TaskMaster — Plataforma de Habitos con IA y Gamificacion

Tabla de contenidos

Estado del proyecto

Novedades — Iter 1 de elevacion

Caracteristicas

Sistema de habitos

Gamificacion

Inteligencia Artificial

Dashboard

UI/UX

Stack tecnologico

Arquitectura

Patrones clave

Instalacion y scripts

Capacitor (Android/iOS)

Notas para Windows

Roadmap

Fase 4.1 — Iter 1 (Completada)

Fase 4.2 — Iter 2–7 (En progreso)

Fase 5 — Backend NestJS + Tienda de premios

Fase 6 — Rendimiento, PWA y polish

Contribuir

☕ Apoya el proyecto

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Contributors

Uh oh!

Languages