User Guide

How to read this guide

Each page is explained the same way: what it is for, what it can do, why it was added, and how a user is supposed to interact with it. That makes this a usage guide, not just a feature list.

  • Use the home page for entry and overview
  • Use Personal for your own money
  • Use Shared for group money
  • Use Money Plan to plan ahead
  • Use transactions to keep your records current
  • Use Analytics and Tips for review
Main navigation

/

Home dashboard

Why it exists

It gives a fast summary of the account so the user can start from one place instead of hunting through pages.

What it can do

  • Shows recent money activity and account summaries
  • Surfaces shared wallets, upcoming items, and shortcuts
  • Shows access to investments when available

How to use it

  1. Open Home first
  2. Use quick actions to jump to a task
  3. Use the bottom navigation when switching areas

/personal

Personal wallet

Why it exists

It keeps private money separate from group money so personal spending stays clean and easy to review.

What it can do

  • Track income and expenses
  • Review personal transactions and balances
  • Open analytics, tips, and upcoming items
  • Use AI assist for smarter entry when available
  • Use AI to clarify ambiguous source, category, or split records before saving

How to use it

  1. Open Personal to add your own record
  2. Choose income or expense
  3. Enter amount, category, source, and note
  4. Use AI Assist when you want the app to draft or clarify the transaction
  5. Review the preview, answer any clarification prompts, then save

/shared

Shared wallet

Why it exists

It gives a single source of truth for group spending where multiple people need the same record.

What it can do

  • Create or join shared wallets
  • Add members and track shared balances
  • Use shared analytics, tips, disputes, and transactions
  • Support invite code and QR join flows

How to use it

  1. Open Shared
  2. Create or join a wallet
  3. Open the wallet to work with its transactions and tools
  4. Use dispute flow for unclear records

/settings

Settings and profile

Why it exists

It gives the user a place to manage app-level details without mixing them into money workflows.

What it can do

  • Edit profile-related settings
  • Reach user guide and support links
  • Central access point for account-level preferences

How to use it

  1. Open Settings from the bottom nav or profile area
  2. Review or change your profile details
  3. Use it when you need account-level changes

/transactions

Transaction history

Why it exists

It provides one place to review recorded activity and find a transaction later.

What it can do

  • Browse transaction records
  • Open details for individual activity
  • Review dates, amounts, categories, and sources

How to use it

  1. Open Transactions from navigation or a wallet
  2. Review the list and available filters
  3. Open a record to inspect its details

/notifications

Notifications

Why it exists

It collects account and money activity alerts so you can follow changes that need attention.

What it can do

  • Review alerts about shared wallet activity
  • See relevant reminders and account notices

How to use it

  1. Open Notifications from the navigation or alert icon
  2. Read each notice and follow its link when more detail is needed
Getting started, account and privacy

Start by creating an account with your name, email, and password. Confirm your email if prompted, then sign in. You can also use Google when that option is available. The guide is public; money tools require you to sign in.

  1. Create or join a shared wallet only when you need to manage money with other people. Follow the invite link or enter the invite code you received.
  2. In Settings, edit your profile, choose display currency, theme, timezone, and financial display preferences.
  3. Use Privacy Masking to hide balances on screen. This is a display control and does not change your saved records.
  4. Use notification preferences to choose alerts and quiet hours, then save your changes.
  5. Use Security to change your password or sign out. Use Forgot password on the sign-in page if you cannot access your account.
  6. Use Export Data to download a copy of your records. Account deletion is available in Settings and requires confirmation.
  7. Open Help & Support to submit a support request and follow its replies. See Privacy Policy and Terms for data and service information.
  8. Use the interactive product tour from Settings to replay the guided introduction. Add G-Tracker to your device from the install prompt/help when available.
Pages for review and analysis

/accounts

Accounts

Why it exists

It lets the user organize money by source, because one person may use bank, cash, and mobile money all at once.

What it can do

  • Add, edit, and delete accounts
  • Set account type, balance, and color
  • View account transaction history and balances
  • Sync balances when records change

How to use it

  1. Open Accounts
  2. Create or edit an account when you need a new balance bucket
  3. Use history to inspect transactions tied to that account

/analytics

General analytics

Why it exists

It turns raw transaction data into a readable summary so the user can spot patterns faster.

What it can do

  • Show income and expense totals
  • Show average daily spend
  • Show top categories
  • Show charts for trend review
  • Filter by date range
  • Support AI-generated insight pages in wallet-specific analytics views

How to use it

  1. Open Analytics
  2. Choose the date filter you want
  3. Read the snapshot, trend chart, and category breakdown

/tips

Tips and education

Why it exists

It gives lightweight guidance so the user can make better decisions without digging through reports.

What it can do

  • Show personal money advice
  • Show shared money advice
  • Switch between personal and shared tabs
  • Tailor some advice to the user currency
  • Use AI-backed tip pages in wallet-specific views when configured

How to use it

  1. Open Tips
  2. Switch between Personal and Shared
  3. Read the advice and apply what fits your situation

/investments

Investments

Why it exists

It keeps investment tracking separate from ordinary money tracking so portfolio activity does not get mixed into daily spending.

What it can do

  • Create portfolios when allowed
  • Log gains, losses, cash in, cash out, and notes
  • Track updates, access, queries, and admin roles
  • Show portfolio charts and balances

