Skip to main content

Dashboard Overview

Your Finanzapp dashboard is your financial command center. It provides a comprehensive view of your finances, including income, expenses, budgets, and financial goals.

Dashboard Components

The dashboard is designed to give you instant insights into your financial situation. Here’s what you’ll find:

Main Chart Visualization

The central feature of your dashboard is the interactive financial chart.
The main chart uses Chart.js to visualize your financial data over time. You can see trends in your income and expenses at a glance.
The chart displays on the dashboard preview (index.php:154-165) and shows:
  • Income trends over time
  • Expense patterns
  • Budget vs. actual spending
  • Monthly comparisons
Chart Interactions:
  • Hover over data points to see exact values
  • Click on legend items to show/hide specific data series
  • View different time periods (weekly, monthly, yearly)

Stat Cards

Below the main chart, you’ll find quick-reference stat cards that highlight key metrics.
Icon: Blue upward arrowDisplays: Total income for the selected periodExample: “2.540€” (index.php:167-176)Purpose: Quickly see how much money you’ve earned
Icon: Red downward arrowDisplays: Total expenses for the selected periodExample: “1.825€” (index.php:177-186)Purpose: Monitor your spending at a glance
Calculation: Income minus ExpensesColor-coded: Green for positive balance, red for negativePurpose: See your net financial position

Visual Elements

The dashboard includes floating visual elements for an engaging user experience:
  • Chart Line Icon: Represents financial analysis (index.php:191-193)
  • Wallet Icon: Symbolizes money management (index.php:194-196)
  • Piggy Bank Icon: Indicates savings goals (index.php:197-199)

1

Access Your Dashboard

After logging in, you’re automatically directed to your dashboard. You can also click the Home or Dashboard link in the navigation menu at any time.
2

Review Your Financial Overview

The top of your dashboard shows your key financial metrics:
  • Total Income: All income transactions
  • Total Expenses: All spending
  • Net Balance: Your financial position
3

Analyze the Chart

Examine the main chart to understand:
  • Spending patterns over time
  • Income consistency
  • Budget adherence
  • Trends that need attention
4

Quick Actions

Use the quick action buttons to:
  • Add a new transaction
  • Create a budget
  • Set a financial goal
  • Export your data

Dashboard Customization

Personalize your dashboard to focus on what matters most to you.

Time Period Selection

Change the time period displayed on your dashboard:
  • This Week: Current 7-day period
  • This Month: Current calendar month
  • This Quarter: Current 3-month quarter
  • This Year: Current calendar year
  • Custom Range: Select specific start and end dates
To change the time period:
  1. Click the time period dropdown in the top-right corner
  2. Select your preferred timeframe
  3. The dashboard automatically updates with the relevant data

Chart Type Selection

Visualize your data in different ways:

Line Chart

Best for viewing trends over time

Bar Chart

Ideal for comparing values across categories

Pie Chart

Perfect for showing expense breakdowns by category

Area Chart

Great for visualizing cumulative totals

Widget Configuration

Customize which widgets appear on your dashboard:
1

Access Dashboard Settings

Click the gear icon in the top-right corner of your dashboard or navigate to your user configuration page (app/userConfig.php).
2

Select Visible Widgets

Choose which dashboard components you want to see:
  • Income/Expense cards
  • Recent transactions list
  • Budget progress bars
  • Goal tracker
  • Upcoming bills
  • Savings summary
3

Arrange Widget Order

Drag and drop widgets to arrange them in your preferred order.
4

Save Your Layout

Click Save Changes to apply your dashboard customization.Your preferences are stored and will be applied every time you log in.

Dashboard Features

Quick Add Transaction

Add transactions without leaving the dashboard:
Click the + Add Transaction button to open a quick-add form overlay. Enter the basic details and save to immediately update your dashboard.
Quick Add Fields:
  • Transaction type (Income/Expense)
  • Amount
  • Category
  • Date
  • Description (optional)

Recent Transactions

See your latest financial activity:
  • View the 5-10 most recent transactions
  • Click on any transaction to view details or edit
  • Filter by transaction type

Budget Progress Indicators

Monitor your budget compliance:
  • Visual progress bars for each budget category
  • Color-coded indicators:
    • Green: Under budget
    • Yellow: Approaching limit (80-100%)
    • Red: Over budget
Budget Alert: When you exceed a budget, the dashboard displays a warning notification to help you stay on track.

Goals Tracker

Track progress toward your financial goals:
  • See all active goals
  • View completion percentage
  • Estimated time to goal completion
  • Quick actions to contribute toward goals

Dashboard Header

The header contains important navigation and user controls. Access all Finanzapp features from the header menu (includes/header.php):
  • Dashboard: Return to your main dashboard
  • Transactions: Manage all transactions
  • Budgets: Create and edit budgets
  • Goals: Set and track financial goals
  • Reports: View detailed financial reports
  • Export: Download your data

User Profile Menu

Click your avatar or name to access:
Access your account configuration page (app/userConfig.php) to:
  • Change your profile picture
  • Update your name
  • Change your password
  • Manage notification preferences
Safely end your session by clicking Logout (app/auth/logout.php).

Mobile Menu

On mobile devices, the navigation collapses into a hamburger menu (includes/mobileMenu.php):
  1. Tap the menu icon (☰) to open
  2. Access all navigation items
  3. Tap outside the menu or the X to close

Dashboard Notifications

Stay informed with real-time notifications:

Notification Types

Background: Green (#00C851)Examples:
  • “Transaction added successfully”
  • “Budget created”
  • “Goal achieved”
Configured in the Notyf notification system used throughout the app.
Background: Red (#ff4444)Examples:
  • “Failed to save transaction”
  • “Invalid amount entered”
  • “Connection error”
Background: Yellow/OrangeExamples:
  • “Budget limit reached”
  • “Unusual spending detected”
  • “Goal deadline approaching”
Background: BlueExamples:
  • “Tip: Set budgets to track spending”
  • “New feature available”
  • “Monthly report ready”

Dashboard Performance

Data Loading

The dashboard uses efficient data loading:
  • Initial Load: Core metrics and chart data load first
  • Progressive Loading: Additional widgets load as needed
  • Caching: Frequently accessed data is cached for faster performance
Loading Indicator: While data is loading, you’ll see animated placeholders or a loader animation (index.php:106-121).

Auto-Refresh

Your dashboard automatically refreshes:
  • When you add or edit transactions
  • When budgets are updated
  • When goals are modified
  • Every few minutes to show the latest data

Dashboard Best Practices

Pro Tips for Dashboard Usage:
  1. Check Daily: Review your dashboard each day to stay aware of your finances
  2. Set Time Periods Wisely: Use different time periods for different purposes (daily for spending, monthly for budgets)
  3. Customize Your View: Hide widgets you don’t use to reduce clutter
  4. Use Quick Actions: Take advantage of quick-add buttons to log transactions immediately
  5. Monitor Alerts: Pay attention to budget warnings and goal notifications

Troubleshooting

Solutions:
  • Refresh your browser
  • Clear browser cache
  • Check your internet connection
  • Try logging out and back in
Solutions:
  • Click the refresh button
  • Check if you’re still logged in
  • Verify transactions were saved successfully
Solutions:
  • Ensure JavaScript is enabled
  • Try a different browser
  • Check for browser extensions blocking scripts
  • Verify you have transactions for the selected time period

Transactions

Learn how to add and manage your financial transactions

Goals

Set up and track your financial goals

Export Data

Export your financial data in various formats

Build docs developers (and LLMs) love