How fuzailsami/budger-tracker works
Budget Tracker is a shared household budget app: household members sign in or join with an invite code, then manage a common expense ledger, budget settings and categories, and review spending through history, analytics and Excel export. The client coordinates authentication and data loading, calls the API, and presents those distinct views. The API routes authenticate requests and use PostgreSQL for household data. The README documents several user-facing capabilities whose route internals were not sampled; those connections are shown only where documented or supported by the source index.
Main entry points: App.jsx App coordinator · index.js Express API app · db.js PostgreSQL · requireAuth.js Auth middleware
Components 20
Client experience
- App coordinator
Budget_Tracker/client/src/App.jsx - Sign-in screen
Budget_Tracker/client/src/components/AuthScreen.jsx - Expense ledger
Budget_Tracker/client/src/components/LedgerTab.jsx - History and export
Budget_Tracker/client/src/components/HistoryTab.jsx - Spending analytics
Budget_Tracker/client/src/components/AnalyticsTab.jsx - Budget settings
Budget_Tracker/client/src/components/SettingsTab.jsx - Shared UI and periods
Budget_Tracker/client/src/shared.jsx
Identity and access
- Session context
Budget_Tracker/client/src/context/AuthContext.jsx - Account routes
Budget_Tracker/server/src/routes/auth.js - JWT services
Budget_Tracker/server/src/auth.js - Auth middleware
Budget_Tracker/server/src/middleware/requireAuth.js
Budget API
- API client
Budget_Tracker/client/src/api.js - Express API app
Budget_Tracker/api/index.js - Expense routes
Budget_Tracker/server/src/routes/expenses.js - Category routes
Budget_Tracker/server/src/routes/categories.js - Budget and invites
Budget_Tracker/server/src/routes/config.js - Excel export
Budget_Tracker/server/src/routes/export.js - Period calculations
Budget_Tracker/server/src/period.js
Persistence
- PostgreSQL
Budget_Tracker/server/src/db.js
Other components
- Household member
Connections 35
- Household member → App coordinator: uses
README.md - App coordinator → Sign-in screen: shows
Budget_Tracker/client/src/App.jsx - App coordinator → Expense ledger: shows
Budget_Tracker/client/src/App.jsx - App coordinator → History and export: shows
Budget_Tracker/client/src/App.jsx - App coordinator → Spending analytics: shows
Budget_Tracker/client/src/App.jsx - App coordinator → Budget settings: shows
Budget_Tracker/client/src/App.jsx - App coordinator → Session context: reads session
Budget_Tracker/client/src/App.jsx - App coordinator → API client: loads and updates
Budget_Tracker/client/src/App.jsx - Sign-in screen → Session context: submits credentials
Budget_Tracker/client/src/components/AuthScreen.jsx - Session context → API client: requests identity
Budget_Tracker/client/src/context/AuthContext.jsx - App coordinator → Shared UI and periods: uses period and UI helpers
Budget_Tracker/client/src/App.jsx - Expense ledger → Shared UI and periods: uses display helpers
Budget_Tracker/client/src/components/LedgerTab.jsx - History and export → Shared UI and periods: uses display helpers
Budget_Tracker/client/src/components/HistoryTab.jsx - Spending analytics → Shared UI and periods: uses display helpers
Budget_Tracker/client/src/components/AnalyticsTab.jsx - Budget settings → Shared UI and periods: uses display helpers
Budget_Tracker/client/src/components/SettingsTab.jsx - API client → Express API app: calls API
README.md - Express API app → Account routes: mounts
Budget_Tracker/api/index.js - Express API app → Budget and invites: mounts
Budget_Tracker/api/index.js - Express API app → Category routes: mounts
Budget_Tracker/api/index.js - Express API app → Expense routes: mounts
Budget_Tracker/api/index.js - Express API app → Excel export: mounts
Budget_Tracker/api/index.js - Account routes → JWT services: signs tokens
Budget_Tracker/server/src/routes/auth.js - Account routes → PostgreSQL: reads and writes accounts
Budget_Tracker/server/src/routes/auth.js - Account routes → Auth middleware: protects identity lookup
Budget_Tracker/server/src/routes/auth.js - Auth middleware → JWT services: verifies tokens
Budget_Tracker/server/src/middleware/requireAuth.js - Auth middleware → PostgreSQL: loads household membership
Budget_Tracker/server/src/middleware/requireAuth.js - Expense routes → Auth middleware: requires authentication
Budget_Tracker/server/src/routes/expenses.js - Expense routes → PostgreSQL: reads and writes expenses
Budget_Tracker/server/src/routes/expenses.js - Category routes → Auth middleware: requires authentication
Budget_Tracker/server/src/routes/categories.js - Category routes → PostgreSQL: manages categories
Budget_Tracker/server/src/routes/categories.js - Budget and invites → PostgreSQL: reads and updates settings
Budget_Tracker/server/src/routes/config.js - Excel export → Auth middleware: requires authentication
Budget_Tracker/server/src/routes/export.js - Excel export → PostgreSQL: reads expenses
Budget_Tracker/server/src/routes/export.js - Excel export → Period calculations: groups export periods
Budget_Tracker/server/src/routes/export.js - Express API app → PostgreSQL: initializes when configured
Budget_Tracker/api/index.js