RIP-Comm/sossoldi

Sossoldi is a cross-platform, open-source wealth management application built with Flutter that enables users to track personal finances through local data storage. The system supports expense and income tracking, budget planning, and recurring transaction management across Android, iOS, Linux, macOS, and Windows. It features secure local authentication, CSV import/export capabilities, and integrates with the Enable Banking API for automated transaction fetching, all while maintaining a privacy-first approach with no internet connectivity for core data storage.

21 changes.

The project was initialized as a Flutter application, establishing the foundational build environment, dependency configuration, and core data models for financial tracking. This period focused on setting up native project structures and build configurations for Android, iOS, Linux, macOS, and Windows to ensure cross-platform compatibility. Basic UI layouts, theme definitions, and initial unit and widget tests were also implemented to support the core application structure.

40 changes.

The codebase underwent a comprehensive state management migration to Riverpod 3 with code generation, underpinning a major redesign of the user interface and navigation. This period saw the introduction of new features including a multi-step onboarding flow, advanced budget and category management, and banking service integration, alongside the establishment of robust E2E testing infrastructure.

The iOS build configuration for the Flutter framework has been established by adding AppFrameworkInfo.plist, Debug.xcconfig, and Release.xcconfig. These files define the app bundle metadata (such as minimum OS version 13.0) and link the build process to CocoaPods support and generated configuration settings, enabling the iOS project to correctly integrate and run the Flutter engine.

ios/Flutter · high confidence

Introduced a new NotificationService that handles local notification initialization, permission requests for iOS and Android, and the scheduling of recurring reminders. The service supports daily, weekly, and monthly recurrence patterns, automatically scheduling notifications for 21:00 local time and handling platform-specific requirements such as exact alarm permissions on Android.

lib/services/notifications · high confidence

The database service in lib/services/database has been restructured to use a new migration system (MigrationBase, MigrationManager) that applies schema changes incrementally based on version numbers, replacing the previous static schema creation logic. This change also introduces new capabilities to export all database tables to a combined CSV file and import data back from such files, handling table mapping and column alignment automatically.

lib/services/database · high confidence

This change adds the initial Linux desktop platform support for the Sossoldi application. It introduces the necessary CMake build configuration, GTK-based application entry points, and window management logic to run the Flutter app on Linux desktop environments, including GNOME.

linux · high confidence

The Windows build target is now established with the standard Flutter runner template. This adds the CMake build configuration, the Win32 window management layer (including high-DPI scaling support), and the entry point that launches the Flutter engine. The application binary is configured with the product name 'sossoldi' and the company identifier 'com.ripsters', and includes the necessary resource files (icon, manifest) to run on Windows 7 and later.

windows/runner · high confidence

The \lib/model\ directory now contains the foundational data models for the application, introducing classes for \BankAccount\, \Budget\, \CategoryTransaction\, \Currency\, \RecurringTransaction\, and \Transaction\. These models define the structure for storing financial data, including fields for account balances, budget limits, transaction types (income, expense, transfer), and recurring schedules. The implementation includes serialization logic (\fromJson\/\toJson\) for database persistence and establishes the core entity relationships required for the app's financial tracking features.

lib/model · high confidence

The application now includes a complete database migration system to manage schema evolution. This introduces the initial schema (version 1) defining tables for bank accounts, transactions, recurring transactions, categories, budgets, and currencies, along with six subsequent migrations that add features such as account net worth calculation, recurring transaction types, custom ordering for accounts and categories, icon name normalization, and soft-delete support via deleted\_at columns. The migration registry ensures these changes are applied in the correct order during app updates.

lib/services/database/migrations · high confidence

The iOS project workspace has been initialized with standard configuration files, including the workspace data, build settings, and IDE checks. This establishes the foundational structure required for the Xcode project to build and run correctly within the iOS development environment.

ios/Runner.xcodeproj/project.xcworkspace · high confidence

The application now supports macOS, allowing users to run the app on Apple computers. This change introduces the complete native macOS project structure, including the Xcode workspace, build configurations, and the main application entry point. It also registers essential platform plugins such as local authentication, secure storage, file picking, and database access (sqflite), ensuring core device and data features function correctly on the new platform.

