chris.pardy.family / time-bandit
This repository has no description
0
Fork 0

Configure Feed

Select the types of activity you want to include in your feed.

TypeScript 95.8%
CSS 3.0%
Dockerfile 0.6%
Shell 0.4%
HTML 0.2%
12 1 0

Clone this repository

https://git.vm.fail/chris.pardy.family/time-bandit https://git.vm.fail/did:plc:l4jt2k3mw34o6mwlx5ucejcc
ssh://git@knot1.tangled.sh:2222/chris.pardy.family/time-bandit ssh://git@knot1.tangled.sh:2222/did:plc:l4jt2k3mw34o6mwlx5ucejcc

For self-hosted knots, clone URLs may differ based on your setup.


Download tar.gz Download .zip
README.md

Time Log#

A time-tracking app on the AT Protocol. Multiple concurrent timers, arbitrary string tags on every entry, mobile-first (PWA later).

  • Frontend — React SPA (Vite, Tailwind CSS v4, shadcn/ui). Records live locally in IndexedDB (src/store/) and are evaluated client-side; the app is local-first.
  • Backend — HappyView, a lexicon-driven atproto AppView. Data is stored as private records in a permissioned space; the client syncs periodically. See deploy/ for the local Docker stack.
  • Lexicons — lexicons/xyz/pardisio/time/*.json (NSID authority xyz.pardisio.time).

Develop#

npm install
npm run dev        # Vite dev server → http://localhost:5173

The full stack (SPA behind Caddy + HappyView) runs via Docker — see deploy/README.md.

Scripts#

Script Description
npm run dev Vite dev server.
npm run build Build the SPA to dist/.
npm run preview Serve the built dist/.
npm run typecheck Type-check the app.

Layout#

index.html            Vite entry
src/main.tsx          React mount
src/App.tsx           Auth gating + sync boot + store snapshot (context)
src/components/       React UI: board, timer cards, log sheet, filter editor…
src/components/ui/    shadcn/ui primitives
src/index.css         Tailwind v4 theme (Momentum palette as shadcn tokens)
src/store/            IndexedDB store: db, entries, filters, ids, types
src/auth/, src/sync/  OAuth session + permissioned-space sync (framework-free)
src/pip/              Document Picture-in-Picture timers puck (framework-free)
shared/               Predicate type + evaluator (used by store + UI)
lexicons/             atproto lexicons (records + XRPC methods)
deploy/               Docker: Caddy + HappyView (mirrors the Fly.io topology)

Data model#

Two record types, mirrored by the local store:

  • entry — name (optional), description, startTime, endTime (absent = running), tags[]. Keyed by AT-URI.
  • filter — name, optional color, and a nestable boolean predicate (and/or/not, tagsInclude, startTime/endTime before/after). Filters are evaluated locally (shared/predicate.ts) and their colors mark matching entries.

Console helpers: window.timelog.clearAll() wipes the local cache, window.timelog.sync() forces a full sync, window.timelog.refresh() reloads the UI from the store.