TimeTracker - Smart Time Tracking for Professionals

TimeTracker is a powerful, full-stack time tracking application built with Next.js that helps professionals, freelancers, and teams visualize their work hours, analyze productivity, and generate comprehensive reports. Track time across projects, monitor daily activity, and export data in multiple formats.

✨ Features

Core Functionality

⏱️ Real-time Timer - Start/stop timers with live duration updates (upcoming feature)
📊 Interactive Dashboard - Overview of today's activity, active timers, and quick actions
📅 Calendar View - Visual representation of time entries with daily breakdowns
📈 Advanced Analytics - Charts and graphs to visualize work patterns
📑 Multiple Export Formats - Export reports as PDF, Excel, or JSON
🏢 Project Management - Organize time entries by projects (Personal, Office, Client)
🏠 Workspace Tracking - Distinguish between Office and Home work
⚡ Time Adjustments - Add or subtract time with reason tracking

User Experience

🎨 Modern UI - Clean, professional interface with shadcn/ui components
🌓 Dark Mode - Seamless light/dark theme switching (upcoming feature)
📱 Responsive Design - Works perfectly on desktop, tablet, and mobile
🔍 Advanced Filtering - Filter reports by date, project, workspace
📊 Visual Analytics - Bar, line, and pie charts for data visualization

Security & Authentication

🔐 NextAuth.js Integration - Secure authentication with multiple providers
👤 User Isolation - Each user sees only their own data
🔒 Protected Routes - Authentication required for all tracking features

🛠️ Tech Stack

Frontend

Framework: Next.js 14 (App Router)
Language: TypeScript
Styling: Tailwind CSS
UI Components: shadcn/ui
Forms: React Hook Form + Zod
Charts: Recharts
Date Handling: date-fns
Data Fetching: SWR

Backend

API: Next.js API Routes
Database: PostgreSQL
ORM: Prisma
Authentication: NextAuth.js
Validation: Zod

DevOps & Tooling

Package Manager: npm
Code Quality: ESLint, Prettier
Git Hooks: Husky
Deployment: Vercel

🚀 Getting Started

Prerequisites

Node.js 18+
PostgreSQL database
npm

Installation

Clone the repository

git clone https://github.com/RashedAbdullah/time-entry.git
cd time-entry

Install dependencies
```
npm install
```
Set up environment variables
```
cp .env.example .env
```
Fill in your environment variables (see Environment Variables section)

Set up the database

# Run Prisma migrations
npx prisma migrate dev --name init

# Generate Prisma client
npx prisma generate

Run the development server
```
npm run dev
```
Open your browser Navigate to http://localhost:3000

Environment Variables

Create a .env file with the following variables:

# Database
DATABASE_URL="postgresql://username:password@localhost:5432/timetracker"

# NextAuth
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="your-secret-key-here"

📁 Project Structure

timetracker/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── (auth)/             # Authentication routes
│   │   │   ├── signin/
│   │   │   └── signup/
│   │   ├── (dashboard)/        # Protected dashboard routes
│   │   └── api/                 # API routes
│   │       ├── auth/
│   │       ├── projects/
│   │       ├── reports/
│   │       └── time-entries/
│   ├── components/              # React components
│   │   ├── auth/
│   │   ├── calendar/
│   │   ├── dashboard/
│   │   ├── layout/
│   │   ├── modals/
│   │   ├── projects/
│   │   ├── reports/
│   │   ├── time-entry/
│   │   └── ui/                  # shadcn/ui components
│   ├── hooks/                    # Custom React hooks
│   ├── lib/                      # Utilities, configurations
│   │   ├── api/
│   │   ├── utils/
│   │   └── validations/
│   └── types/                    # TypeScript type definitions
├── prisma/
│   ├── schema.prisma             # Database schema
├── public/                       # Static assets
└── ...config files

💾 Database Schema

// prisma/schema.prisma

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
}

model User {
  id          String           @id @default(uuid())
  name        String
  email       String           @unique
  password    String
  projects    Project[]
  timeEntries TimeEntry[]
  adjustments TimeAdjustment[]
  createdAt   DateTime         @default(now())
  updatedAt   DateTime         @updatedAt

  @@index([email])
}

model Project {
  id          String      @id @default(uuid())
  name        String
  description String?
  type        ProjectType @default(OFFICE)

  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
  userId String

  timeEntries TimeEntry[]

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  @@index([userId])
}

model TimeEntry {
  id String @id @default(uuid())

  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
  userId String

  project   Project? @relation(fields: [projectId], references: [id], onDelete: SetNull)
  projectId String?

  date DateTime // Entry date (normalized to 00:00:00)

  startDateTime DateTime
  endTime       DateTime?

  workspace   WorkspaceType @default(OFFICE)
  description String?

  adjustments TimeAdjustment[]

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  @@index([userId, date])
  @@index([projectId])
}

