Skip to content

README.md

Latest commit

 

History

History
76 lines (60 loc) · 2.28 KB

README.md

File metadata and controls

76 lines (60 loc) · 2.28 KB

worktime-calendar

Offline worktime calendar built with pure HTML/CSS/JavaScript. Features automatic hour balance, Italian public holidays, month locking, dark/light theme, printable reports and CSV/TXT export..Designed & engineered by (Viperhack89)

worktime-calendar

Offline worktime calendar for tracking working hours, balances and justifications — built with pure HTML, CSS and JavaScript.

Designed to be simple, transparent and usable without servers, databases or external dependencies.

✨ Features

  • 📅 Monthly work calendar with daily time entry (start / end)
  • ⏱️ Automatic hour calculation
    • Daily balance
    • Monthly total
    • Annual total
    • Displayed in HH:MM (human-friendly)
  • 🗓️ Italian public holidays
    • Fixed-date holidays
    • Easter Monday (Pasquetta) calculated automatically
  • 🔒 Month locking
    • Close a month to prevent further edits
    • Persistent across sessions
  • 🌙 Dark / Light mode
    • Toggle with one click
    • Preference saved locally
  • 🖨️ Print-ready layout
    • Clean, light, “HR / office-friendly”
    • Buttons and inputs hidden automatically
  • 📤 Export
    • TXT (human-readable report)
    • CSV (Excel / LibreOffice compatible)
  • 🐍 Watermark branding
    • Custom VIPER watermark in background
    • Visible on screen and in print (low opacity)
  • 💾 Offline-first
    • Uses localStorage
    • No internet connection required
    • No data ever leaves your machine

🧠 Design Philosophy

This project follows a few simple principles:

  • Offline by design – no backend, no tracking, no surprises
  • Transparent logic – calculations are visible and understandable
  • Human-readable output – no confusing decimal hours
  • Long-term usability – works today, tomorrow and in restricted environments

Perfect for:

  • personal worktime tracking
  • office / administrative use
  • environments with limited or no network access
  • users who want full control over their data

🛠️ Tech Stack

  • HTML5
  • CSS3 (CSS variables, print media queries)
  • Vanilla JavaScript
  • No frameworks
  • No build step
  • No dependencies

📦 Installation

  1. Clone or download the repository: 
    git clone https://github.com/<your-username>/worktime-calendar.git