Skip to main content

Introduction

inundated is a lightweight, self-hosted app for tracking time across projects. It's built to run as a single binary (or container) against Postgres, with no required dependencies beyond a database.

What it does today​

  • Time tracking — log time entries against tags, and group tags into projects with optional time budgets.
  • Tasks — to-do items with subtasks, due dates and estimates, whose logged time rolls up into their projects.
  • Multi-user via OIDC — runs standalone with no login ("userless mode") by default, or behind any OpenID Connect provider once you want per-user accounts. See Authentication.

Tech stack​

LayerTechnology
BackendGo
FrontendVue 3 + Pinia + TypeScript + Vite
DatabasePostgreSQL (or an in-memory store for local dev)
API specOpenAPI 3

Where to go next​

  • New to running inundated? Start with Quick Start to get it up against a Postgres database.
  • Hacking on inundated itself? See Running Locally.