linux/flutter, macos · high confidence

Added a new banking provider implementation for Enable Banking, including the core domain models (accounts, balances, transactions, connections), abstract service contracts, and the concrete \EnableBankingProvider\ that wires the REST API client, JWT-based authentication, credential storage, and data mappers to the banking foundation.

lib/services/banking · high confidence

The application now features a new Graphs page that consolidates financial insights into a single view. This page displays available liquidity with a year-to-date line chart and month-over-month gain/loss percentage. It includes an Accounts card showing individual account balances with proportional progress bars, and a Categories card that allows users to filter by month and type. The categories section provides a pie chart for visual breakdown, a list of categories with amounts and percentages, and a bar chart showing monthly totals with an average line indicator.

lib/pages/graphs · high confidence

Users now encounter a dedicated onboarding experience that guides them through setting up their monthly budgets and initial account liquidity. The flow begins with an introductory screen, followed by a budget setup step where users can select categories to assign budgets to, view a running total, and add custom categories. Upon completion, users proceed to an account setup step to define their main account name and starting balance, which serves as the baseline for tracking personal finances.

lib/pages/onboarding · high confidence

A new \app\_theme.dart\ file has been added to \lib/ui/theme\, establishing a centralized \AppTheme\ class that defines the application's visual style. This configuration specifies the light theme's color scheme, typography (using the 'NunitoSans' font family), and component-specific styles for buttons, navigation bars, tabs, chips, and switches, ensuring consistent UI appearance across the app.

lib/ui/theme · high confidence

A new CSVFilePicker service has been added to handle CSV file operations. It allows users to import CSV files by requesting appropriate storage permissions (handling Android SDK version differences) and selecting files via a system picker. For exports, it enables users to save CSV data to a selected directory with a timestamped filename, providing specific error messages if the save location is invalid. The service also includes utilities for showing loading dialogs, success alerts, and error snack bars during these operations.

lib/services/csv · high confidence

Users can now access a dedicated General Settings page to manage core app preferences. This page allows toggling between light and dark modes, selecting a preferred currency from a list via a new selector dialog, and enabling or disabling local device authentication. The settings are powered by Riverpod providers and persist the user's choices for appearance, financial display, and security.

lib/pages/settings/general · high confidence

The app introduces three new utility libraries in the UI layer to standardize styling and layout logic. The \device.dart\ file adds responsive design capabilities, including a \BreakPoint\ system for adapting layouts to mobile, tablet, and desktop screens, along with helper extensions for detecting screen size and keyboard visibility. The \assets.dart\ file centralizes image asset paths for common icons like vaults and wallets. Additionally, \extensions.dart\ provides convenient syntax for creating durations, formatting text styles, capitalizing strings, converting numbers to currency, and formatting dates.

lib/ui · high confidence

The application now uses a new \Structure\ widget in \lib/pages/structure.dart\ to define the main layout, featuring a bottom navigation bar with tabs for Dashboard, Transactions, Planning, and Graphs. This structure integrates a search button in the app bar that navigates to a new \/search\ route, and a settings button that navigates to \/settings\. The floating action button for adding transactions has been updated to reset the transaction provider before navigating to the \/add-page\ route. The layout also includes logic to toggle the visibility of balance amounts on the Dashboard tab.

lib/pages · high confidence

A new BackupPage has been added to the settings section, providing users with the ability to import and export application data via CSV files. The import function includes a mandatory confirmation dialog warning that existing data will be permanently overwritten, while the export function allows users to save their current database state as a CSV file. Both actions provide loading indicators and success or error feedback via snack bars.

lib/pages/settings/backup · high confidence

The planning screen now features dedicated widgets for managing budgets and recurring transactions. Users can view budget composition via a pie chart and track progress with color-coded bars that warn when spending nears the limit. A new category selector allows choosing budget categories and setting limits with currency symbols. Recurring payments are displayed in cards showing next due dates and amounts, with an option to view historical payment data. Users can add, edit, and delete recurring transactions through dedicated interfaces.

lib/pages/planning/widget · high confidence

