How adegbalajoshua/financeos works
FinanceOS turns a Google Sheet into a personal-finance dashboard and transaction manager. Users launch the dashboard from the Sheets menu, review cycle KPIs, budgets, accounts and receivables, and manage transactions; the API mediates dashboard requests and the finance engine calculates aggregates from sheet data. Separate menu workflows roll budgets into a new cycle, generate native Sheets analytics, and accept webhook transactions. The excerpts show key backend calls; frontend details and some API operations are documented in the README but not sampled, so those links cite that documentation.
Main entry points: api.js Dashboard API · dashboard.js.html Dashboard UI · database.js Sheets data access · menu.js Sheets menu
Components 19
User entry points
- Sheets menu
src/backend/menu.js
Dashboard and API
- Dashboard UI
src/frontend/dashboard.js.html - Dashboard views
src/frontend/components.js.html - Dashboard charts
src/frontend/charts.js.html - Dashboard motion
src/frontend/animations.js.html - Dashboard API
src/backend/api.js
Finance workflows
- Finance engine
src/backend/financeEngine.js - Transaction management
src/backend/api.js - Accounts and budgets
src/backend/api.js - Cycle rollover
src/backend/automation.js - Transaction webhook
src/backend/gateway.js
Persistence and configuration
- Sheets data access
src/backend/database.js - Application config
src/backend/config.js
Google Sheets integrations
- Sheets analytics
src/backend/analytics.js - Google Sheets
- Apps Script cache
- Apps Script services
Other components
- Sheets user
- Webhook client
Connections 27
- Sheets user → Sheets menu: opens menu
src/backend/menu.js - Sheets menu → Dashboard UI: launches
src/backend/menu.js - Sheets user → Dashboard UI: uses
README.md - Dashboard UI → Dashboard API: calls endpoints
README.md - Dashboard views → Dashboard UI: renders views
README.md - Dashboard charts → Dashboard UI: renders charts
README.md - Dashboard motion → Dashboard UI: animates views
README.md - Dashboard API → Finance engine: requests payload
src/backend/api.js - Dashboard API → Sheets data access: reads and writes
src/backend/api.js - Finance engine → Sheets data access: reads sheets
src/backend/financeEngine.js - Dashboard API → Apps Script cache: reads and clears
src/backend/api.js - Dashboard API → Finance engine: builds trends
src/backend/api.js - Transaction management → Sheets data access: persists changes
src/backend/api.js - Accounts and budgets → Sheets data access: manages records
src/backend/api.js - Sheets menu → Cycle rollover: starts workflow
src/backend/menu.js - Cycle rollover → Dashboard API: submits salary
src/backend/automation.js - Cycle rollover → Sheets data access: rolls budgets
src/backend/automation.js - Cycle rollover → Dashboard API: clears cache
src/backend/automation.js - Sheets menu → Sheets analytics: starts analytics
src/backend/menu.js - Sheets analytics → Finance engine: requests dashboard data
src/backend/analytics.js - Sheets analytics → Google Sheets: writes charts
src/backend/analytics.js - Webhook client → Transaction webhook: posts transaction
README.md - Transaction webhook → Dashboard API: submits transaction
src/backend/gateway.js - Sheets data access → Google Sheets: reads and writes
src/backend/database.js - Sheets menu → Apps Script services: uses UI services
src/backend/menu.js - Transaction webhook → Apps Script services: returns JSON
src/backend/gateway.js - Application config → Dashboard API: configures caching
src/backend/api.js