🕓 tickr v1.0 documentation

tickr

Precision real‑time clock · Relentless seconds‑elapsed counter 100% client‑side
💻 Browser‑native 💡 Serverless 🔒 No logs, no cookies Live +1s

This document describes the internal architecture, JavaScript mechanics, privacy guarantees, and security boundaries of tickr — a digital clock that tracks live seconds since January 1st of your chosen year.

1. Specific Function core

tickr is a precision digital clock that serves two primary purposes:

The tool is designed for users who need a precise, constantly updating reference of how much time has passed from a fixed annual benchmark to the present moment — whether for productivity tracking, project timelines, educational demonstrations, or simply to visualise the relentless passage of time.

🛠️ All calculations are performed entirely inside your browser using JavaScript's built‑in Date object and Unix timestamps. No data is ever transmitted.

2. Local JavaScript Mechanism under the hood

Every operation in tickr is executed 100% inside the browser's memory. No user input — not even the selected year — ever leaves the client.

// Core tick logic — runs every second
setInterval(() => {
  const now = new Date();
  const year = parseInt(yearSelect.value, 10);
  const start = new Date(year, 0, 1, 0, 0, 0, 0);
  const deltaMs = now.getTime() - start.getTime();
  const deltaSec = Math.floor(deltaMs / 1000);
  // update DOM — all local, no network
  document.getElementById('deltaSeconds').textContent =
    deltaSec.toLocaleString() + ' seconds';
}, 1000);

✅ This design guarantees that all processing happens in memory — nothing is serialised, stored, or transmitted outside the browser tab.

3. Dependencies / Libraries vanilla & zero

tickr has zero external dependencies. It is built entirely with vanilla JavaScript (ES6), standard HTML5, and plain CSS.

📜 Zero dependencies means zero supply‑chain risk. Every line of code is auditable, self‑contained, and immune to third‑party compromise.

4. Storage Limitations ephemeral

tickr does not persist any data — neither on the server (there is none) nor on the client beyond the current browser session.

🔒 Ephemeral by design — your interaction with tickr leaves no trace. This is not a limitation; it is a deliberate privacy guarantee.

5. Input Security zero‑exfiltration

tickr handles no sensitive user data in the traditional sense — it only processes a year selection and the current system time. Nevertheless, the security model is absolute: nothing ever touches the network.

// The only "input" is the year dropdown — processed locally
yearSelect.addEventListener('change', (e) => {
  // value stays in the browser — never sent anywhere
  const year = parseInt(e.target.value, 10);
  // … local calculation, DOM update …
});

// No fetch(), no XMLHttpRequest, no WebSocket
// No cookies, no localStorage, no IndexedDB

🛡️ Absolute input security is guaranteed by the architecture: the browser never initiates any outbound request containing user‑derived data. Your interaction with tickr is completely offline after the initial page load.

🕓 Ready to see time in motion?

Launch tickr and watch the seconds accumulate — live, relentless, private.

▶ Open tickr
🎯 zero‑tracking 💻 browser‑native 🔒 no server ⏲ relentless