# Home Dashboard

<p class="doc-lead">The Home Dashboard is the main landing page after login. It gives a live view of sales, collections, and expenses through summary tiles, charts, and filters — plus quick buttons, global search, and access to user and company settings from the top bar.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/dashboard/README?id=overview">Overview</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Widgets &amp; graphs</span>
<div class="doc-toc-links">
<a href="#/dashboard/README?id=filters">Filters</a>
<a href="#/dashboard/README?id=summary-tiles">Summary tiles</a>
<a href="#/dashboard/README?id=graphs">Graphs</a>
<a href="#/dashboard/README?id=quick-buttons">Quick buttons</a>
<a href="#/dashboard/global-search">Global search</a>
<a href="#/dashboard/keyboard-shortcuts">Keyboard shortcuts</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Account</span>
<div class="doc-toc-links">
<a href="#/dashboard/README?id=user-icon">User icon options</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/dashboard/README?id=faq">FAQ</a>
<a href="#/dashboard/README?id=related">Related &amp; Videos</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview</h2>

After login you land on the **Home Dashboard** (unless your role opens a different module dashboard). The page combines filter controls, clickable summary tiles, charts, and quick actions. What you see depends on your **user role** and access settings.

<b>Home Dashboard</b>

<img src="dashboard/images/home-dashboard.webp" alt="Home Dashboard showing summary tiles, graphs, and filters" loading="lazy">

<hr class="doc-section-divider">

<h2 id="filters">Filters</h2>

At the top of the dashboard, filter all summary tiles, graphs, and linked data:

| **Filter** | **What it does** |
|------------|------------------|
| **Branch** | View data for a specific branch |
| **Employee** | View employee-specific transactions and performance |
| **Date** | Filter summary data, graphs, and transactions by a selected date range |

<img src="dashboard/images/home-dashboard4.webp" alt="Employee filter on Home Dashboard" loading="lazy">

*Figure: Employee filter*

<img src="dashboard/images/home-dashboard3.webp" alt="Date filter on Home Dashboard" loading="lazy">

*Figure: Date filter*

<hr class="doc-section-divider">

<h2 id="summary-tiles">Summary tiles</h2>

The top row shows headline figures for the selected filters. Each tile is **clickable** and opens the related transaction list or report.

<img src="dashboard/images/home-dashboard5.webp" alt="Summary tiles on Home Dashboard" loading="lazy">

| **Tile** | **What it shows** |
|----------|-------------------|
| **Total Sales** | Total sales value for the filtered period |
| **Cash Sales** | Sales settled in cash |
| **Credit Sales** | Sales on credit |
| **Credit Notes** | Credit note totals |
| **Open Sale Invoices** | Outstanding sale invoices |
| **Expense Claims** | Expense claim totals |
| **Total Collection** | Collections received |
| **Preapproved Invoices** | Preapproved sale invoices |

> **Note:** All summary data updates when you change branch, employee, or date filters.

<hr class="doc-section-divider">

<h2 id="graphs">Graphs</h2>

Three charts sit below the summary tiles. Each responds to the date filter at the top of the dashboard.

| **Chart** | **What it shows** |
|-----------|-------------------|
| **Sales &amp; Purchase** | Monthly and daily sales and purchase performance |
| **Income &amp; Expense** | Income vs. expenses for the selected period |
| **Expense pie chart** | Breakdown of expense categories |

<img src="dashboard/images/home-dashboard6.webp" alt="Sales and Purchase graph" loading="lazy" width="600">

*Figure: Sales &amp; Purchase graph*

<img src="dashboard/images/home-dashboard7.webp" alt="Income and Expense graph" loading="lazy" width="600">

*Figure: Income &amp; Expense graph*

<img src="dashboard/images/home-dashboard8.webp" alt="Expense category pie chart" loading="lazy" width="600">

*Figure: Expense pie chart*

<hr class="doc-section-divider">

<h2 id="quick-buttons">Quick buttons</h2>

The top bar includes shortcuts to common actions and navigation.

