Developers

For developers who want to contribute or explore the code.

github.com/lizzyman04/agenda

Stack

Tech Stack

Carefully chosen for privacy, performance, and maintainability.

Package Version Purpose
flutter_bloc9.1.1State management (BLoC/Cubit)
isar_community3.3.2Local database — community fork, actively maintained
get_it + injectable9.2.1 / 2.7.1Dependency injection
go_router17.2.0Declarative navigation + deep links
flutter_local_notifications21.0.0Scheduled local notifications
fl_chart1.2.0Finance charts (line, bar, pie)
flutter_screen_lock9.2.2PIN lock screen UI
local_auth3.0.1Biometric auth (Face ID, fingerprint)
flutter_secure_storage10.0.0Secure PIN hash (Keychain / Encrypted SharedPrefs)
csv8.0.0RFC-compliant CSV export/import
intl0.20.2Internationalization (PT-BR + EN)
shared_preferences2.5.5Non-sensitive settings persistence
equatable2.0.8Value equality for BLoC states and events
mocktail1.0.5Mock creation for unit tests (no code gen)
bloc_test10.0.0BLoC/Cubit unit testing utilities

Architecture

Project Structure

Six layers — dependencies always from outside in.

lib/ ├── core/ # Shared utilities, constants, base classes ├── domain/ # Entities, repo interfaces, failures │ ├── tasks/ │ └── finance/ ├── data/ # Isar models, mappers, repo implementations │ ├── tasks/ │ └── finance/ ├── infrastructure/ # Notification, backup, app lock services ├── application/ # BLoC/Cubit state management │ ├── tasks/ │ └── finance/ ├── presentation/ # Screens, widgets, themes │ ├── tasks/ │ └── finance/ └── config/ # DI wiring, routing, app entry point

Development

Getting Started

For developers who want to contribute or explore the code.

Prerequisites

# Required Flutter SDK >= 3.38.1 Dart >= 3.5.0 Android Studio or Xcode

Setup

git clone https://github.com/lizzyman04/agenda.git cd agenda flutter pub get flutter pub run build_runner build --delete-conflicting-outputs flutter gen-l10n flutter run

Tests

flutter test

Lint

flutter analyze

Planning

Roadmap

Five phases built in dependency order.

1

Phase 1 — Foundation Done

Architecture scaffold, Isar + migration runner, DI, l10n, offline guarantee

2

Phase 2 — Task Core Done

Projects, subtasks, CRUD, Eisenhower, 1-3-5, GTD, search and filters

3

Phase 3 — Finance Core Planned

Transactions, budgets, goals, debts, dashboard with charts

4

Phase 4 — Notifications + Backup Planned

Native notifications with boot-safe rescheduling; JSON + CSV export/import

5

Phase 5 — App Lock + Settings + Polish Planned

PIN + biometrics, settings screen, onboarding, empty states

Open Source

How to Contribute

AGENDA is open source. Issues, pull requests, and suggestions are welcome.

  1. 1.Open an issue describing the bug or improvement
  2. 2.Fork the repo and create a branch from main
  3. 3.Follow code conventions and write tests
  4. 4.Open a pull request with a detailed description

AGENDA

AGENDA is open source. Issues, pull requests, and suggestions are welcome.

View on GitHub

License

MIT License

AGENDA is distributed under the MIT License. Free to use for personal and commercial projects.

MIT License Copyright (c) 2025 lizzyman04 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.