Event Ledger

Track client events, payments received, expenses, and payments owed to workers/services — with a dashboard of money in and money out. Runs entirely in the browser, hosted on GitHub Pages; data is stored in a private GitHub repo so it follows you across devices.

Setup

Open https://eventledger-navy.vercel.app/ on any device and enter your password. That's it.

The Vercel functions in api/ hold the GitHub token (env vars GITHUB_TOKEN, SESSION_SECRET, DATA_REPO) and read/write data.json in the private data repo on your behalf. Sessions last 60 days per device; the 🔒 button signs out.

The older token-per-device mode still works when the app is served without the API (e.g. GitHub Pages).

Client statements (Google Sheets)

Settings → Client statements walks you through deploying statement.gs as a Google Apps Script web app (one time). Then Events → 📋 Client statement → pick a client → Create Google Sheet. The sheet has a Dashboard tab (summary, paid-vs-balance and billing-by-event pie charts, all transactions with date and method) and one tab per event with its payment history. Sheets land in your Drive folder "Event Ledger statements".

Money rules

• Total billed = closed cost
• Need to collect = billed − payments received
• Total expense = direct expenses + agreed vendor/worker amounts
• Expected profit = billed − total expense
• Need to pay = vendor amounts − vendor payments made
• Cash position = received − direct expenses − vendor payments made