First Launch
============

When you open Forgalis TradingJournal for the first time, the application creates a fresh database
and drops you into the **Dashboard** view. A setup checklist on the Dashboard guides you through
the essential configuration steps.



Creating Your First Database
----------------------------

FTJ automatically creates a default database file, the current database path is always visible in the **Settings** view.



Understanding the Sidebar
-------------------------

The left sidebar is your primary navigation. Currently available pages are:

.. list-table::
   :widths: 10 20 70

   * - |home_icon|
     - **Home**
     - KPIs, recent trades, quick actions, and charts.
   * - |trades_icon|
     - **Trades**
     - View, create, and edit individual trades with full journaling.
   * - |account_icon|
     - **Account**
     - Manage trading accounts and cash flows.
   * - |strategy_icon|
     - **Strategy**
     - Define strategies, confluences, and exit reasons.
   * - |rates_icon|
     - **Rates**
     - Manage exchange rates and lot sizes.
   * - |settings_icon|
     - **Settings**
     - Database management, time format, image constraints, and debug logging.
   * - |ctrader_icon|
     - **Brokers**
     - Connect to cTrader for automated trade imports.

.. |home_icon| image:: /_static/sidebar/sidebar_home.svg
   :height: 20px
   :alt: Home
.. |trades_icon| image:: /_static/sidebar/sidebar_trades.svg
   :height: 20px
   :alt: Trades
.. |account_icon| image:: /_static/sidebar/sidebar_account.svg
   :height: 20px
   :alt: Account
.. |strategy_icon| image:: /_static/sidebar/sidebar_strategy.svg
   :height: 20px
   :alt: Strategy
.. |rates_icon| image:: /_static/sidebar/sidebar_rates.svg
   :height: 20px
   :alt: Rates
.. |settings_icon| image:: /_static/sidebar/sidebar_settings.svg
   :height: 20px
   :alt: Settings
.. |ctrader_icon| image:: /_static/sidebar/sidebar_brokers.svg
   :height: 20px
   :alt: Brokers


Top Bar Controls
----------------

The top bar of the Dashboard provides the following controls:

.. note::
   These controls only affect the Dashboard view. They do not change the information
   or selections shown in other views such as Trades, Account, or Analytics.


.. image:: /_static/top_bar.png
   :alt: Top bar controls
   :align: center
|

- **Toggle Guide** - Toggle the dropdown workflow guide.
- **New Trade** - Opens a New Trade in the trades view.
- **Refresh** - Reloads all data and recalculates analytics.
- **Account Filter** dropdown - Filter the dashboard by "Live Only", "Demo Only", or "All".
- **Account Selector** dropdown - Choose a specific account or "All Accounts".
- **Reporting Currency** dropdown - Select the currency in which all P&L values are displayed (e.g. USD, EUR, NOK).
- **Database path** - A quick reference showing the current ``.db`` file path.

.. TODO: Replace with a screenshot of the top bar, annotated with labels for each control.

Next Steps
----------

Now that you know your way around, head to :doc:`your-first-trade` to log your first trade.