How to use it

  1. Open Investments only if your account has access
  2. Create or select a portfolio
  3. Add updates and notes as the investment changes
  4. Grant access when you want other users to view or help manage it
Shared wallet detail pages

/shared/:id

Shared wallet detail

Why it exists

It is the main working surface for a shared group once the wallet exists.

What it can do

  • Show wallet summary, members, and transaction history
  • Open wallet analytics, tips, and disputes
  • Support transaction detail and edit flows
  • Support AI-assisted transaction entry and clarification

How to use it

  1. Open the shared wallet detail page
  2. Use the section buttons to move to analytics, tips, or disputes
  3. Use AI Parse when the transaction details are messy or incomplete
  4. Tap a transaction to inspect it or edit it when allowed

/shared/:id/disputes

Shared disputes board

Why it exists

It gives the group a place to question and resolve unclear shared records without hiding the history.

What it can do

  • Show dispute threads for the wallet
  • Show comments and votes
  • Resolve a dispute after review

How to use it

  1. Open Disputes from the shared wallet
  2. Create a dispute only when a record is actually wrong or unclear
  3. Add comments or vote on the dispute

/shared/transaction/:transactionId

Shared transaction detail

Why it exists

It makes one transaction inspectable on its own so the user can understand what happened before changing it.

What it can do

  • Show amount, category, creator, and date
  • Navigate to edit or dispute paths when appropriate

How to use it

  1. Open a transaction from a wallet
  2. Review the record details
  3. Edit or dispute it depending on its state and permissions

/shared/transaction/:transactionId/edit

Shared transaction edit

Why it exists

It gives an explicit edit surface instead of editing from a summary card where mistakes are easier to make.

What it can do

  • Edit transaction fields
  • Keep shared transaction correction separate from viewing

How to use it

  1. Open the edit page from transaction detail or wallet actions
  2. Change only the fields you need
  3. Save and review the result
Personal wallet detail pages

/personal/analytics

Personal analytics

Why it exists

It gives the user a wallet-specific view instead of mixing personal numbers with everything else.

What it can do

  • Analyze personal income and spending
  • Show transaction patterns by date and category
  • Use the same filter logic as the main analytics pages
  • Show AI insights when Groq is configured and there is enough data

How to use it

  1. Open Personal Analytics from the personal wallet
  2. Change the date filter
  3. Load AI insights when you want suggestions, warnings, or patterns
  4. Read the charts and category summary

/personal/tips

Personal tips

Why it exists

It gives advice that is specific to private spending behavior.

What it can do

  • Show practical advice for personal finance
  • Help the user save, review, and control spending
  • Use AI-generated tips when configured

How to use it

  1. Open Personal Tips from the personal wallet
  2. Read the suggestions
  3. Apply the ones that match the user’s situation

/personal/upcoming

Personal upcoming items

Why it exists

It lets the user plan future private spending and convert planning into actual records.

What it can do

  • Show upcoming plans and scheduled spending
  • Link planning to transactions and accounts

How to use it

  1. Open Upcoming from Personal
  2. Review or edit the future item
  3. Mark it completed when it happens
How the user should interact with the system

The app expects the user to do more than view data. It works best when the user is actively entering, checking, correcting, and planning money activity.

  • Enter transactions in the right area, not all in one place
  • Use shared wallets only when more than one person needs the record
  • Use disputes only when a shared record is wrong or unclear
  • Use Money Plan to prepare for upcoming expenses, not just to look at reports
  • Use analytics and tips to review and then change behavior
  • Review transactions regularly to keep your records current
  • Use AI as a helper for drafting, classifying, summarizing, and checking, not as an automatic final decision
How AI is used

Home assistant and support bubble

The home screen includes an AI companion that answers short questions about the app and can guide the user toward shared wallets, disputes, analytics, or AI input. The floating help assistant also gives concise guidance anywhere in the app.

Personal wallet AI

The personal wallet can use AI assist to turn a plain sentence into a transaction draft. When the AI is unsure, it asks for clarification instead of guessing. The user must review and confirm before saving.

Shared wallet AI

Shared wallets can use AI to parse messy transaction descriptions, help classify entries, and refresh a draft when the user adds more context.

Analytics and tips AI

Personal analytics can load AI insights after the user clicks a button, and shared analytics can load AI tips in the same way. Personal tips and shared tips also have AI-generated advice when the AI service is configured and there is enough activity to analyze.

Investment support AI

The investment area includes its own query and support flow so users can ask questions about portfolio activity and access. This keeps investment help separate from regular money tracking.

AI in G-Tracker is meant to reduce typing and improve clarity. It is not meant to override the user’s judgment. The user still decides what gets saved.

Why these pages were added
  • Home was added so the user can start in one place.
  • Personal was added so private money stays separate.
  • Shared was added so groups share one source of truth.
  • Money Plan was added so the user can plan ahead.
  • Accounts were added so multiple money sources stay organized.
  • Analytics and tips were added so the user can understand patterns and next steps.
  • Disputes were added so shared corrections stay auditable.
  • Investments were added so portfolio activity stays separate from daily money.
Practical rule

If something is private, put it in Personal. If it belongs to a group, put it in Shared. Use Money Plan or upcoming transactions to prepare for future expenses. Use Analytics, Tips, and Disputes to review records.