gitwtfhub

wtf is tempus-dominus?

eonasdan/tempus-dominus — explained in plain English

Analysis updated 2026-06-24

7,177HTMLAudience · developerComplexity · 2/5Setup · easy

TL;DR

A JavaScript date and time picker widget for web pages that shows a visual calendar and clock, requires only Popper2 as a dependency, and no longer needs jQuery or Bootstrap, though the project is no longer actively maintained.

Mindmap

mindmap
  root((Tempus Dominus))
    What it does
      Date picker
      Time picker
      Visual calendar
    Key changes v6
      No jQuery needed
      No Bootstrap needed
      TypeScript rewrite
    Tech stack
      TypeScript
      JavaScript
      Popper2
    Status
      Unmaintained
      Paid support only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Add a visual date and time picker to a web form without requiring jQuery or Bootstrap

REASON 2

Replace an older date-picker library in an existing project with one built in modern TypeScript

REASON 3

Let users pick both a date and a time in a single input field on a booking or scheduling web page

What's in the stack?

TypeScriptJavaScriptCSSPopper2

How it stacks up

eonasdan/tempus-dominusgetpublii/publiiblackrockdigital/startbootstrap
Stars7,1777,1857,161
LanguageHTMLHTMLHTML
Setup difficultyeasyeasyeasy
Complexity2/51/51/5
Audiencedeveloperwritervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Project is no longer actively maintained, new issues require paid sponsorship to be addressed.

The explanation does not mention the license type.

Wtf does this do

Tempus Dominus is a date and time picker for web pages, written in JavaScript. When added to a website, it gives users a visual calendar and clock interface for selecting a date, a time, or a combined date-and-time value. The library reached version 6.9.4 before its author announced the project is no longer actively maintained. Any new issues now require paid sponsorship to be addressed, and the author noted they are moving on to other projects. Version 6 was a substantial rewrite compared to its predecessor. It is written in TypeScript, a typed extension of JavaScript that tends to produce more predictable code. One of the key changes in version 6 is that several older dependencies are no longer required: Bootstrap (a CSS framework), Moment.js (a date formatting library), and jQuery (a JavaScript utility library) are all optional or removed. The only required external dependency is Popper2, which handles positioning the picker widget correctly on the screen relative to the input field the user clicks. A jQuery compatibility wrapper is included for projects that still depend on jQuery, though the README suggests moving away from it. The source code lives in a TypeScript project with a docs folder for the documentation site and a dist folder for built JavaScript and CSS files. Developers working on the library itself run npm i to install packages, then npm start to launch a local server with live rebuilding as they make changes. Running npm run serve shows the documentation site without watching for changes. The project accumulated over 7,000 GitHub stars during its active years, reflecting significant adoption in web development projects that needed a date-picker widget without heavy framework dependencies. Because it is now in a paid-support-only state, new users should consider whether a still-actively-maintained alternative better fits their needs. Existing projects that already use it can continue with the published releases, but should not expect free fixes or new features.

Yoink these prompts

Prompt 1
Using Tempus Dominus v6, add a date-and-time picker to a plain HTML form field without jQuery or Bootstrap, show the minimal setup code.
Prompt 2
How do I configure Tempus Dominus to show only a time picker and restrict selectable hours to 9am-5pm?
Prompt 3
In a web app using Tempus Dominus, how do I read the selected date-time value in JavaScript and send it to a backend API as an ISO string?
Prompt 4
Help me migrate a jQuery-based Tempus Dominus date picker to the v6 API that drops the jQuery requirement.

Frequently asked questions

wtf is tempus-dominus?

A JavaScript date and time picker widget for web pages that shows a visual calendar and clock, requires only Popper2 as a dependency, and no longer needs jQuery or Bootstrap, though the project is no longer actively maintained.

What language is tempus-dominus written in?

Mainly HTML. The stack also includes TypeScript, JavaScript, CSS.

What license does tempus-dominus use?

The explanation does not mention the license type.

How hard is tempus-dominus to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is tempus-dominus for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.