The planning section now features a dedicated Manage Budget page that allows users to select categories, set specific monthly limits for each, and view a running total of their budget. This page is accessible via a 'Manage' button on the main Planning page, which also displays a summary BudgetCard and a list of Recurring Payments. Users can add, update, or delete budget entries by category, with the system preventing duplicate category assignments and guiding users to add new categories if none are available.

lib/pages/planning · high confidence

The categories interface now includes dedicated widgets for enhanced category configuration: a color and icon selector for customizing category appearance, a confirmation dialog that warns users about the irreversible deletion of linked recurring transactions and budgets, and a subcategory list view that allows users to add and manage subcategories within a parent category.

lib/pages/categories/widgets · high confidence

The dashboard now includes dedicated widget files for displaying account summaries and budget tracking. The new \account\_section.dart\ renders a horizontal list of active accounts with a 'New Account' button, while \accounts\_sum.dart\ displays individual account details including name, balance, and currency symbol. Additionally, \budgets\_section.dart\ provides a horizontal list of budget circular indicators that show spending progress against limits, pulling data from budgets, transactions, and categories providers.

lib/pages/dashboard/widgets · high confidence

Added a new DecimalTextInputFormatter that formats numeric input with configurable decimal places, handles thousands separators, and preserves cursor position during text edits. Also added a getFormattedDateRange utility that formats date ranges as 'MMMM yyyy' for full months or 'dd/MM/yy - dd/MM/yy' for partial ranges.

lib/ui/formatters · high confidence

A new Notifications settings page has been added, allowing users to manage notification preferences directly. Users can now toggle transaction reminders on or off, and when enabled, select the specific reminder cadence (e.g., daily, weekly) via a new selection tile widget. Additionally, a separate toggle for recurring transaction added notifications is provided. This page integrates with the app's notification service to request permissions when reminders are enabled.

lib/pages/settings/notifications · high confidence

The application now includes a dedicated SearchPage that allows users to filter transactions by label, type, and specific accounts. The UI features an autocomplete input for label suggestions, horizontal scrollable FilterChips for selecting transaction types and accounts, and displays the resulting transaction list below. This page integrates with the Riverpod state management system to handle filtering logic and data retrieval.

lib/pages/search · high confidence

The application now includes a dedicated CreateTransactionPage that allows users to create, edit, and manage transactions. This page supports creating income, expense, and transfer transactions, with specific validation logic for each type (e.g., requiring a category for income/expense and a second account for transfers). It also handles recurring transaction creation and editing, including the ability to convert a one-time transaction into a recurring one. The UI provides real-time feedback on save button availability based on input completeness.

_lib/pages/transactions/create\transaction · high confidence

The repository has been initialized as a Flutter application, establishing the foundational build environment and project structure. The app now targets Flutter version 3.38.8, managed via Flutter Version Manager (FVM) as defined in the new \.fvmrc\ file. This change includes the addition of standard Flutter configuration files such as \.metadata\, \analysis\_options.yaml\ (enabling relative imports and const constructors), and \devtools\_options.yaml\, alongside a comprehensive \.gitignore\ that excludes generated code (\.g.dart\, \.freezed.dart\) and build artifacts. The \README.md\ has been expanded to document the app's purpose as a wealth management tool, listing current Phase 1 features like expense tracking and local data storage, and providing links to the App Store, Google Play, F-Droid, and contributing guidelines.

(repo-wide) · high confidence

The Windows build system now includes the standard Flutter CMake configuration to link the Flutter engine and C++ wrappers, alongside generated files that register five C-API plugins (app\_links, flutter\_secure\_storage\_windows, local\_auth\_windows, permission\_handler\_windows, url\_launcher\_windows) and two FFI plugins (flutter\_local\_notifications\_windows, jni) for the Windows target.

windows/flutter · high confidence

The iOS build configuration (project.pbxproj) has been established for the Flutter Runner application. This change introduces the standard Xcode project structure, including the integration of CocoaPods for dependency management (evidenced by the Pods group and framework references) and the addition of a dedicated unit test target (RunnerTests) to support automated testing of the iOS native code.

