System Requirements Document (SRD)

Project Name: cedar-flutter

1. Introduction

The cedar-flutter project aims to deliver a robust offline personal finance application tailored for users in India. This app, named MyMoney, will empower users to track their income and expenses, categorize spending, view analytics, plan budgets, and secure their financial data locally. By leveraging Flutter's cross-platform capabilities, the app will ensure seamless performance across devices while maintaining a lightweight, user-friendly experience.

The focus is on simplicity, security, and offline functionality, with all data stored locally using SharedPreferences. The app is designed to cater to individual users who value privacy and prefer managing their finances without relying on cloud services.

2. System Overview

The cedar-flutter project is a completely offline personal finance tracker built using Flutter. It provides users with tools to manage their transactions, analyze spending patterns, plan budgets, and customize the app's appearance.

Key Features:

• Transaction Management: Add, edit, and delete transactions with category and payment mode assignment.
• Analytics: Interactive charts for expense distribution and monthly summaries.
• Budget Planning: Set monthly budgets per category with visual progress tracking.
• Themes: Light/Dark mode and accent color customization.
• Passcode Protection: Secure the app with a 4-digit passcode stored locally.

Locale-Specific Defaults:

• Currency: Indian Rupee (₹)
• Timezone: IST (Indian Standard Time)
• Date Format: DD-MM-YYYY

3. Functional Requirements

Transaction Management

• As a User, I should be able to add income, expense, and transfer transactions.
• As a User, I should be able to edit and delete transactions.
• As a User, I should be able to assign categories and payment modes to transactions.
• As a User, I should be able to select the date and time for transactions.

Analytics

• As a User, I should be able to view a pie chart showing expense distribution.
• As a User, I should be able to view monthly summaries of income, expenses, and balance.
• As a User, I should be able to filter analytics by category and time range.

Budget Planning

• As a User, I should be able to set monthly budgets for categories.
• As a User, I should be able to track spent amounts and remaining balances.
• As a User, I should be alerted visually when budgets are exceeded.

Category Management

• As a User, I should be able to create custom categories for income and expenses.
• As a User, I should be able to edit and delete categories.

Themes

• As a User, I should be able to switch between Light and Dark modes.
• As a User, I should be able to customize accent colors.

Passcode Protection

• As a User, I should be able to set, reset, and disable a 4-digit passcode.

Widgets

• As a User, I should be able to view a quick summary card with total balance and last transaction.

4. User Personas

1. Regular User

• Description: Individuals managing personal finances offline.
• Needs: Privacy, simplicity, and clear financial insights.
• Goals: Track expenses, analyze spending, and plan budgets effectively.

2. Guest User

• Description: First-time users exploring the app without passcode protection.
• Needs: Easy onboarding and intuitive navigation.
• Goals: Understand app features and decide whether to adopt it.

5. Visuals Colors and Theme

Unique Color Palette:

• Background: #F5F5F5 (Soft Gray)
• Surface: #FFFFFF (Pure White)
• Text: #333333 (Deep Charcoal)
• Accent: #FF6F61 (Warm Coral)
• Muted Tones: #B0BEC5 (Cool Steel Blue)

Mood Direction:

The theme should evoke simplicity, clarity, and warmth, aligning with the app's purpose of financial empowerment.

6. Signature Design Concept

Concept: Interactive Budget Forest

The Home Page will feature a visually stunning Interactive Budget Forest. Each category will be represented as a tree, with its height and fullness reflecting the budget's status.

• Animations: Trees grow taller as budgets are utilized, and leaves change color (green → yellow → red) based on spending thresholds.
• User Interaction: Tapping a tree opens a detailed view of the category's transactions and analytics.
• Transitions: Smooth zoom-in/out effects when navigating between trees.
• Micro-Interactions: Hovering over a tree displays a tooltip with the category name, budget limit, and remaining balance.

This design will make budgeting visually engaging and memorable, ensuring users feel connected to their financial goals.

7. Non-Functional Requirements

• Performance: The app must load within 2 seconds and handle up to 10,000 transactions without lag.
• Security: Passcode hashes must be securely stored using industry-standard hashing algorithms.
• Compatibility: The app must run smoothly on Android 8.0+ and iOS 12+.
• Localization: Support INR currency and IST timezone by default.

8. Tech Stack

Frontend

• Flutter

Backend

• None (Offline app)

Storage

• SharedPreferences (JSON encoded objects)

Charts

• fl_chart

State Management

• Provider / Riverpod

Security

• Local passcode hashing

9. Assumptions and Constraints

Assumptions

• Users prefer offline functionality over cloud sync.
• SharedPreferences storage size is sufficient for typical usage.

Constraints

• No backend or cloud services will be integrated.
• Limited to single-device usage.

10. Glossary

• SharedPreferences: A Flutter library for storing key-value pairs locally.
• Budget: A predefined spending limit for a category.
• Passcode: A 4-digit code used to secure the app.
• Accent Color: A customizable color used for highlighting UI elements.

This SRD is tailored to your vision for cedar-flutter, Bheda. Let me know if you'd like to refine or expand any section!