🧠 Mindscribe

Mindscribe is a Flutter-based productivity app that combines a Focus Timer, Study Logger, and Local Journal — all in one minimal, offline-first tool.
It helps students and self-learners plan, track, and reflect on their study sessions effectively with a clean and modern UI.

---

✨ Features

⏱ Focus Timer

• Customizable timer with preset and manual durations.
• Allows adding a subject/topic before starting.
• Emoji-based subject input UI for personalization.
• Plays optional background music for focus (looped).
• Supports timer countdown and stopwatch toggle modes.

📘 Study Logger

• Automatically logs each completed focus session.
• Displays logs in beautiful card-style format with date, subject, and duration.
• Uses allDates logic to navigate across all study days, even with no logs.
• Provides daily summaries to track consistency.

📝 Local Journal

• Simple offline journaling section for daily reflections or notes.
• Each journal entry is tied to a date and stored locally via Hive.
• Lightweight, no network needed — fully local and private.

🏠 Home Dashboard

• Overview of your total focus time and study activity.
• Quick access to logs, timer, and journal tabs.
• Built with a BottomNavigationBar (Home, Timer, Logs, Journal).

💾 Offline Mode

• All data (logs, timer history, and journals) stored locally using Hive.
• Works seamlessly without internet connection.

---

🛠 Tech Stack

Category	Tools Used
Frontend	Flutter (Dart)
Local Storage	Hive
UI/UX	Quicksand font, custom widgets, responsive layout
Utilities	Dart Timer, DateTime, Hive Adapters

---

🧩 App Architecture Flow

flowchart TD
    A["UI Layer <br/> (Home, Timer, Logs, Journal Screens)"] 
      --> B["Logic Layer <br/> Timer Control, Log Tracking, Journal Saving"]
    
    B --> C["Storage Layer <br/> Hive Boxes for Study Logs & Journals"]
    
    C --> D["Display Layer <br/> UI Refresh & Summary Updates"]
    
    D --> A

Loading

---

🧠 App Data Flow

flowchart TD
    A["Start Focus Timer"] --> B["Timer Counts Down (or Stopwatch Mode)"]
    B --> C["On Completion → Log Saved in Hive"]
    C --> D["Study Log Tab Updates Automatically"]
    D --> E["User Writes Journal Notes"]
    E --> F["Notes Saved Locally in Hive"]

Loading

---

⚙️ Folder Structure

lib/
│
├── main.dart                # Entry point
│
├── screens/                 # All UI screens
│   ├── home_screen.dart
│   ├── focus_timer_screen.dart
│   ├── study_log_screen.dart
│   └── journal_screen.dart
│
├── models/                  # Data models for Hive
│   └── study_log_model.dart
│
├── services/                # Logic helpers
│   └── hive_service.dart
│
└── widgets/                 # Reusable UI widgets
    └── custom_timer_widget.dart

---

🔄 Workflow Summary

1. User opens the app → navigates to Focus Timer.
2. Sets subject & duration → starts timer.
3. On completion, session auto-saves to Study Logs.
4. User can view logs by date in Study Log Tab.
5. Optional journaling → saves reflections locally in Journal Tab.
6. Everything syncs automatically through Hive — no cloud or login required.

---

💡 Key Highlights

• Designed for students who study in focused blocks (Pomodoro style).
• Entirely offline — zero dependency on internet or servers.
• Smooth and intuitive UI using Quicksand font.
• Focused on daily productivity and self-reflection.
• Lightweight performance with local storage and instant load times.
• Perfect for minimal distraction study tracking.

---

📦 Setup Instructions

1️⃣ Clone the Repository

git clone https://github.com/yourusername/Mindscribe.git
cd Mindscribe

2️⃣ Install Dependencies

flutter pub get

3️⃣ Run the App

flutter run

💡 Note: The app is fully offline, so no Firebase setup or API keys are required.

---

🧭 Future Improvements

• Add Firebase sync for cloud backup.
• Include weekly analytics & progress charts.
• Add dark mode and streak tracking.
• Option to export study logs as CSV or PDF.
• Enable optional account login to sync data across devices.
• Add background focus music options with volume control.