Study System 101

A keyboard-first terminal productivity system built with Rust + Ratatui for focused evening execution.

Designed to help you run a disciplined study workflow from 7:30 PM to 10:10 PM with timers, streaks, journaling, and distraction-free planning.

---

✨ Features

• Clean terminal dashboard UI
• Evening execution plan visible at all times
• Session countdown timer
• Progress tracking
• Daily streak system
• Editable daily tracker sections
• Markdown journal export
• Keyboard-first navigation
• Lightweight and fast
• Runs directly in terminal

---

🛠 Built With

• Rust
• Ratatui
• Crossterm
• Chrono

---

📁 Project Structure

study-system-101/
├── Cargo.toml
└── src/
    ├── main.rs
    ├── app.rs
    ├── ui.rs
    ├── timer.rs
    └── storage.rs

🚀 Installation

Prerequisites

Install the following:

Rust (latest stable) Windows Command Prompt / PowerShell / Windows Terminal

Check installation:

rustc --version
cargo --version

⚡ Setup Guide

1. Clone Repository

git clone https://github.com/Bhavadharani412/study-system-101
cd study-system-101

3. Build Project

cargo build

5. Run Application

cargo run

🎯 Usage

When launched, the dashboard opens in full-screen terminal mode.

🕒 Daily Plan

Time	Focus Area
7:30 PM - 8:45 PM	Career
8:50 PM - 9:35 PM	Build
9:40 PM - 10:10 PM	Placement Prep
you can change as per your schedule 

##📋 Tracker Panels

Use these sections daily to reflect progress:

What I Worked On
Result
Next

⌨️ Keyboard Shortcuts Shortcut Action

Arrow Left / Right	Move between panels
Ctrl + I	Enter edit mode
Esc	Exit edit mode
Ctrl + S	Start / Pause timer
Ctrl + R	Reset timer
Ctrl + W	Save journal
Ctrl + Q	Quit application
Backspace	Delete text
Enter	New line

📄 Generated Files

The app automatically creates:

journal.md   # Daily notes export
streak.txt   # Streak persistence data

🔥 Example Workflow

Launch app using: cargo run Start timer with Ctrl + S Work on Career block Update tracker notes Save progress with Ctrl + W Continue remaining sessions Build consistency daily

👨‍💻 Development

Run in Development Mode

cargo run

Format Code

cargo fmt

Lint Code

cargo clippy

Build Release Version

cargo build --release

🤝 Contribution Guide

Contributions are welcome.

Steps

Fork repository first

git checkout -b feat/amazing-feature
git commit -m "feat(ui): improve dashboard layout"
git push origin feat/amazing-feature

Then open a Pull Request.

🛣 Roadmap

Theme support Better analytics dashboard CSV export Windows executable release Sound notifications Multi-day reports 🛠 Troubleshooting Terminal UI broken

Resize terminal window larger and rerun.

Keys not responding

Use Windows Terminal or Command Prompt with latest updates.

Build issues

cargo clean
cargo run

📜 License

MIT License

👤 Author

Built with ❤️ by Bhavadharani

🧠 Philosophy

Discipline beats mood.
Consistency beats intensity.
Ship daily.