Getting Started Guide

Your finances,
finally on your Mac.

Everything you need to know to set up Perfinova, import your data, and start tracking your financial life — in one place.

macOS 12.0+ 100% local · no cloud Touch ID protected CSV import from any bank

What is Perfinova?

Perfinova is a personal finance dashboard that lives entirely on your Mac. No bank logins, no subscriptions, no data leaving your device. You import CSV exports from your banks, and Perfinova does the rest — categorizing transactions, tracking budgets, monitoring goals, and visualizing your net worth over time.

📊

Dashboard

Net worth, cash flow, top spending categories, and recent transactions at a glance.

📥

CSV import

Import from any bank or credit card. Perfinova auto-maps columns and detects duplicates.

🗂

Categories & rules

Auto-categorize transactions with smart rules. One-time setup, runs forever.

🎯

Budgets & goals

Set monthly budgets per category and track savings goals with progress bars.

📈

Investments

Track holdings, cost basis, and unrealized gain/loss across all your brokerage accounts.

🤖

Ask AI

Ask plain-English questions about your spending, net worth, and goals.

Perfinova dashboard
The Perfinova dashboard — net worth, cash flow, top spending, and recent transactions.

Getting started

When you first open Perfinova, you'll see a Touch ID prompt followed by a dashboard pre-loaded with demo data. This is intentional — it lets you explore all the features before adding your own transactions.

1

Unlock with Touch ID

