A quick guide for new users: how to log spending, income, and balances - and how each part of the app fits together. When something can’t be saved or is invalid, the app shows a
dialog you can dismiss with OK or Escape; short success messages appear in the top bar next to the Saved status.
Settings & sidebar
Open Settings (sidebar, below the divider) for your profile photo, display name, currency, autosave interval, and month ledger cleanup.
-
Sidebar tabs: Checkboxes let you show or hide main items under Dashboard - Accounts, Expenses, Incomes, Transfers,
Subscriptions, Categories, Savings, Other, and Monthly summary. At least one must stay on. Click
Save settings (and sign in) to store the choice in your wallet on Drive. Hidden routes redirect to Dashboard if you had one open.
-
Always visible: Dashboard, Import CSV, Settings, Instructions, Privacy policy, and Contact.
Dashboard & month view
Use View month in the top bar to pick which calendar month you are working in. Most tables and charts only show rows for that month. The
Dashboard summarizes expenses, income, and net cash flow for the selected month and highlights simple suggestions (for example when a category is over budget or income beats an expected target).
-
Account activity lists each active account with Start balance (that month’s opening reference), Month change (ledger net for the month), and
Estimated balance (opening + that change).
-
Transfers this month and Active subscriptions load sit side by side (on wide screens): transfers are the month’s ledger transfers; subscriptions show each active service’s
monthly equivalent by charged account.
- Expense and income breakdowns can show budget or “expected” bars when you set those on the Categories page.
Monthly summary
Open Monthly summary from the sidebar (directly below Categories) for a read-only archive: one collapsible block per calendar month in your wallet, using that month’s opening balances and ledger rows.
Import CSV, Settings, Instructions, Privacy policy, and Contact live in their own sidebar group below a dividing line.
- Columns match the account recap: opening, income, expenses, transfers in/out, Month net, then Subs equiv /mo (active subscriptions billed to that account that overlap the month, normalized to a monthly cost).
- Net after subs is month net minus that subs column - an estimate of breathing room after recurring subscription load; End balance still follows the ledger only.
Accounts
Accounts are the real-world places money lives: checking, savings, or a credit card.
- Add each account with its opening balance (or zero) so running balances stay meaningful.
- Optional limit is for your own reference (e.g. credit line). Uncheck Active to retire an account - it stays on the Accounts page only and disappears from pickers and the dashboard.
- Expenses, incomes, and transfers always point at one or two accounts so the ledger stays consistent.
- A blue note on this page may flag accounts whose month change is negative for the selected month - worth checking cashflow.
Categories & income sources
Before you log a lot of transactions, set up expense categories (Groceries, Rent, etc.) and income sources (Salary, Side gig, …) on the
Categories page.
-
Optional monthly budget on an expense category feeds dashboard and pie views so you can see how much of that budget you have used.
-
Optional expected monthly on an income source helps compare what you planned to earn vs what you recorded.
Expenses
An expense is money leaving an account for spending: amount, date, category, account it was paid from, plus an optional title and note. Each row belongs to the month of its
date.
Incomes
Income rows record money arriving: amount, date, account that received it, and source (from your income-source list). Use them for salary, refunds, interest, and similar inflows.
Transfers
A transfer moves money between two of your accounts (for example checking → savings) without treating it as expense or income. Pick two different accounts and an amount for the month you care about.
Subscriptions
Subscriptions track recurring charges (streaming, insurance, loans, gym, etc.): service name, billing frequency, cost per period, charged account (required), status, and either start/end dates or installment counts (with a start date) so the app can show paid vs remaining amounts.
- They are separate from one-off expenses but help you see repeating outflows in one place and on the dashboard.
- Status uses color chips: Active (green-style), Paused (amber), Completed (neutral) - so you can scan the table quickly.
- The main table lists Active and Paused items. Completed subscriptions live in a section below that stays collapsed until you expand it - same columns and actions (edit/delete) for history.
- If several fields are wrong at once, a single dialog lists each issue; fix them and try again.
Savings tables (CSV)
The Savings screen holds separate flexible grids - monthly solar totals, fixed deposits, credit-card discount trackers, or anything you want as columns and rows. Data is stored as text cells in your wallet JSON.
To import, use Import CSV with one CSV per table, or build tables by hand. A typical CSV export from a spreadsheet or other tool gives a header row plus data rows - that works as long as the filename includes
saving or savings (e.g. credit-card-savings-1.csv). Headers can be anything:
Month, Due, Received; Name, Account, Date, Invoice Value, Paid, Saved, Annual Fee; extra columns like Discount % are fine - up to 20 columns.
-
Export or save a single table as CSV with a header row and one row per entry. Remove SUM footer rows from the export if you don’t want them as data (or keep them - they import like normal rows).
-
Name the file with saving or savings in it (hyphens/underscores OK). The filename (without
.csv) becomes the table topic in Savings (spaces instead of hyphens).
-
Import CSV → Choose CSV files → you can mix several savings CSVs and ledger CSVs in one batch → Upload & save. Each savings file appends one new table; existing Savings tables are not replaced.
-
Open Savings to edit descriptions, fix cells, or remove duplicates. Drag ⠿ on a card header to reorder tables - the order is stored in your wallet. Cell length limits match the in-app grid.
Other
The Other tab sits in the sidebar between Savings and Monthly summary. Use it for notes and simple lists that are not part of your ledger - ideas, packing lists, project to-dos, or a scratch table. Cards are saved in your wallet (and on Drive when you sync). There is no CSV import for this page, and Download all (Excel) does not export these cards.
-
Add card opens a dialog: choose a type (Text, Bullet list, Numbered list, To-do list, or Table), a topic (title), and an optional description.
-
Edit unlocks topic, description, and body fields. When you are not editing, the text is read-only, but to-do checkboxes still work so you can check items off anytime.
-
Drag the ⠿ handle on a card to change order. Use collapse on the header to hide the body, and Delete to remove a card (with a confirmation step).
-
Table cards behave like small spreadsheets: rename column headers in edit mode, add or remove rows, and more empty rows appear when you use the last one - handy for scratch notes; use Savings when you need larger grids or CSV import.
Import & backup
Import CSV sits in the lower part of the sidebar (below the divider), together with Settings, Instructions, Privacy policy, and Contact. Use
Choose CSV files to pick one or more CSVs. The Upload & save button appears after you select files: it imports into this device’s wallet, shows a short summary per file, then - if you are signed in with Google - saves to
your Drive in the same step.
Two kinds of import: (1) Ledger files follow the column layouts from this app’s Download CSV / Download all (Excel) - accounts, expenses, incomes, transfers, subscriptions, and category sheets (see the bullet list on the Import page).
(2) Savings files use saving/savings in the filename and your own headers; see Savings tables (CSV) above. You can upload both kinds together in one batch.
Download all (Excel) from Dashboard, Settings, or Import gives one workbook with ledger sheets only - it does not export Savings grids or Other cards. Keep savings backups via your imported CSVs or by copying tables on the Savings page; copy Other cards in the app if you need a text backup.
Per-page Download CSV buttons match what Import expects for each ledger table.
This page describes how TheWalletly handles information when you use the app. Our product is hosted as a web application; wallet data stays under your control when you sign in with Google Drive.
Effective date: April 27, 2026.
Summary
We do not operate a proprietary cloud database for your ledger. What you enter (accounts, expenses, income, subscriptions, preferences) normally lives in your browser session and, after you authorize Google Drive, inside
your Google account’s restricted app-data area. We aim to minimize data collection and to be transparent about the services involved.
What we collect and where it lives
-
Google Sign-In. If you authenticate, Google provides tokens and profile basics (such as email and display name) to the browser via Google’s OAuth and Identity APIs. Tokens needed for Drive access may be cached in browser storage so you stay signed in on this device.
-
Wallet file on Google Drive. When Drive access is granted, your combined wallet/state is saved as JSON in Drive’s application-specific folder (drive.appdata). Only your Google account - and apps you authorize - can reach that folder; TheWalletly does not receive a separate copy on our servers.
-
Local device settings. Values such as UI theme choice, optional OAuth client overrides, autosave cadence hints, profile photo (as data URLs), or similar preferences may be stored in browser storage (localStorage) and/or bundled into the wallet payload that syncs to Drive.
-
Usage analytics (optional). If the deployed build was produced with measurement tokens, the site may load Google Analytics 4 and/or Cloudflare Web Analytics to understand traffic (approximate pages, sessions, country/region, device category). Those providers process technical and aggregated data under their own terms. We do not use analytics to read your ledger fields.
Feedback submissions
When you submit the Contact form while signed in with Google, we send fields (name, email, topic, message) to Google’s Form endpoint so they appear in our response spreadsheet. Processing is governed by
Google’s Privacy Policy. Do not include banking credentials or full payment numbers in feedback.
How long we retain information
Ledger data persists until you delete the underlying Drive app file(s), revoke the app’s access in Google Account settings, or clear local demos. Tokens expire per Google policies; reconnect if prompted after idle periods.
Security
Use a modern browser over HTTPS whenever this app is deployed. Protect your Google account with two-factor authentication. Exports you download leave the app as files entirely under your control.
Children
TheWalletly is intended for adults managing household or personal budgets. Users under parental guidance should coordinate use with a supervising adult responsible for linked Google accounts.
Questions or changes