Cashflow App
Cashflow App
Cashflow App
The Cashflow App is a comprehensive financial management application for FlowState. It provides income statement tracking with a 4-quadrant dashboard (Income, Expenses, Assets, Liabilities), account management, transaction tracking, budget management, YNAB integration for data synchronization, scheduled transactions with cash flow projections, and a guided setup wizard for new users.
Key Features
- Income Statement Dashboard: 4-quadrant layout showing income, expenses, assets, and liabilities with period filtering (monthly, quarterly, annual)
- Account Management: Track checking, savings, credit cards, loans, and other account types with balance monitoring
- Transaction Tracking: Full transaction history with filtering, search, bulk category assignment, and CSV import
- Budget Management: Create and manage budgets with YNAB synchronization support
- YNAB Integration: OAuth-based YNAB connection for syncing accounts, categories, transactions, and scheduled items
- Scheduled Transactions: Manage recurring income and expenses with 30-day cash flow projections
- Category Management: Organize transactions with customizable category groups and hierarchies
- Setup Wizard: Guided multi-step wizard for setting up income statements (manual or YNAB import)
- Net Worth Tracking: Real-time net worth calculation from assets and liabilities
Target Users
| User Type | Primary Use Cases |
|---|---|
| Personal Finance Users | Track income/expenses, monitor net worth, budget management |
| YNAB Users | Sync existing YNAB data into FlowState for enhanced reporting |
| Small Business Owners | Income statement tracking, cash flow projections |
| Household Managers | Multi-account tracking, scheduled bill management |
Quick Links
- Features & Capabilities - Detailed feature documentation
- Getting Started - Set up and configure the app
Getting Started
Navigation
The app uses a sidebar navigation structure:
- Dashboard (
/dashboard) - Income statement with 4-quadrant layout - Accounts (
/accounts) - Account list and details - Transactions (
/transactions) - Transaction history with filtering - Budgets (
/budgets) - Budget management - Categories (
/categories) - Category configuration - Scheduled (
/scheduled) - Scheduled/recurring transactions - Settings (
/settings) - YNAB connection and sync settings
Setting Up Your First Income Statement
- Navigate to the Dashboard or click "New" button
- Choose a path: Manual Setup or YNAB Import
- Follow the Setup Wizard steps:
- Basics: Name and description
- Categories: Configure income/expense categories
- Accounts: Add or import accounts
- Income: Set up income sources
- Expenses: Configure expense budgets
- Review: Confirm and activate
Connecting YNAB
- Go to Settings (
/settings) - Click "Connect YNAB" to start OAuth flow
- Authorize FlowState to access your YNAB data
- Select a budget to sync
- Configure sync interval (5-60 minutes)
- Start background sync or sync manually
Tracking Transactions
- Navigate to Transactions page
- View all transactions with search and filtering
- Assign categories to uncategorized transactions
- Use bulk selection for mass category assignment
- Import additional transactions via CSV
App Identity
| Property | Value |
|---|---|
| Package | @epicdm/flowstate-app-cashflow |
| Base Path | /cashflow |
| Icon | box |
| Color | #6366f1 (indigo-500) |
Related Packages
- @epicdm/flowstate-app-framework - App container framework
- @epicdm/db-collections - Database schemas
- @epicdm/flowstate-rxdb - Database utilities