<img src="dashboard/images/home-dashboard9.webp" alt="Quick buttons on Home Dashboard" loading="lazy">

| **Control** | **What it does** |
|-------------|------------------|
| **Quick buttons** | Create Purchase Invoice, Sale Invoice, Customer, Inventory Transfer, Item Enquiry, and more |
| **Home button** | Return to the Home Dashboard from any screen |

<hr class="doc-section-divider">

<h2 id="global-search">Global search</h2>

Press <kbd>CTRL</kbd> + <kbd>K</kbd> (or <kbd>⌘</kbd> + <kbd>K</kbd> on Mac), <kbd>CTRL</kbd> + <kbd>SPACE</kbd>, or click the search icon in the top bar to search screens, transactions, customers, items, and reports from anywhere in Freespace.

| **Shortcut** | **Action** |
|--------------|------------|
| <kbd>CTRL</kbd> + <kbd>K</kbd> / <kbd>⌘</kbd> + <kbd>K</kbd> | Open Global Search |
| <kbd>CTRL</kbd> + <kbd>SPACE</kbd> | Open Global Search (also supported) |
| <code>SIL</code> | Jump to Sale Invoice list |
| <code>it</code> | Open Item Transactions |
| <code>si:#123#</code> | Find sale invoices matching bill number <code>123</code> |

<img src="dashboard/images/home-dashboard10.webp" alt="Global search dialog" loading="lazy">

See the full guide for acronym shortcuts, transaction codes, entity lookup, report shortcuts, quick actions, and the built-in calculator: <a href="#/dashboard/global-search">Global Search</a>.

For save, approve, list navigation, and Payment In shortcuts: <a href="#/dashboard/keyboard-shortcuts">Keyboard Shortcuts</a>.

<hr class="doc-section-divider">

<h2 id="user-icon">User icon options</h2>

Click the **User icon** in the top bar to open profile, user settings, company details, company settings, and transaction preferences.

<img src="dashboard/images/home-dashboard11.webp" alt="User icon menu options" loading="lazy">

| **Menu item** | **What it does** | **Full documentation** |
|---------------|------------------|------------------------|
| **Username** | View and edit user details, add signature, enable OTP, change password and username | <a href="#/settings/user-profile">My Profile</a> |
| **User Settings** | Per-user defaults (Field Sale App access, sale type, cash account), price/discount restrictions, and advanced transaction rules | <a href="#/settings/user-management?id=user-settings">Users → User Settings</a> |
| **Company Name** | Company details, bill header, registration numbers (GSTN, CIN, PAN, TRN, VAT), seal, custom fields, rounding rules | <a href="#/settings/company-details">Company Details</a> |
| **Company Settings** | Company-wide transaction defaults, rounding, and registration — affects all users | <a href="#/settings/company-settings">Company Settings</a> |
| **Transaction Preference** | Global transaction behaviour: future dates, tax method, due dates, bill centres, number series, footer notes | <a href="#/settings/transaction-preferences">Transaction Preference</a> |

<img src="dashboard/images/home-dashboard12.webp" alt="User profile details" loading="lazy">

*Figure: User profile*

<img src="dashboard/images/home-dashboard13.webp" alt="User settings" loading="lazy">

*Figure: User settings*

<img src="dashboard/images/home-dashboard14.webp" alt="Company details" loading="lazy">

*Figure: Company details*

<img src="dashboard/images/home-dashboard15.webp" alt="Company settings" loading="lazy">

*Figure: Company settings*

<img src="dashboard/images/home-dashboard16.webp" alt="Transaction preference" loading="lazy">

*Figure: Transaction preference*

See the linked settings pages for the complete field reference for each screen.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>What does the Sales &amp; Purchase graph show?</b><br>
Monthly and daily sales and purchase performance for the selected date filter. See <a href="#/dashboard/README?id=graphs">Graphs</a>.

<b>How can I filter dashboard data?</b><br>
Use the **Branch**, **Employee**, or **Date** filters at the top of the dashboard. All summary tiles and charts update when you change a filter. See <a href="#/dashboard/README?id=filters">Filters</a>.

