RetireSmart — Complete User Guide

Everything you need to know about using RetireSmart, from adding your first holding to running full Monte Carlo retirement simulations for your whole family.

App Overview

RetireSmart is a personal finance and retirement planning app for Android. It does four things:

  1. Tracks your investment portfolio — stocks, ETFs, real estate, cash, pensions, and more, all with live prices
  2. Models your retirement — goal planner, Monte Carlo simulation, and drawdown analysis
  3. Manages your full balance sheet — assets minus liabilities = your true net worth
  4. Supports your whole family — separate profiles for every family member, each with their own plan

💡 All your data — main profile and every family member profile — is securely stored in the cloud (Supabase). Everything syncs automatically across reinstalls and devices when you sign in with the same account. Your data is never sold or shared with third parties.

Free vs Pro

FeatureFreePro
Holdings trackedUp to 3Unlimited
Asset typesReal Estate onlyAll types
LiabilitiesMortgage onlyAll types
Monte Carlo Forecast
Drawdown Planner
Family profiles1 profileUp to 5 member profiles
Shared Household Assets
PDF Export
DCA Reminders

First Launch & Sign In

When you first open RetireSmart, you'll see an onboarding walkthrough explaining the key features. After that, you'll be asked to sign in.

1Set your goal (optional) — Enter your retirement target amount and how many years you have. You can skip this and set it later in the Planner tab.
2Sign in — Enter your name and email address. Your account is stored securely in the cloud so your data syncs across reinstalls and devices.
3Holdings Tab opens — You'll land on the Portfolio screen with three starter holdings: SPY (S&P 500 ETF), AAPL (Apple), and GOOGL (Alphabet). The SPY edit sheet opens automatically — enter how many shares you own and tap Save. Do the same for AAPL and GOOGL, or delete them if you don't own them.
4Add more holdings — Free users can track up to 3 holdings total. The + Add Holding button shows how many free slots remain (e.g. "0 of 3 free slots remaining"). Upgrade to Pro for unlimited holdings.

RetireSmart has three main tabs at the top of the screen:

TabWhat it does
PortfolioYour investment holdings, other assets, liabilities, shared household, and net worth balance sheet
PlannerRetirement goal, Monte Carlo forecast, drawdown analysis, and net worth history graph
SettingsDark mode, privacy policy, user guide, support, and app info

Within the Planner tab there are three sub-tabs (the third varies by profile type):

Adding Holdings Manually

A "holding" is any stock, ETF, index fund, or other security you own.

1On the Portfolio tab, tap + Add Holding at the top.
2Type the ticker symbol — e.g. AAPL for Apple, SPY for the S&P 500 ETF, D05.SI for DBS (Singapore). The app will fetch the live price and full name automatically.
3Enter your number of shares.
4Tap Save. Your holding appears in the list with a live price and total value.

💡 Prices are fetched from Yahoo Finance in real time. Pull down on the Holdings screen to refresh all prices at once.

⚠️ Free plan: you can track up to 3 holdings. The + Add Holding button shows how many free slots remain ("X of 3 free slots remaining"). When all slots are used, tapping it shows the upgrade screen. Holdings you can't access on the free plan display a PRO 🔒 badge.

Supported Ticker Formats

ExchangeFormatExample
US (NYSE / NASDAQ)TICKERAAPL, MSFT, VTI
Singapore (SGX)TICKER.SID05.SI, G13.SI
Hong Kong (HKEX)TICKER.HK0700.HK
London (LSE)TICKER.LHSBA.L
Australia (ASX)TICKER.AXCBA.AX
Malaysia (KLSE)TICKER.KL1155.KL

Importing Holdings from a Screenshot Pro

Instead of typing each ticker manually, you can photograph or upload a screenshot of your broker's portfolio page and RetireSmart will extract all positions automatically using AI.

