Zeiterfassung

A modern time tracking system built with Next.js.

Important

Please report Bugs and Feature Requests using the Github Issue Forum

~ Developed by SilberGecko

Features

• User-friendly time tracking interface
• Automatic and manual break management
• Comprehensive reporting and data export
• Administrator dashboard with detailed analytics
• Responsive design for desktop and mobile use

Installation

Prerequisites

• Docker and Docker Compose
• Git

Setup Steps

1. Clone the repository

git clone https://github.com/SilberGecko6917/Zeiterfassung.git
cd Zeiterfassung

2. Create a .env.production file using the template in .env.example

cp .env.example .env.production
nano .env.production

3. Build and start the application

docker compose up -d

Initial Configuration

1. Navigate to https://your-domain.com/install in your browser
2. Follow the setup wizard to create an admin account
3. Landing Page Configuration
   • To replace the default landing page with the login screen:

   # Add to .env.production
   NEXT_PUBLIC_REMOVE_LANDING=True

   • To disable auto redirect from loginpage to dashboard:

   # Edit .env.production
   NEXT_PUBLIC_LOGIN_REDIRECT=False

Updating

sudo ./update.sh

Development

npm i --legacy-peer-deps
npm run dev

Technical Stack

- Frontend: Next.js with TypeScript
- Database: SQLite via Prisma
- Containerization: Docker & Docker Compose
- Styling: Tailwind CSS