model TimeAdjustment {
  id String @id @default(uuid())

  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)
  userId String

  timeEntry   TimeEntry @relation(fields: [timeEntryId], references: [id], onDelete: Cascade)
  timeEntryId String

  minutes Int // Negative or positive
  reason  String?

  createdAt DateTime @default(now())

  @@index([userId])
  @@index([timeEntryId])
}

enum WorkspaceType {
  OFFICE
  HOME
}

enum ProjectType {
  PERSONAL
  OFFICE
  CLIENT
}

🔌 API Routes

Authentication

POST /api/auth/signup - Register new user
GET/POST /api/auth/[...nextauth] - NextAuth authentication

Projects

GET /api/projects - Get all projects for user
POST /api/projects - Create new project
GET /api/projects/[id] - Get project details
PATCH /api/projects/[id] - Update project
DELETE /api/projects/[id] - Delete project

Time Entries

GET /api/time-entries - Get time entries (with filters)
POST /api/time-entries - Create time entry
GET /api/time-entries/:date - Get today's entries
GET /api/time-entries/active - Get active timer
POST /api/time-entries/start - Start timer
POST /api/time-entries/stop - Stop timer
PATCH /api/time-entries/[id] - Update entry
DELETE /api/time-entries/[id] - Delete entry
POST /api/time-entries/[id]/adjust - Add time adjustment

Reports

GET /api/reports - Generate report with filters
GET /api/reports/export/pdf - Export as PDF
GET /api/reports/export/excel - Export as Excel
GET /api/reports/export/json - Export as JSON
GET /api/reports/monthly - Get monthly summary

🤝 Contributing

We welcome contributions from the community! Whether it's bug fixes, new features, or documentation improvements, your help is appreciated.

Contribution Guidelines

1. Fork the Repository

git clone https://github.com/RashedAbdullah/time-entry
cd time-entry

2. Create a Branch

git checkout -b feature/your-feature-name
# or
git checkout -b fix/your-bug-fix

3. Set Up Development Environment

Follow the Getting Started guide
Ensure all tests pass locally
Maintain code quality with ESLint and Prettier

4. Make Your Changes

Write clean, readable code
Add comments where necessary
Update documentation if needed
Add tests for new features

5. Commit Guidelines

We follow Conventional Commits:

feat: add new feature
fix: resolve bug
docs: update documentation
style: formatting changes
refactor: code restructuring
test: add tests
chore: maintenance tasks

6. Run Quality Checks

# Lint code
npm run lint

# Format code
npm run format

# Run tests
npm run test

# Type check
npm run type-check

7. Submit a Pull Request

Push to your fork
Open a PR to the main branch
Describe your changes in detail
Link any related issues

Development Workflow

Pick an Issue - Look for good first issues
Discuss - Comment on the issue to let others know you're working on it
Code - Follow the guidelines above
Review - Wait for maintainers to review your PR
Merge - Once approved, your PR will be merged

Code Style

Use TypeScript for all new code
Follow existing patterns in the codebase
Use functional components with hooks
Write meaningful component and variable names
Add JSDoc comments for complex functions
Keep components focused and modular

Reporting Issues

Found a bug? Please include:

Steps to reproduce
Expected behavior
Actual behavior
Screenshots (if applicable)
Environment details (browser, OS)

Feature Requests

Have an idea? Open an issue with:

Clear description of the feature
Use case and benefits
Mockups or examples (if applicable)

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

shadcn/ui for beautiful components
Next.js for the amazing framework
Vercel for hosting
All our contributors

📞 Contact & Support

Email: contact@rashedabdullah.com

Made with ❤️ by Rashed Abdullah
rashedabdullah.com

Name		Name	Last commit message	Last commit date
Latest commit History 30 Commits
prisma		prisma
public		public
src		src
.gitignore		.gitignore
README.md		README.md
components.json		components.json
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
prisma.config.ts		prisma.config.ts
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

TimeTracker - Smart Time Tracking for Professionals

✨ Features

Core Functionality

User Experience

Security & Authentication

🛠️ Tech Stack

Frontend

Backend

DevOps & Tooling

🚀 Getting Started

Prerequisites

Installation

Environment Variables

📁 Project Structure

💾 Database Schema

🔌 API Routes

Authentication

Projects

Time Entries

Reports

🤝 Contributing

Contribution Guidelines

1. Fork the Repository

2. Create a Branch

3. Set Up Development Environment

4. Make Your Changes

5. Commit Guidelines

6. Run Quality Checks

7. Submit a Pull Request

Development Workflow

Code Style

Reporting Issues

Feature Requests

📄 License

🙏 Acknowledgments

📞 Contact & Support

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages