Time Tracker

A web application for tracking work time and tasks with project organization, risk management, and Craft.do integration.

Features

• Project Organization: Group tasks under projects or keep them standalone.
• Risk Management:
  • 5x5 Heatmap Matrix: Visualize risk severity based on Likelihood and Impact.
  • Mitigation Register: Track mitigation plans and progress.
  • Risk-linked Tasks: Track specific mitigation time by linking tasks to risks.
  • PDF Export: Generate professional, executive-grade PDF reports of your project risk landscape.
• Task Management: Create, track, and complete tasks with timers.
• Time Tracking: Accurate duration tracking with pause/resume functionality.
• Notes: Auto-save notes for each task.
• Craft.do Integration:
  • Sync completed tasks and daily logs.
  • Sync project risk reports directly to Craft documents.
• Multi-user Support: Admin can create and manage user accounts.
• Dark Mode: Toggle between light and dark themes.
• History: View and edit completed tasks with date filtering.
• Local Timezone: All timestamps saved with user's local timezone.

Tech Stack

• Frontend: Next.js 16 (Turbopack), React, TypeScript, Tailwind CSS, shadcn/ui
• Backend: Next.js API Routes
• Database: SQLite with Prisma ORM
• Authentication: Session-based with bcrypt
• External API: Craft.do API integration
• PDF Generation: jsPDF & jspdf-autotable

Quick Start

Using Docker

# Pull and run from Docker Hub
docker run -d \
  -p 3000:3000 \
  -e NEXTAUTH_SECRET="your-secret-key" \
  -v ./data:/app/data \
  --name time-tracker \
  twlatx/timetracker:latest

Using Docker Compose

# Clone the repository
git clone https://github.com/tunwinlat/TimeTracker.git
cd TimeTracker

# Start with Docker Compose
docker-compose up -d

Manual Setup

# Install dependencies
npm install

# Setup database
npx prisma migrate dev

# Run development server
npm run dev

Environment Variables

Variable	Description	Default
DATABASE_URL	SQLite database path	file:./dev.db
NEXTAUTH_SECRET	Secret for session encryption	Required
NEXTAUTH_URL	Application URL	http://localhost:3000

Docker Images

Available on Docker Hub:

• twlatx/timetracker:latest
• twlatx/timetracker:v2.0.4

Usage

1. Projects: Add projects via the project bar to organize your work.
2. Risks: View the "Risks" tab within a project to manage threats and mitigation efforts.
3. Time Tracking: Tasks can be created globally or within projects.
4. Export: Use "Export PDF" in the Risks dashboard for professional reports.
5. Craft Integration: Sync your risks and daily progress to Craft.do for persistent documentation.

Limitations

• Browser Performance: Large data sets in history may impact rendering speed (pagination pending).
• SQLite: Best suited for individual or small team use; not recommended for high-concurrency enterprise scale.
• PDF Styling: PDF font supports standard characters; some special emojis or complex Unicode symbols may fallback to standard characters.

Version History

v2.0.4 (Latest)

• Risk Management: Added professional PDF export with color-coded heatmap and mitigation register.
• UI Refinement: Professional executive styling for project reports.
• Infrastructure: Optimized Prisma schema for Project-Risk-Task relationships.

v2.0.0

• Projects System: Added ability to organize tasks into projects.
• Risk Matrix: Integrated 5x5 Heatmap for project risk assessment.
• Dashboard Refresh: New multi-tab interface (Tasks/Risks/Timeline).

v1.1.0

• Fixed Craft sync: delete and recreate document on update to prevent duplicates.

v1.0.9

• Fixed time editing in history (start/end times now save correctly).
• Fixed Craft sync to properly replace content on updates.
• Improved timezone handling for Craft documents.

License

MIT