Product Requirement Document
Listflow: Planner, Notes, and Focus Timer
1. Core Objectives
- Provide a centralized, offline-first hub to track daily task progress and deadlines.
- Equip users with a Pomodoro-style focus timer to encourage deep work and calmer minds.
- Offer a quick-access notes section for rapid idea and reminder capture.
2. Functional Requirements
2.1 Dashboard (Home)
Must display a dynamic greeting (e.g., "Hello, [Name]!") and current date. Must render numeric metric cards for Due today, Completed today, Overdue, and accumulated Focus minutes. Must render progress bars tracking "Today's deadlines" and "Daily goal".
2.2 Planner & Tasks Module
The Tasks tab must include a search bar and a "Filters" button to query active items. The Planner tab must include a horizontal date navigator, grouping tasks into "Today" and "Next 7 days", and feature a prominent "Add task" button.
2.3 Focus Timer
A circular countdown interface allowing users to link specific tasks. Must include Start, Pause, and Reset controls, and display a "Recent sessions" history block below the timer.
2.4 Application Settings
Must allow user customization of Profile Name, Daily task goal (1-100), Focus session length (1-180 min), and Break length (1-60 min). Must include a toggle for Completion Alarms and allow UI Accent Theme selection.
2.5 About Developer
Developer: Cristal Joy Autriz (BSIT 3A WMAD) | IT Consultant: Dr. Erick R. Abuzo
Technical Requirement Document
Listflow - Technical Specifications
1. Architecture & Data Storage
Listflow operates on a local-first architecture. All app configurations, task arrays, and timer histories must be serialized and persisted locally on the device (e.g., via SQLite or LocalStorage/AsyncStorage equivalent). No external cloud database is strictly required for core functionality.
2. Frontend Layout & Routing
The application utilizes a persistent Bottom Navigation Bar consisting of five main routes: Home, Tasks, Planner, Focus, and Notes. Global application state must supply the selected "Accent theme" variable to dynamically colorize primary buttons, icons, and progress bars across all routes.
3. Background Timer & Audio Services
- Timer Execution: The Focus tab requires a background-capable countdown service that accurately deducts seconds independent of UI render cycles.
- Alarm Routing: Upon timer completion, the system must trigger a local alarm utilizing the device's native media audio volume routing, provided the "Completion alarm" toggle is set to true in User Settings.