Headless Expense Tracker

A headless, framework-agnostic expense tracker with localStorage persistence, category management, and analytics.

What is HelpU Finance?

HelpU Finance is a free, privacy-first platform with financial tools and educational resources. No tracking, no data collection.

We believe that financial literacy should be accessible to everyone.

Installation

npm install @helpu/headless-expense-tracker

Usage

import { calculateExpenseSummary, createExpense } from '@helpu/headless-expense-tracker'

const result = createExpense({
  description: 'Groceries',
  amount: 85,
  category: 'food',
  date: '2026-01-15',
  paymentMethod: 'debit',
})

if (result.success) {
  const summary = calculateExpenseSummary([result.data])
  console.log(summary.totalAmount)
  console.log(summary.categoryBreakdown)
} else {
  console.error(result.error.message)
}

Use MemoryStorageAdapter or LocalStorageAdapter when you need persistence, and combine the filtering, sorting, and summary helpers for your application’s UI.

Testing

Install the repository dependencies and run the test suite with:

npm test

Contributing

Contributions are welcome. Please read the contribution guidelines before opening a pull request.

Support HelpU Finance through GitHub Sponsors.

License

This project is available for permitted non-commercial use under the PolyForm Noncommercial License 1.0.0.

Personal learning, education, research, experimentation, and other uses permitted by the PolyForm Noncommercial License are welcome.

Commercial use requires a separate license from Omisai Technologies.

Commercial licensing helps fund the HelpU Finance mission of creating freely accessible financial tools, educational resources, and technology.

For commercial licensing, see COMMERCIAL-LICENSING.md.

HelpU Finance is a project and brand of Omisai Technologies.