1On the Portfolio screen, tap the 📷 camera icon at the top right.
2Choose Take Photo (point your camera at your broker app) or Choose from Library (if you already have a screenshot).
3You can select up to 10 images at once to import from multiple pages.
4The AI reads the screenshot and extracts all ticker symbols and share counts. A review screen shows what it found.
5Review the extracted holdings, remove any incorrect ones, then tap Add X Holdings to confirm.

💡 Works best with clean, high-resolution screenshots. Make sure the ticker symbols are clearly visible. Supported brokers include Interactive Brokers, Tiger Brokers, Moomoo, TD Ameritrade, and most others.

⚠️ The AI import uses Google Gemini Vision. It reads ticker symbols and share counts but does NOT import prices — prices are always fetched live from Yahoo Finance.

Batch Import via CSV Paste Pro

If you already know your tickers and share counts, you can paste a comma-separated list to import multiple holdings at once — no screenshot or camera needed.

1On the Portfolio screen, tap the 📷 camera icon at the top right.
2Tap Paste list to switch to text input mode.
3Enter your holdings one per line in TICKER,SHARES format — for example:
AAPL,100
VTI,50
D05.SI,200
4Tap Import. The review screen appears — deselect any rows you don't want, then tap Add Holdings.

💡 You can also use a space instead of a comma: AAPL 100 works too. Each line is one holding.

Editing and Deleting Holdings

Edit shares or name

  1. Tap on any holding row to open the edit modal
  2. Change the share count, name, or ticker
  3. Tap Save

Quick share edit

If you see the hint "Tap any holding below to add your share count", just tap the holding directly to open it and enter your shares.

Delete a holding

  1. Tap the holding to open it
  2. Tap Delete at the bottom of the modal
  3. Confirm deletion