ios/Runner.xcodeproj · high confidence

A new confirmation dialog has been introduced in the accounts interface to prevent accidental data loss. When a user initiates the deletion of a bank account, they are now presented with a warning that explicitly states the account name, alerts them that all linked recurring transactions will be removed, and emphasizes that the action is irreversible. The dialog provides clear Cancel and destructive Delete options, ensuring users must explicitly confirm before the account is permanently removed.

lib/pages/accounts/widgets · high confidence

The iOS app now displays a custom launch screen (LaunchScreen.storyboard) featuring the app icon and background, replacing the default blank screen. On the web, a splash screen is now shown during initialization, supporting both light and dark color schemes via the new splash assets and CSS, and it is automatically removed once the Flutter engine is ready.

ios/Runner/Base.lproj, web · high confidence

The Android entry point for the app now extends FlutterFragmentActivity instead of the previous base class. This change ensures compatibility with the local authentication plugin, which requires a FragmentActivity to function correctly on Android.

android/app/src/main/kotlin · high confidence

The application entry point (lib/main.dart) has been restructured to perform several critical setup tasks before launching the UI. First, it handles a key migration from 'is\_first\_login' to 'onboarding\_completed' in shared preferences to ensure correct onboarding state. Second, it checks for and processes recurring transactions if the last check was more than a day ago. Third, it integrates local device authentication, prompting the user to authenticate via biometrics or PIN if the feature is supported and enabled, preventing the app from loading if authentication fails. Finally, it initializes time zones, notification permissions, and sets up the Riverpod provider scope with theme and version overrides.

lib · high confidence

The application now uses centralized constant files to define its visual identity. A new \constants.dart\ file consolidates icon mappings for categories such as Household, Activities, Travel, Tech, People, and Others, as well as account icons. A corresponding \style.dart\ file defines the color palette, including specific colors for categories and accounts, and introduces a complete set of dark-mode color variants (e.g., \darkBlue1\, \darkCategory1\) to support light and dark theme switching.

lib/constants · high confidence

The application now uses a centralized \routes.dart\ file to define all navigation paths, including new entries for subcategory management (\/add-subcategory\) and recurring transaction editing (\/edit-recurring-transaction\). Navigation is handled via a \makeRoute\ function that automatically selects the appropriate visual style based on the operating system, using Cupertino-style transitions on iOS and Material-style transitions on Android.

lib/routes · high confidence

All database repositories in this layer (account, budget, category, currency, recurring transactions, and transactions) have been rewritten to use Riverpod 3 with \riverpod\_annotation\ and generated providers (\.g.dart\). This migration updates the dependency injection and state management approach for data access, replacing the previous implementation with declarative \@riverpod\ annotations. The underlying SQL logic for CRUD operations, filtering, and joins remains consistent, but the way these repositories are instantiated and accessed by the rest of the app has changed to align with the new Riverpod version.

lib/services/database/repositories · high confidence

The application's state management has been upgraded to Riverpod 3, utilizing the \riverpod\_annotation\ package and generated code (\.g.dart\ files) for all providers in the \lib/providers\ directory. This change introduces a new provider architecture for core features, including dedicated providers for accounts, transactions, budgets, categories, recurring transactions, banking services, and settings. Users will benefit from a more robust and type-safe state management system that powers the app's data flow, including account reconciliation, budget tracking, and transaction filtering.

lib/providers · high confidence

The Settings \> Info section has been redesigned with dedicated pages for viewing app details and team credits. Users can now access a 'Collaborators' page that lists the project team members with their roles and links to their GitHub or LinkedIn profiles, along with a call-to-action to contribute on GitHub. A 'More Info' page displays the current app version and provides navigation to the Privacy Policy and Collaborators screens. The Privacy Policy page itself has been rewritten to explicitly state that the app is open-source, does not collect personal information, and does not connect to the internet, with a clickable email link for contact.

lib/pages/settings/infos · high confidence

