All projects
PERSONAL TOOL · FIREBASE

Chai Tracker

For the love of chai. And keeping count.

Chai Tracker application interface
From the repository · README

A snapshot of the project’s own documentation. Read the latest on GitHub ↗

Chai Tracker

A personal chai diary. Track each cup, its cost, and estimated caffeine remaining.

Open Chai Tracker

Features

  • Email and password sign-up/sign-in with Firebase Authentication.
  • Log any of 36 chai types, including caffeine-free teas, with its cost in rupees.
  • Backdate a cup by hours and minutes.
  • See estimated active caffeine, daily averages, total cost, and your three most consumed teas.
  • Open a history entry for its cost, time since consumption, and caffeine details.
  • Save entries in Cloud Firestore and keep your chosen light or dark theme across reloads.
  • Responsive layouts, keyboard-accessible dialogs, visible focus states, and reduced-motion support.

Caffeine estimates use the existing five-hour half-life calculation and 48-hour window. The redesign preserves the original calculations and data format.

Screenshots

Light theme, with sample records:

Chai Tracker in light mode

Dark theme, with the same sample records:

Chai Tracker in dark mode

Full desktop screenshots include the complete page, with padding on all four sides. They use isolated sample records, not personal records.

Design

The pink poster composition, Bricolage Grotesque typography, pill controls, and original chai illustrations follow the supplied design guide. Statistics and footer panels follow the selected theme. The font is hosted locally with its SIL Open Font License.

Stack

React 19, JavaScript, Tailwind CSS 4, Vite 6, Firebase Authentication, and Cloud Firestore. Hosted on the existing Vercel project.

Run locally

npm install

Create an ignored .env.local file with your Firebase project's values:

VITE_FIREBASE_APIKEY=your_api_key
VITE_FIREBASE_AUTHDOMAIN=your_auth_domain
VITE_FIREBASE_PROJECTID=your_project_id
VITE_FIREBASE_STORAGEBUCKET=your_storage_bucket
VITE_FIREBASE_MESSAGINGSENDERID=your_sender_id
VITE_FIREBASE_APPID=your_app_id

Enable email/password authentication and configure appropriate Firestore access rules for users/{uid} in your Firebase project. Existing service configuration and access rules are unchanged.

npm run dev

Checks

npx playwright install chromium
npm run lint
npm run build
npm test

Browser tests run the real components and auth provider with isolated Firebase adapters. They cover auth states, logging, backdating, merge writes, resets, failed saves, calculations, history details, themes, accessibility, and responsive layouts without accessing real records. See QA.md for verification details and limits.

THE IDEA

A problem worth exploring.

A personal favourite: a simple place to log chai, explore consumption history and keep track of the habit.

Inside the build.

  1. 01

    Firebase supports authentication and real-time data.

  2. 02

    Timestamped entries and detail modals make history easy to explore.

  3. 03

    A responsive interface keeps logging quick on smaller screens.

NEXT UPFraud Intelligence
HAVE SOMETHING IN MIND? Open to opportunities

Let’s build something
worth caring about.