Reorder holdings

  1. Long-press any holding row until it lifts up (you'll feel a vibration)
  2. Drag it to the desired position
  3. Release to drop

Select multiple holdings

Tap the checkbox icon at the top of the Holdings screen to enter selection mode. You can then select multiple holdings and delete them all at once.

Clear all holdings

Tap the Clear button at the top right of the Holdings screen. You'll be asked to confirm before anything is deleted.

Undo

After any change (add, edit, delete, reorder), tap ↩ Undo in the top bar to reverse the last action.

Price Alerts

Set a price threshold on any holding and RetireSmart will notify you with a banner the next time prices are refreshed and that threshold is crossed.

Setting an alert

1Tap a holding row to open the edit modal.
2Scroll down to the Price Alert section.
3Choose the direction — Below (alert when price drops under your threshold) or Above (alert when price rises above it).
4Enter the threshold price and tap Save.

A 🔔 indicator appears on the holding row to remind you an alert is set.

When an alert fires

On the next price refresh, if a holding's live price crosses your threshold in the configured direction, an amber alert banner appears above the portfolio summary card. Tap to dismiss it.

💡 Alerts are checked every time you refresh prices — either by tapping ↻ Refresh or by pulling down on the Holdings screen. They don't fire as background push notifications; they appear while the app is open.

Organising Holdings into Sections Pro

Pro users can group holdings into labelled sections — e.g. "US Stocks", "Singapore", "Crypto", "Retirement Accounts".

Add a section

  1. Tap + Add Section on the Holdings screen
  2. Type a name for the section
  3. Tap Save

Move holdings between sections

  1. Long-press a holding to start dragging
  2. Drag it onto a different section header to move it there

Reorder sections

  1. Long-press a section header until it lifts
  2. Drag it to the desired position

Rename or delete a section

Tap the ✎ edit icon next to a section header to rename it, or tap the ✕ delete icon to remove it (holdings inside are moved to the default section).

Other Assets

Other Assets are non-stock investments that contribute to your net worth — real estate, cash, CPF/superannuation, pension funds, bonds, and more.

Asset types available

TypeIconExamplesPlan
Real Estate🏠Home, investment propertyFree
Cash & Bank💵Savings, fixed depositsPro
CPF / Retirement Fund🏦CPF OA/SA, EPF, 401kPro
Bonds📄Government bonds, SGSPro
Pension🏛️Defined benefit pensionPro
Business🏢Shares in a private companyPro
CryptoBitcoin, EthereumPro
Collectibles🎨Art, watches, winePro
Custom📋Anything elsePro

How to add an Other Asset

1Scroll down on the Portfolio screen past your stock portfolio to the Other Assets card.
2Tap + Add Asset or tap the + button next to a specific category (e.g. 🏠 Real Estate).
3Choose the asset type, enter a name, and enter the current value.
4For CPF/Pension types, you can also enter a monthly payout amount — this shows up as passive income in your retirement plan.
5Tap Save.

💡 The pie chart icon (📊) at the top of the Other Assets section shows a breakdown of your assets by category. Tap it to see the full chart.

Liabilities (Debts)

Liabilities are debts subtracted from your assets to calculate your true net worth. Adding them gives you an accurate picture of what you actually own vs. what you owe.

Liability types

TypeIconExamplesPlan
Mortgage🏠Home loan, apartment loanFree
Taxes🧾Income tax, property taxPro
Car Loan🚗Vehicle financingPro
Student Loan🎓University, study loansPro
Credit Card💳Outstanding card balancePro
Custom📋Any other debtPro

How to add a liability

1Scroll down on the Portfolio screen to the Liabilities card.
2Tap + Add Liability or the + button next to a specific category.
3Enter the outstanding balance (how much you still owe) and an optional monthly repayment amount.
4Tap Save.

💡 Liabilities are subtracted from your total assets to calculate net worth. The liabilities pie chart (📊) shows how your debt is split by category.

Shared Household Assets Pro

Shared Household is a special section visible to all family members — for assets jointly owned across the family, like a family home or a joint investment account. Unlike regular assets, you can assign a precise ownership percentage to each member — so a 60/40 split or even 100/0 (where one member has no share) is fully supported.

How to add a shared asset

1You must have 2 or more family profiles and be on Pro.
2Go to the Portfolio tab and scroll to 🏠 Shared Household (between Other Assets and Liabilities).
3Tap + Add Shared Asset. A bottom sheet modal opens.
4Enter the asset name (e.g. "Family Home") and the total value.
5Under OWNERSHIP %, each family member is listed with a percentage field. Adjust each person's share — e.g. 60% for one, 40% for another. Set to 0% if a member has no ownership at all.
6The Total at the bottom turns green when the percentages add up to exactly 100%. Tap Save Asset.

💡 Each member's dollar value (e.g. "Alice · 60% · $360,000") is shown as a chip under the asset name so you can see the split at a glance. The default split is equal across all members — adjust from there.

⚠️ The ownership must total exactly 100% before you can save. If the total is red, adjust the percentages until they balance.

Deleting a shared asset

Tap the button on the right of any shared asset row to delete it.

Exporting Your Portfolio as a PDF

Tap 📄 Export as PDF at the bottom of the Portfolio screen to generate a formatted PDF report of your holdings, other assets, liabilities, and net worth. The PDF is generated entirely on-device — no internet required.

1Scroll to the bottom of the Portfolio screen and tap 📄 Export as PDF.
2A folder picker appears — navigate to Downloads (or any folder) and tap Use this folder.
3The PDF is saved there instantly. You'll see a confirmation alert.
4To share it via WhatsApp or Gmail: open your Files app → find RetireSmart_Portfolio.pdf → tap Share → choose your app.

The PDF report includes:

💡 The PDF uses standard Helvetica fonts and is compatible with all PDF viewers — Adobe Acrobat, Google Drive, and more.

Portfolio Allocation Chart

Once your holdings have value (live price × shares > 0), the PORTFOLIO ALLOCATION card appears on the Portfolio screen. It shows a donut chart of your portfolio broken down by holding.

3-Scenario DCA Breakdown

Below the allocation chart and goal progress bar, the Portfolio tab shows how much you'd need to invest per month to hit your retirement goal under each market scenario:

ScenarioNominal ReturnWhat it means
🟠 Conservative7%/yrLower-growth markets — you need to save more
🟢 Base10%/yrLong-run average equity return — the middle ground
🔵 Optimistic13%/yrStrong-growth markets — you can save less

Each row shows the required monthly DCA (or "On track 🎯" if you're already funded). These numbers account for your existing portfolio and match the DCA figures in the Planner tab — the same starting portfolio, same real rates, same goal.

💡 The allocation chart only appears when at least one holding has a value greater than $0. Add your share counts to see your real allocation and DCA breakdown.

Net Worth History Graph

The Planner tab shows a line graph of your net worth over time. It records one snapshot per day when you open the app and refresh your prices.

💡 Snapshots are captured whenever your portfolio value is calculated after a price refresh. Open the app and tap Refresh regularly to build a rich history.

Goal Planner

The Goal tab is where you configure your retirement plan inputs. These drive all the calculations in the Forecast and Drawdown tabs.

Your Profile

Retirement Goal ($)

The total portfolio value you want to reach at retirement. This is the "number" — the amount that will sustain your lifestyle in retirement. A common rule of thumb is 25× your expected annual spending (the 4% rule).

Growth Scenario

ScenarioAnnual Return (nominal)Use for
Conservative7%Bond-heavy portfolio, near retirement
Base10%Balanced / broad-market portfolio (default)
Optimistic13%100% equities, long time horizon

💡 These scenario rates (7 / 10 / 13%) are fixed market return assumptions used for the Goal Planner and Portfolio DCA projections. The actual historical CAGR of your holdings (fetched from Yahoo Finance) is used exclusively for the Monte Carlo Forecast — it does not change the plan scenario rates.

💡 When Adjust for inflation is on, the app automatically deducts the inflation rate from each scenario's nominal return to compute a real rate — so the DCA numbers in the Planner and Portfolio tab always stay consistent with each other.

Inflation Adjustment

Toggle Adjust for inflation to see your goal in today's purchasing power. The default inflation rate is 3% — you can adjust this with the slider.

Lump Sum & Monthly Contributions

💡 Your existing retirement portfolio (stocks + other assets − liabilities that count toward your goal) is automatically treated as the starting value for projections. The stats card shows "Starting portfolio grows to" (when you have existing assets but no extra lump sum), "Lump sum grows to" (extra deposit only), or "Portfolio + lump sum grows to" (both). This future value is subtracted from your goal to calculate how much monthly DCA you still need.

Semi-Retirement Mode

Enable Semi-retire to model a two-phase retirement: first a period of reduced income (e.g. part-time work), then full retirement. Set:

💡 In semi-retire mode the growth chart starts from your existing retirement portfolio value — not from zero — so you can see how your current wealth compounds through both phases of the plan.

Reading the Result

After the inputs are filled in, the app calculates:

Forecast — Monte Carlo Simulation Pro

Monte Carlo simulation runs 1,000 random market scenarios using the historical volatility and return of your actual holdings. It shows you the range of possible outcomes — not just one average number.

How to read the results

💡 A "success rate" of 100% doesn't mean you're guaranteed to succeed — it just means all 1,000 simulated histories hit your goal. Markets can always surprise. Aim for 85–95% success as a practical target.

What drives the simulation?

Each simulation randomly samples monthly returns from a log-normal distribution calibrated to your portfolio's weighted average return (CAGR) and annual standard deviation (volatility). These are calculated from 5 years of monthly historical prices for each holding you own.

Retirement Drawdown Calculator Pro

The Drawdown tab answers: "If I retire with $X, how long will my money last?" It's the flip side of the accumulation phase — now you're spending, not saving.

Inputs

Reading the result

DCA Monthly Reminders

Set a monthly push notification to remind you to make your regular investment (Dollar Cost Averaging).

1Go to Planner tab → scroll to NOTIFICATIONS section.
2Toggle on Monthly Investment Reminder.
3Grant notification permission when prompted.
4Tap the day number you want to receive the reminder each month (e.g. tap 1 for the 1st of every month).

The reminder fires at 9:00 AM on your chosen day every month. Toggle it off to cancel.

Investment Streak

The streak tracker rewards consistency — it counts how many consecutive months you've made an investment.

Family Overview Pro

When you have 2 or more family profiles, a 📊 Overview chip appears at the left of the profile bar. Tap it to see a summary of all members' net worth in one place.

The overview shows:

Net worth figures are updated whenever you switch to a member's profile and prices are refreshed.

Family Report PDF Pro

Export a single PDF that shows the full household picture — all members' assets, liabilities, and net worth on one page.

1Tap 📊 Overview in the profile bar to open the Family Overview modal.
2Scroll down and tap 📄 Export Family Report as PDF.
3A folder picker appears — choose a folder (e.g. Downloads), then share the saved PDF from your Files app.

The family report includes:

💡 Net worth figures in the family report use each member's last-synced value. Switch to each profile and refresh prices first to ensure all figures are up to date before exporting.

Adding Family Members Pro

1Tap the + Add chip in the profile bar (requires Pro).
2Enter a name for the new profile (e.g. "Spouse", "Sarah").
3Choose Adult or Child.
4Tap Add Profile. The app immediately switches to the new profile with a clean starting point.

Each profile has its own completely separate holdings, assets, liabilities, and retirement plan. Switching profiles saves the current one and loads the new one instantly.

Switching Between Profiles

Tap any name chip in the profile bar at the top of the screen. The app saves your current profile and loads the selected one. You can also rename or delete profiles from the 📊 Overview modal.

⚠️ Always wait for the screen to finish loading before tapping another profile. Rapid switching during a price refresh may cause a brief delay.

Child Profiles

Child profiles are designed for planning an education fund or long-term gift for a child. They work differently from adult profiles in several ways:

Spending Tab (Child Profiles)

The Spending tab lets you model how the accumulated fund will be drawn down once the target age is reached:

Converting a Child to an Adult Profile 🎓

When a child grows up, you can graduate them to a full adult profile — keeping all their accumulated assets, holdings, and savings, while unlocking retirement planning tools.

1Long-press the child's name chip in the profile bar (or tap it if it's already active), and tap ✎ edit in the overview.
2In the Rename Profile sheet, tap the blue 🎓 Graduate to Adult button.
3Confirm the conversion. The profile is instantly upgraded to adult — all holdings, assets, liabilities, and saved investments are preserved.

After graduating:

💡 Graduation is permanent and cannot be undone through the app. If you need to revert, delete and recreate the profile as a child.

Settings Screen

Tap the ⚙ gear icon in the top-right corner of any screen to open Settings. From here you can:

Dark / Light / System Mode

RetireSmart fully supports dark mode, light mode, and following your device's system setting. Choose between them in Settings → Theme. Your preference is saved and restored on every launch.

Upgrading to Pro

Tap Upgrade in Settings, or tap the upgrade banner on the Portfolio screen, or tap the 🔒 lock on any Pro feature.

Pricing

PlanMonthlyAnnualLifetime
Pro — 1 person, cloud syncUSD $12.99/moUSD $94.99/yr (USD $7.92/mo)USD $299.99
Family — up to 6 people, all featuresUSD $21.99/moUSD $154.99/yr (USD $12.92/mo) · includes 7-day free trialUSD $449.99

Choose Pro for a single user or Family for up to 6 people on one subscription. Annual plans save up to 41% over monthly. The lifetime plan is a one-time payment — yours forever with no recurring fees.

💡 Prices above are USD reference prices. Google Play bills you in your local currency at checkout — the exact amount is shown on the payment sheet before you confirm.

Restoring purchases

If you reinstall the app or switch phones, tap Restore purchases at the bottom of the paywall to recover your Pro access.

Common Questions

My prices aren't updating — what do I do?

Tap the ↻ Refresh button at the top of the Holdings screen. If prices still don't update, check your internet connection. Yahoo Finance occasionally has brief outages — try again in a few minutes.

I added the wrong ticker — how do I fix it?

Tap the holding row to open the edit modal, then change the ticker to the correct one. The price will refresh automatically when you save.

The screenshot import didn't find my holdings — why?

Make sure the screenshot clearly shows the ticker symbols. Cropped or blurry screenshots may miss some positions. Try a higher-quality screenshot or add holdings manually.

My Monte Carlo success rate is 0% — is that right?

If your goal is very high compared to your current portfolio and you have few years to retire, the success rate can be near 0%. This is an honest answer — increase your monthly contributions, lower your goal, or extend your retirement timeline.

Can I use the app without internet?

Yes — your data is available offline. Your main profile syncs to the cloud, so the last-saved state is always accessible. Prices won't refresh until you reconnect, but your last-known prices remain displayed.

How do I sign out?

Tap the ⚙ gear icon → scroll to the Account section → tap Sign out. Your data remains safely in the cloud and will restore when you sign back in.

How do I delete my account?

Tap the ⚙ gear icon → scroll to the Account section → tap Delete Account. This permanently deletes your account and all data — holdings, plans, goals, and family profiles. This action cannot be undone. If you need help, email thefinancesanctuary@gmail.com.

I switched to a new phone — how do I transfer my data?

Everything is stored in the cloud. Simply install RetireSmart on your new phone, sign in with the same account, and all your data — main profile, family members, and child profiles — restores automatically. No export or manual re-entry needed.

How do I share the PDF via WhatsApp or Gmail on Android?

Tap Export as PDF, choose a folder (e.g. Downloads), then open your Files or My Files app. Find RetireSmart_Portfolio.pdf, long-press it, and tap Share to send it to WhatsApp, Gmail, or any other app.

Can I import holdings from a spreadsheet?

Yes — use the Batch CSV Import feature. Tap the 📷 camera icon → Paste list, then type or paste your holdings in TICKER,SHARES format (one per line). This is the fastest way to import if you already have a list of your positions.

The "Upgrade to Pro" button isn't working

Make sure you have a working internet connection and are signed in to your Google account on the device. If the paywall opens but the purchase doesn't complete, check that Google Play is up to date and your payment method is valid. If the problem persists, tap Restore purchases on the paywall — if you've already subscribed, this will recover your access. Still stuck? Email thefinancesanctuary@gmail.com.

The app shows "Something went wrong"

This is RetireSmart's safety screen — it appears if the app hits an unexpected error, so you never see a frozen or blank screen. Tap Restart App and the app will reload with all your data intact (everything is saved to the cloud as you go). If it keeps happening, email thefinancesanctuary@gmail.com with what you were doing when it appeared.

I forgot my password — how do I reset it?

On the sign-in screen, enter your email address, then tap Forgot password? below the password field. We'll email you a 6-digit code — enter it on the reset screen along with your new password, then tap Reset Password. You'll be signed in automatically. The code expires in 1 hour; if it doesn't arrive, check your spam folder or tap Resend code. If you signed up with Google, use Continue with Google instead — Google accounts don't use a password.

How do I cancel my subscription?

Subscriptions are managed by Google Play. To cancel: open the Google Play Store → tap your profile icon → Payments & subscriptionsSubscriptionsRetireSmartCancel subscription.

RetireSmart User Guide · For support, email thefinancesanctuary@gmail.com

This guide is for educational purposes. RetireSmart does not provide financial advice.