A new Settings page has been introduced, replacing the previous implementation with a redesigned UI that lists options such as General Settings, Accounts, Categories, Budget, Import/Export, Notifications, Feedback, and App Info. The page uses a list of cards for navigation, supporting both internal app routes and external URLs (e.g., the feedback form). Additionally, a hidden developer mode is now accessible by tapping the 'Settings' title four times, which triggers a warning dialog about permanent data erasure upon interaction with specific UI elements.

lib/pages/settings · high confidence

The dashboard page has been restructured to display monthly balance, income, and expenses using a new layout that applies visual blur effects to key financial figures via the BlurWidget. The view now integrates a LineChartWidget to compare current month spending against the previous month, with specific configuration to ignore blur on the chart itself while applying it to the text displays. This change also introduces listeners for duplicate transaction detection to show snack bars, and utilizes the updated Riverpod 3 provider structure for data consumption.

lib/pages/dashboard · high confidence

The transactions page has been restructured into a new file that presents data in a tabbed interface (List, Categories, Accounts) with a collapsible header. It now explicitly handles the empty state by displaying an 'AddTransactionCard' when no transactions exist, and includes logic to snap the scroll position of the header for a smoother user experience.

lib/pages/transactions · high confidence

The accounts section has been rebuilt with a new list view that allows users to reorder accounts via drag-and-drop, a dedicated account detail page featuring a balance discrepancy tool to manually adjust balances, and an updated create/edit form that now includes options to set a main account and control whether it contributes to net worth.

lib/pages/accounts · high confidence

The categories section has been restructured into a dedicated folder with new pages for managing categories and subcategories. Users can now reorder their main categories via drag-and-drop in the list view, create and edit subcategories linked to parent categories, and delete subcategories directly from the edit screen. The category creation and editing interface has been updated to support these new hierarchical relationships while maintaining the ability to customize names, icons, and colors.

lib/pages/categories · high confidence

The transaction creation screen has been rebuilt with a new set of UI widgets that significantly enhance the user experience. Users can now select accounts and categories from dedicated bottom sheets that prioritize frequently used items for faster selection. The interface supports Income, Expense, and Transfer types, with the Transfer mode introducing a specific 'From' account selector that prevents selecting the same account for both source and destination. Recurring payment settings are now managed through dedicated tiles that allow users to configure intervals and end dates, with read-only restrictions applied when editing existing recurring transactions. The design also includes a duplicate transaction confirmation dialog and a refined amount input field with currency suffixes.

_lib/pages/transactions/create\transaction/widgets · high confidence

The transactions page has been rebuilt with a new tabbed interface that allows users to view their spending and income broken down by account or by category. This update introduces dedicated widgets for rendering pie charts and interactive lists for both accounts and categories, including a new month selector that displays the total amount for the selected period. The layout now features a collapsible header with a tab bar and a floating action button to add new transactions, replacing the previous single-list view with a more detailed analytical perspective.

lib/pages/transactions/widgets · high confidence

The \lib/ui/widgets\ directory has been restructured to use a new set of shared UI components. This includes a customizable \BlurWidget\ that applies a privacy blur to sensitive content (controlled by settings), native-style \AdaptiveDialog\ and \AlertDialogBuilder\ for consistent messaging, and dedicated widgets for transaction management like \TransactionsList\ (which now correctly handles transfer types in totals) and \TransactionTypeButton\. The update also introduces \LineChartWidget\ with gap-filling logic and \BudgetCircularIndicator\ for dashboard summaries, standardizing the visual language across the app.

lib/ui/widgets · high confidence

The iOS runner now includes the necessary configuration files to support local device authentication and file operations. The Info.plist adds descriptions for Face ID usage to protect sensitive data and documents access for importing and exporting CSV files, while the AppDelegate is initialized to handle local notifications and register plugins.

ios/Runner · high confidence

The iOS project now includes a defined Xcode scheme (Runner.xcscheme) that configures how the app is built, tested, launched, profiled, and archived. This setup enables developers to run and debug the application directly within Xcode, including support for GPU validation mode during debugging and the execution of unit tests via the RunnerTests target.

ios/Runner.xcodeproj/xcshareddata · high confidence

