๐Ÿ“š Zeba Academy Study Room

Zeba Academy Study Room is a Flutter productivity package that helps developers build focused learning experiences inside their applications.

It provides tools for creating virtual study environments with:

  • โฑ๏ธ Focus Timer
  • ๐Ÿ“– Study Sessions
  • ๐Ÿ  Virtual Study Rooms
  • ๐ŸŽฏ Goals Tracking
  • ๐Ÿ“Š Productivity Statistics

โœจ Features

โฑ๏ธ Focus Timer

Create productive study sessions using a built-in focus timer.

Features:

  • Pomodoro-style sessions
  • Start / pause / stop controls
  • Countdown support
  • Custom focus duration

Example:

FocusTimer()

๐Ÿ“– Study Sessions

Track learning activities.

Includes:

  • Session creation
  • Duration tracking
  • Session history
  • Productivity calculations

Example:

final session = StudySession(

id: "session_1",

start: DateTime.now(),

duration:
const Duration(minutes:30),

);

๐Ÿ  Virtual Study Rooms

Create virtual rooms where learners can organize their study environment.

Example:

final room = StudyRoom(

id:"flutter",

name:"Flutter Study Room",

members:5,

);

๐ŸŽฏ Goals

Manage learning goals and track progress.

Example:

final goal = StudyGoal(

id:"goal1",

title:"Learn Flutter",

targetMinutes:120,

);

Check completion:

goal.completed

๐Ÿ“Š Productivity Statistics

Monitor learning progress.

Available statistics:

  • Total study minutes
  • Completed goals
  • Session count
  • Room activity

Example:

final controller =
StudyController();


print(
controller.totalMinutes
);

๐Ÿš€ Installation

Add dependency:

dependencies:

  zeba_academy_study_room: ^1.0.0

Run:

flutter pub get

๐Ÿ“ฆ Import

import 'package:zeba_academy_study_room/zeba_academy_study_room.dart';

๐Ÿ›  Usage

Create controller:

final study =
StudyController();

Add a session:

study.addSession(

StudySession(

id:"1",

start:DateTime.now(),

duration:
Duration(minutes:45),

)

);

Get productivity:

print(
study.totalMinutes
);

๐Ÿงช Testing

Run tests:

flutter test

Analyze package:

flutter analyze

๐Ÿ“ Package Structure

lib/

โ”œโ”€โ”€ models/

โ”‚   โ”œโ”€โ”€ study_session.dart
โ”‚   โ”œโ”€โ”€ study_goal.dart
โ”‚   โ””โ”€โ”€ study_room.dart


โ”œโ”€โ”€ services/

โ”‚   โ””โ”€โ”€ timer_service.dart


โ”œโ”€โ”€ controllers/

โ”‚   โ””โ”€โ”€ study_controller.dart


โ”œโ”€โ”€ widgets/

โ”‚   โ””โ”€โ”€ focus_timer.dart


โ””โ”€โ”€ zeba_academy_study_room.dart

๐Ÿค Contributing

Contributions are welcome!

Steps:

  1. Fork the repository

  2. Create a branch

git checkout -b feature/new-feature
  1. Commit changes
git commit -m "Add new feature"
  1. Push
git push origin feature/new-feature
  1. Create Pull Request

๐Ÿ‘จโ€๐Ÿ’ป About Me

โœจ Iโ€™m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects.

Learn more:

๐ŸŒ Website: https://sufyanism.com/

๐Ÿ’ผ LinkedIn: https://www.linkedin.com/in/sufyanism


๐ŸŽ“ Zeba Academy

Your all-in-one learning hub!

๐Ÿš€ Explore courses and resources in coding, technology, and development.

Build practical skills through:

  • Curated tutorials
  • Real-world projects
  • Hands-on experience

Visit:

๐ŸŒ Main Website:

https://zeba.academy

๐Ÿ’ป Coding Resources:

https://code.zeba.academy

โ–ถ YouTube:

https://www.youtube.com/@zeba.academy

๐Ÿ“ธ Instagram:

https://www.instagram.com/zeba.academy/


๐Ÿ“„ License

This project is licensed under the GNU General Public License v3.0.

You are free to:

  • Use
  • Modify
  • Share
  • Distribute

under the conditions of GPL v3.

See:

LICENSE

โญ Support

If this package helps you:

โญ Star the repository

๐Ÿ› Report issues

๐Ÿ’ก Suggest improvements

Thank you for using Zeba Academy Study Room โค๏ธ