Focus Journal

A calm, private journaling app for focus, reflection, and small daily wins.

---

About

Focus Journal is a local-first journaling app for people who want to build a quiet daily practice around focus and reflection. No account, no cloud, no tracking — your entries live on your device, encrypted.

Made with kodawari in mind: careful craftsmanship and attention to detail, in every small interaction.

Features

• Encrypted journal entries — AES-256-GCM, key held in the OS secure storage
• Multiple auth methods — biometric (fingerprint/face), PIN, password, or pattern
• Calendar view — browse entries by date with an intuitive calendar
• Full-text search — find entries across your whole journal
• Same-day editing — entries are immutable after the day they were written
• Encrypted backups — AES-256-GCM with PBKDF2 (100k iterations), .fjb format
• Material 3 design — dynamic color (Android 12+), light & dark themes
• Multilingual — 7 languages (DE, EN, ES, FR, IT, NL, PL)
• Cross-platform — Android, iOS, Linux, macOS, Windows, Web

Screenshots

Coming soon.

Tech Stack

• Framework: Flutter
• State management: Provider
• Local storage: SharedPreferences with AES-256-GCM content encryption (via encrypt + crypto)
• Secure credential storage: flutter_secure_storage
• Auth: local_auth for biometrics
• Theming: Material 3 + dynamic_color + flex_color_scheme

Getting Started

Prerequisites

• Flutter SDK (stable channel, ^3.8.1)
• Platform toolchain for your target (Android SDK, Xcode, etc.)

Build & Run

git clone https://github.com/WariKoda/FocusJournal.git
cd FocusJournal

flutter pub get
flutter run

Building for release

# Android
flutter build apk --release
flutter build appbundle --release

# iOS
flutter build ios --release

# Desktop
flutter build linux --release
flutter build macos --release
flutter build windows --release

# Web
flutter build web --release

Running tests

flutter analyze
flutter test

Project Structure

lib/
├── l10n/          # Localization files (7 languages)
├── models/        # Data models (incl. settings)
├── screens/       # UI screens
├── services/      # Business logic (auth, backup, journal, theme, notifications)
└── widgets/       # Reusable UI components

Contributing

Contributions are very welcome — whether that's code, documentation, bug reports, translations, or design feedback. If you're new to the project, look for issues tagged good first issue.

Please read CONTRIBUTING.md before opening a pull request, and note that this project adheres to the Contributor Covenant Code of Conduct.

Questions and ideas are welcome in Discussions. Issues and PRs can be in English or German — whichever feels more natural to you.

Roadmap

See the open issues for an up-to-date view of planned work.

Security

If you find a security-sensitive issue, please follow the process in SECURITY.md instead of opening a public issue.

License

Focus Journal is free software, licensed under the GNU General Public License v3.0. You are free to use, study, share, and modify it under the terms of that license.

Acknowledgements

• The Flutter and Dart communities.
• Everyone who takes the time to open an issue or send a pull request.