Added proguard rules to the Android release build configuration to prevent the obfuscation and removal of \org.xmlpull\ classes. This change resolves issues where local notifications failed to function in release builds by ensuring the XML Pull Parser library remains intact during the shrinking and obfuscation process.

android/app/src · high confidence

The iOS workspace structure has been restored with the necessary configuration files: \contents.xcworkspacedata\ now correctly references both the \Runner.xcodeproj\ and the \Pods/Pods.xcodeproj\, ensuring CocoaPods dependencies are properly linked; \IDEWorkspaceChecks.plist\ is present to manage workspace integrity checks; and \WorkspaceSettings.xcsettings\ is configured to disable previews. These changes ensure the Xcode workspace opens and builds correctly with its associated project and pod dependencies.

ios/Runner.xcworkspace · high confidence

Added FFI database factory tests for Dart VM, Flutter, and Widget environments; Added end-to-end test for account creation; Added initial iOS test target scaffold; Added test coverage for the Enable Banking foundation; Added unit tests for core financial models; Added widget tests for accounts, amount input, line chart, and dialog components; Initial e2e page object models for dashboard, account management, and onboarding; Initial e2e test infrastructure and configuration; Initial implementation of mobile E2E test infrastructure.

This change introduces the foundational build configuration and dependency manifests for the Sossoldi application. It establishes the Android build system using Gradle Kotlin DSL (version 8.11.1) with support for FDroid and default product flavors, release signing via keystore properties, and Java 17 compilation. iOS and macOS platforms are configured with CocoaPods (Podfile) targeting iOS 13.0 and macOS 10.15, respectively. The Dart/Flutter project is initialized with \pubspec.yaml\, specifying SDK ^3.10.7 and integrating core libraries such as Riverpod 3.1.0 for state management, sqflite for local database storage, local\_auth for device authentication, and flutter\_local\_notifications. Additionally, the documentation site dependencies (Jekyll 4.3.3, just-the-docs 0.7.0) and end-to-end testing requirements (Appium, Selenium) are added.

(dependencies) · high confidence

The project now includes the Gradle wrapper configuration, specifically setting up the wrapper properties to use Gradle 8.14. This ensures that the Android build system uses a consistent and reproducible version of Gradle across different development environments.

android/gradle · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• First survey — no prior run to compare against. CAI 62.

• Code Health 87
• Architecture 91
• Maturity 66
• Readiness 50
• Security 69
• Domain Modelling 100

• 300 commits — 197 feature/other, 103 fixes

• lib/pages — 103 commits
• (repo) — 72 commits
• test/e2e — 17 commits
• .github/workflows — 14 commits
• (root) — 11 commits
• lib/providers — 11 commits
• lib/services — 10 commits
• lib/main.dart — 9 commits
• android/app — 8 commits
• metadata/en-US — 7 commits
• lib/utils — 5 commits
• lib/model — 4 commits
• .github/ISSUE_TEMPLATE — 3 commits
• ios/Runner — 3 commits
• lib/custom_widgets — 3 commits
• lib/database — 3 commits
• lib/routes.dart — 3 commits
• lib/ui — 3 commits
• lib/constants — 2 commits
• .github/pull_request_template.md — 1 commit

• fix: (fix)CI: try to fix an error on the github actions (#417)
• fix: Fix #241
• fix: Fix APK filename in release workflow
• fix: Fix Ripple Effect on transactions tile
• fix: Fix analysis warning (#298)
• fix: Fix available liquidity calculation
• fix: Fix balance decimals
• fix: Fix budget color overflow for more than 9 budgets
• fix: Fix for iOS testing
• fix: Fix grammatical error
• fix: Fix key.properties path and improve debug logging
• fix: Fix keystore file path in publish-release workflow
• fix: Fix move pr template in a more appropriate location
• fix: Fix path for key.properties in publish-release.yml
• fix: Fix potential crash in /add-page route handling (#403)
• fix: Fix text color in dark theme
• fix: Fix transaction list container layout
• fix: Fix yaml template issues (#357)
• fix: Fix/minor UI fixes (#487)
• fix: Fix: demo data issues and category reorder with subcategories (#515)
• …and 280 more

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

RIP-Comm/sossoldi was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.