Frequently Asked Questions

General

What is Cashflow App?

Cashflow App is a comprehensive personal finance management application within FlowState. It helps you track income and expenses, manage accounts, monitor net worth, and project future cash flow using a 4-quadrant income statement dashboard.

Who should use this app?

Cashflow App is designed for:

• Personal finance users who want to track income, expenses, and net worth
• YNAB users who want to sync their existing data for enhanced reporting
• Small business owners who need income statement tracking and cash flow projections
• Household managers managing family finances across multiple accounts

What makes Cashflow App different from other finance apps?

• 4-Quadrant Dashboard: Visual income statement layout showing Income, Expenses, Assets, and Liabilities at a glance
• YNAB Integration: Seamless OAuth-based sync with existing YNAB budgets
• Cash Flow Projections: 30-day forward-looking projections based on scheduled transactions
• Local-First Architecture: Your data works offline and syncs when connected
• FlowState Integration: Works seamlessly with other FlowState apps and workflows

Features

How do I connect my YNAB account?

1. Navigate to Settings (/cashflow/settings)
2. Click the Connect YNAB button
3. Log in to YNAB when prompted
4. Authorize FlowState to access your YNAB data
5. Select which budget to sync
6. Configure sync interval (5-60 minutes)

See Getting Started for detailed instructions.

Can I use Cashflow App without YNAB?

Yes, absolutely. YNAB integration is optional. You can:

• Set up accounts manually through the Setup Wizard
• Import transactions via CSV from your bank
• Manually enter transactions
• Create your own categories and budgets

How do I import transactions from my bank?

1. Export transactions from your bank as a CSV file
2. Navigate to Transactions (/cashflow/transactions)
3. Click the Import CSV button
4. Upload your CSV file
5. Map the columns (date, amount, payee, etc.)
6. Preview and confirm the import

How do I categorize multiple transactions at once?

1. Go to the Transactions page
2. Use checkboxes to select multiple transactions
3. Click the Assign Category button
4. Choose the desired category
5. Confirm to apply to all selected transactions

What account types are supported?

The app supports the following account types:

How do cash flow projections work?

Cash flow projections calculate expected income and expenses over the next 30 days based on:

• Scheduled recurring transactions (bills, subscriptions)
• Expected income (salary, regular deposits)
• One-time scheduled payments

The projection shows:

• Projected Income: Total expected income in next 30 days
• Projected Expenses: Total expected outflows in next 30 days
• Projected Net: Difference between income and expenses
• Transaction Count: Number of scheduled items

Can I track debt payoff progress?

Yes. For liability accounts (credit cards, loans), you can track:

• Current balance
• Interest rate
• Minimum payment amount
• Payment history through transactions

The Liabilities quadrant on the dashboard shows all debt balances.

Account & Access

How do I get access to Cashflow App?

Cashflow App is available to all FlowState users with appropriate database permissions. If you don't see the app in your launcher:

1. Contact your FlowState administrator
2. Request access to the Cashflow App
3. Ensure you have database permissions for financial collections

What permissions do I need?

You need the following permissions:

• database: Read/write access to financial collections
• Basic FlowState platform access

Is my financial data secure?

Yes, your data is protected by:

• Encryption in transit: All data uses HTTPS/TLS
• Encryption at rest: Database encryption for stored data
• OAuth tokens: YNAB tokens are stored securely and never exposed
• Workspace isolation: Data is isolated by organization and workspace
• Local-first storage: Data stays on your device with optional sync

Can I share my financial data with others?

Currently, financial data is isolated to your workspace. Sharing features may be added in future versions.

YNAB Integration

What data syncs from YNAB?

When connected, the following data syncs from YNAB:

• Accounts: All account types and balances
• Categories: Category groups and individual categories
• Transactions: Transaction history with payees and amounts
• Scheduled Transactions: Recurring transactions and future items

How often does YNAB sync?

You can configure the sync interval in Settings:

• Minimum: Every 5 minutes
• Maximum: Every 60 minutes
• Manual: Use "Sync Now" button anytime

Will changes in Cashflow App sync back to YNAB?

Currently, sync is one-way from YNAB to FlowState. Changes made in Cashflow App do not push back to YNAB.

What happens if I disconnect YNAB?

If you disconnect YNAB:

• Previously synced data remains in Cashflow App
• No new data will sync from YNAB
• You can continue using the app with existing data
• You can reconnect at any time to resume syncing

Why are some YNAB transactions missing?

Possible reasons:

• Transactions are outside the sync date range
• Deleted transactions in YNAB are not imported
• Scheduled transactions may need a separate sync
• Test mode limits records (check Settings)

Technical

Which browsers are supported?

Cashflow App supports the latest versions of:

• Chrome (recommended)
• Firefox
• Safari
• Edge

Does the app work offline?

Yes, thanks to RxDB's local-first architecture:

• Data is stored locally in your browser
• You can view and edit data offline
• Changes sync when you reconnect
• YNAB sync requires an internet connection

How do I clear my local data?

To reset your local data:

1. Open browser Developer Tools (F12)
2. Go to Application > Storage
3. Clear site data for FlowState domain
4. Refresh the page

Warning: This will remove all locally cached data. If not synced, data may be lost.

What date formats are supported for CSV import?

Common supported formats:

• YYYY-MM-DD (2026-01-15)
• MM/DD/YYYY (01/15/2026)
• DD/MM/YYYY (15/01/2026)
• MM-DD-YYYY (01-15-2026)

The CSV import wizard allows you to specify your date format during column mapping.

Budgeting

How do budgets work in Cashflow App?

Budgets allow you to:

1. Set spending limits by category
2. Track actual vs. budgeted amounts
3. View budget progress in the Expenses quadrant
4. Sync budget categories from YNAB

Can I have multiple budgets?

Yes. You can create multiple income statements, each with its own budget allocations. This is useful for:

• Personal vs. business finances
• Different family members
• Multiple properties or projects

How do I set category budgets?

1. During Setup Wizard: Set budgets in the Expenses step
2. Or navigate to Budgets page
3. Click on a category to edit
4. Enter the budgeted amount
5. Save changes

Still Have Questions?

If your question is not answered here:

• Check Troubleshooting for common issues
• Review Features for detailed capability documentation
• Contact support for additional help