<b>Are summary tiles clickable?</b><br>
Yes. Each tile opens the related transaction list or report for the current filter. See <a href="#/dashboard/README?id=summary-tiles">Summary tiles</a>.

<b>How do I open global search?</b><br>
Press <kbd>CTRL</kbd> + <kbd>K</kbd> (or <kbd>⌘</kbd> + <kbd>K</kbd> on Mac), or <kbd>CTRL</kbd> + <kbd>SPACE</kbd>, from anywhere in Freespace. See <a href="#/dashboard/global-search">Global Search</a>.

<b>Where can I change my password?</b><br>
User icon → **Username** → **Change Password**. See <a href="#/settings/user-profile">My Profile</a>.

<b>How do I prevent previous-day entries or cancellations for a user?</b><br>
User icon → **User Settings** → enable **Prevent previous date entry** or **Prevent cancel with allowed days**. See <a href="#/settings/user-management?id=user-settings">Users → User Settings</a>.

<b>Can I add a user signature on all transactions?</b><br>
User icon → **Username** → edit profile and add the signature in the **Other** section. See <a href="#/settings/user-profile">My Profile</a>.

<b>Can I add a company seal on all transactions?</b><br>
User icon → **Company Name** → **Other** section (**Company image**). See <a href="#/settings/company-details">Company Details</a>.

<b>How can I hide the company name in transactions?</b><br>
User icon → **Transaction Preference** → enable **Hide company name in view**. See <a href="#/settings/transaction-preferences">Transaction Preference</a>.

<b>Can I set a footer note for all transactions?</b><br>
User icon → **Transaction Preference** → **Common Footer Note**. See <a href="#/settings/transaction-preferences">Transaction Preference</a>.

<b>Can I restrict future-date transactions?</b><br>
User icon → **Transaction Preference** → disable **Allow future date transactions**. See <a href="#/settings/transaction-preferences">Transaction Preference</a>.

<b>Can I select multiple sale types or purchase types in invoices?</b><br>
User icon → **Transaction Preference** → enable **Multiple Sale Types** or **Multiple Purchase Types** in Number Settings. See <a href="#/settings/transaction-preferences">Transaction Preference</a> and <a href="#/settings/number-settings">Number Settings</a>.

<b>Can I assign cost centers in expenses?</b><br>
User icon → **Transaction Preference** → enable **Show Cost Center Field in Expense** and choose single or multiple cost center mode. See <a href="#/settings/transaction-preferences">Transaction Preference</a>.

<b>Can I configure rounding rules and default values for a company?</b><br>
User icon → **Company Name** or **Company Settings**. See <a href="#/settings/company-details">Company Details</a> and <a href="#/settings/company-settings">Company Settings</a>.

<b>Can I configure default values for a user?</b><br>
User icon → **User Settings** → **Default Values, Visibility &amp; Filter**. See <a href="#/settings/user-management?id=user-settings">Users → User Settings</a>.

<hr class="doc-section-divider">

<h2 id="related">Related Topics &amp; Videos</h2>

<ul>
<li><a href="#/settings/user-profile">My Profile</a> — User icon → <b>Username</b>: password, OTP, signature.</li>
<li><a href="#/settings/user-management?id=user-settings">Users → User Settings</a> — User icon → <b>User Settings</b>: per-user defaults and restrictions.</li>
<li><a href="#/settings/company-details">Company Details</a> — User icon → <b>Company Name</b>: registration numbers, seal, bill header.</li>
<li><a href="#/settings/company-settings">Company Settings</a> — User icon → <b>Company Settings</b>: company-wide defaults and rounding.</li>
<li><a href="#/settings/transaction-preferences">Transaction Preference</a> — User icon → <b>Transaction Preference</b>: global transaction behaviour.</li>
<li><a href="#/settings/user-management">User Management</a> — create users and assign roles (admin).</li>
</ul>

<b>Video — Home Dashboard overview</b>
<iframe width="560" height="315" src="https://www.youtube.com/embed/Bop5X88ngDM?si=mGjJDEp0ltvZQ0Fk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