On first launch, Perfinova will prompt you to authenticate with Touch ID (or your Mac login password if Touch ID isn't available). This protects your financial data whenever the app opens.

💡
Your data never leaves your Mac. Touch ID authentication happens entirely on-device using macOS's secure enclave.
2

Explore the demo data

Perfinova loads with sample transactions, accounts, budgets, and goals so you can see how everything works before importing your real data. Click through the Dashboard, Transactions, Reports, and Ask AI pages to get familiar.

3

Clear the demo data when ready

When you're ready to start with your own data, go to Settings → Data and click Clear All Data for a blank slate, or Reset to Demo Data to come back to the demo at any time.

⚠️
Clear All Data is permanent and cannot be undone. Make sure you're ready before clicking it.

Importing from your bank

Perfinova imports CSV and Excel files exported from your bank or credit card. Most banks support this — look for "Export transactions" or "Download activity" in your account history.

1

Export a CSV from your bank

Log into your bank's website (not the app) and find the transaction export option. Each bank is slightly different:

  1. Chase: Accounts → Download Activity → CSV
  2. Bank of America: Activity → Download → Microsoft Excel (CSV)
  3. Apple Card: Wallet app → Card → Statements → Export All Transactions
  4. Citibank: Account Details → Download → CSV
  5. Robinhood: Account → History → Export CSV
💡
Export 3–6 months at a time. Perfinova automatically skips duplicate transactions so you can safely re-import overlapping date ranges.
2

Open Imports and select your account

Click Imports in the left sidebar. Select the destination account from the dropdown (e.g. "Chase Checking"), then optionally enter the institution name. This helps with future imports.

3

Upload the CSV file

Drag your CSV file onto the upload area, or click to browse. Perfinova shows a preview of the first 25 rows, auto-suggests column mappings, and displays the date range of the file (e.g. "Jan 15 – May 20, 2025") so you can confirm you're importing the right period before committing.

4

Review and confirm column mapping

Each column header has a dropdown to map it to a Perfinova field (Date, Description, Amount, etc.). Perfinova guesses these automatically — just verify they look right and click Import.

ℹ️
If your bank uses separate Debit/Credit columns instead of a single Amount column, map both — Perfinova will combine them automatically. Rows that look like internal transfers (same amount moving between your own accounts) are auto-tagged as transfers and excluded from expense totals.
5

Review the import summary and apply rules

After a successful import, Perfinova shows a category breakdown of what was just added — for example, "Dining · 34 transactions, Groceries · 18 transactions" — so you can see at a glance how your transactions were categorized.

A blue Apply Rules banner also appears. Click it to instantly run all your saved categorization rules against the new transactions. This is especially useful if you added rules after a previous import and want to back-apply them.

Once done, go to Transactions and filter to "Show uncategorized" to review any transactions that didn't match a rule. Click a category directly in the table to assign it inline.

⚠️
Made a mistake? Go to Settings → Import history, find your import batch, and click Revert to delete all transactions from that import and start over.

Preparing your CSV for import

Most bank CSV exports work with Perfinova out of the box. But some banks produce messy files that need a little cleanup first. Here's what to look for and how to fix it.

The ideal CSV format

Perfinova works best when your CSV has these columns (exact names don't matter — you'll map them in the preview screen):

Date, Description, Amount, Category 2026-04-01, STARBUCKS #1234, -5.75, Dining 2026-04-02, PAYROLL DEPOSIT, 3500.00, Income 2026-04-03, AMAZON.COM, -42.99, Shopping
💡
Amount convention: Expenses should be negative numbers, income positive. If your bank uses a separate Debit/Credit column instead, that works too — map both columns in the preview screen.
1

Remove header rows and preamble

Some banks add extra lines at the top before the actual column headers — things like account numbers, date ranges, or bank branding. These confuse the importer.

Bank of America · Account ending 1234 ← DELETE THIS Transactions from 04/01/2026 to 04/30/2026 ← DELETE THIS ← DELETE THIS Date,Description,Amount ← Keep this (real headers) 04/01/2026,STARBUCKS,-5.75 ← Keep this

Open the CSV in TextEdit or Excel, delete everything above the column header row, and save.

2

Handle separate Debit / Credit columns

Some banks (Chase, BofA) use two columns instead of one signed Amount column:

Date, Description, Debit, Credit 04/01/2026, STARBUCKS, 5.75, 04/02/2026, PAYROLL,, 3500.00

In the Perfinova import preview, map Debit → "Amount (debit/out)" and Credit → "Amount (credit/in)". Perfinova will combine them into a single signed amount automatically.

3

Fix date formats

Perfinova accepts most date formats automatically. These all work:

2026-04-01 ← ISO format (preferred) 04/01/2026 ← US format 01/04/2026 ← EU format April 1, 2026 ← Long form 04-01-26 ← Short year

If dates are parsing incorrectly (e.g. months and days swapped), open the CSV in Excel, format the date column as YYYY-MM-DD, and re-save.

4

Remove footer rows and totals

Some exports add a summary row at the bottom:

04/30/2026, NETFLIX, -15.99 ← DELETE from here Total Debits: $1,234.56 Total Credits: $3,500.00

Delete any rows after the last real transaction before importing.

5

Clean up amount formatting

Amounts should be plain numbers. These cause problems and need to be cleaned up before import:

$5.75 ← Remove the $ sign "5,000.00" ← Remove quotes and commas 5.75 DR ← Remove text suffixes (42.99) ← Replace parentheses with negative: -42.99

In Excel: select the Amount column → Find & Replace → remove $ signs and commas. For parentheses, use a formula: =IF(LEFT(A1,1)="(", -VALUE(MID(A1,2,LEN(A1)-2)), VALUE(A1))

6

Add a Merchant column (optional but recommended)

Bank descriptions are often messy: SQ *STARBUCKS #12345 SAN FRANCISCO CA. If you clean this up into a separate Merchant column, Perfinova's rules engine works much better:

Date, Description, Merchant, Amount 04/01/2026, SQ *STARBUCKS #12345 SF CA, Starbucks, -5.75 04/03/2026, AMZN Mktp US*AB12CD, Amazon, -42.99

This is optional — but a clean Merchant column makes categorization rules far more accurate. The upcoming AI import feature in v1.1 will do this cleanup automatically.

ℹ️
Coming in v1.1: AI-powered smart import will automatically clean merchant names, detect categories, and handle messy CSV formats — no manual cleanup needed.

Bank-specific notes

🏦

Chase

Exports as CSV with separate Debit/Credit columns. Map both in preview. No preamble rows.

🏦

Bank of America

Has 7 header rows before the data. Delete rows 1–6, keep row 7 (column headers). Uses separate Debit/Credit columns.

🍎

Apple Card

Clean CSV with Date, Description, Merchant, Category, Type, Amount (USD). Maps perfectly with no cleanup needed.

🏦

Citibank

Has preamble rows and uses separate Debit/Credit columns. Delete header rows above column names before importing.

📈

Robinhood

Clean CSV format. Brokerage transfers should be categorized as Investments, not income.

💳

Most credit cards

Generally clean. Watch for parentheses around amounts for charges — convert to negative numbers.

Auto-categorizing transactions

Rules let Perfinova automatically assign categories to imported transactions based on merchant name, description, or amount. Set them up once and every future import is categorized automatically.

1

Create a rule

Go to Settings → Rules → New rule. Set a condition (e.g. Merchant contains "Starbucks") and assign a category (e.g. Dining). Click Save rule.

2

Apply rules to existing transactions

Click Apply rules to uncategorized transactions to run all your rules against existing transactions. Use Apply (overwrite) to re-categorize everything, even already-categorized transactions.

3

Add custom categories

Go to Settings → Categories to add your own categories. Each category has a type (expense, income, or transfer) and a color used in charts and reports.

💡
Pro tip: Mark credit card payments as type transfer so they don't double-count as expenses in your reports.

Tracking budgets and savings goals

1

Set up a monthly budget

Go to Budgets, select the month, and click + New budget. Choose a category and enter a planned amount. The progress bar turns red when you go over.

Use Suggest from history to let Perfinova auto-fill amounts based on your average spending, or Copy last month to duplicate the previous month's budget.

2

Create a savings goal

Go to Goals → New goal. Set a name, target amount, current amount, and target date. Link it to a savings account to auto-track the balance. Perfinova shows how much you need to save per month to hit your target.

Understanding your finances

📸

Net worth snapshots

Perfinova saves your net worth automatically every day on launch, building a historical chart over time.

📉

Income vs expenses

Monthly bar chart showing income and spending side by side for the past 12 months.

🍩

Category spending

Donut chart and table showing where your money went by category for any date range.

📋

Budget variance

See exactly which categories went over or under budget for any month.

🤖

Ask AI

Ask plain-English questions about your spending, income, net worth, budgets, goals, and more — with support for flexible date ranges like "last 3 months" or "Q1 2025".

📤

CSV export

Export all transactions as a CSV from the Reports page for use in Excel or other tools.

Ask AI — question reference

Type any question in plain English into the Ask AI page. The assistant answers entirely from your local data — no internet connection needed, nothing leaves your Mac. Here's what you can ask:

Topic Example questions
Spending "How much did I spend on dining last month?" · "What did I spend on groceries in March?" · "Total spending last 3 months"
Date ranges Use "last month", "this month", "last 3 months", "last year", "Q1 2025", "in March", "in 2024" — the assistant understands them all
Merchant "How much did I spend at Trader Joe's?" · "What did I pay at Amazon last month?"
Income & cash flow "What was my income this year?" · "What is my cash flow this month?" · "Income vs expenses last month"
Savings rate "What is my savings rate?" · "How much am I saving each month?"
Accounts & net worth "What is my net worth?" · "What is my savings balance?" · "Show all my accounts"
Budgets "Am I over budget on groceries?" · "Show me my budget status this month" · "Which categories are over budget?"
Goals "Show me all my goals" · "How is my emergency fund going?" · "Am I on track for my vacation goal?"
Top & largest "What were my biggest expenses this month?" · "Top spending categories last quarter"
Averages "What is my average grocery spend?" · "What do I typically spend on dining per month?"
Year-over-year "How does this year compare to last year?" · "Year-over-year spending"
Subscriptions "What subscriptions am I paying?" · "Show my recurring charges"
Affordability "Can I afford a $5,000 vacation?" · "Can I afford a $800 laptop right now?"
ℹ️
Ask AI answers questions about data that's already in Perfinova. It won't give stock tips, tax advice, or general financial guidance — for those, it will let you know what it can help with instead.

Data tab in Settings

Go to Settings → Data to manage your app data. Two options are available:

Reset to Demo Data

Wipes all your data and reloads the original sample transactions, accounts, budgets, and goals. Useful if you want to re-explore the app's features or start fresh after experimenting.

🗑

Clear All Data

Permanently deletes everything — transactions, accounts, budgets, goals, holdings, categories, and rules. Gives you a completely blank slate to import your own real data.

⚠️
This cannot be undone. After clearing, click "Reload now" to refresh the app.
Settings Data tab
Settings → Data tab — reset or clear your data at any time.

Common questions

Is my financial data safe?
Yes. All data is stored locally on your Mac in a SQLite database at ~/Library/Application Support/PerfinovaProduction/finance.db. Nothing is ever sent to a server, cloud, or third party. Perfinova has no internet connectivity requirement.
My CSV import shows no transactions — what's wrong?
Check the column mapping in the preview screen. Make sure the Date and Amount columns are mapped correctly. If your bank uses separate Debit/Credit columns, map both. If the date format is unusual (e.g. MM/DD/YYYY vs YYYY-MM-DD), Perfinova will still parse it correctly in most cases.
I imported transactions but the dashboard shows no data.
Make sure the transactions are assigned to an account. Go to Transactions, check that the Account column is populated. Also verify the transaction dates fall within the current month — the dashboard only shows this month's data by default.
How do I handle credit card payments so they don't double-count?
Create a rule: Merchant contains "Payment" → Category: Credit Card Payment, Type: transfer. Or manually set the transaction type to "transfer" in the edit screen. Transfers are excluded from income/expense totals.
The app shows "Authentication cancelled" and won't open.
Click the "Unlock Perfinova" button to try again. If Touch ID fails, click "Use Password" to authenticate with your Mac login password instead.
Can I use Perfinova on multiple Macs?
Perfinova stores data locally, so each Mac has its own separate database. Perfinova automatically backs up your database to iCloud Drive (in a PerfinovaBackups folder) on every launch, so you can manually copy the database between Macs if needed.
How do I undo an import?
Go to Settings → Import history (or Imports → Recent import batches), find the batch, and click Revert. This deletes all transactions from that specific import batch without affecting other data.
The Ask AI feature gave me a wrong answer.
Ask AI uses rule-based logic over your local data — it's not connected to an external AI service. It works best for factual questions about your transactions ("how much did I spend on X"). For planning questions, treat the answers as estimates and verify against your Reports.

Quick reference

Import CSV
Imports → upload file
Undo import
Settings → Import history → Revert
Add rule
Settings → Rules → New rule
Clear demo data
Settings → Data → Clear All Data
Export transactions
Reports → Export all transactions (CSV)
Set monthly budget
Budgets → + New budget
Add investment
Investments → + Add holding
Support
perfinova.com/support