🎉 Initial Release #

First stable release of zeba_academy_assignment.

A complete Flutter assignment management toolkit built for educational platforms, LMS applications, and student management systems.

---

✨ Added #

📚 Assignment Management #

Added core assignment management functionality.

Includes:

• Assignment model
• Assignment title support
• Assignment description support
• Deadline support
• Total marks support
• Assignment expiration detection

---

📝 Assignment Card UI #

Added:

AssignmentCard

Features:

• Modern Material UI design
• Assignment information display
• Deadline visibility
• Marks display
• Expired assignment indicator
• Custom tap actions

Example:

AssignmentCard(
  assignment: assignment,
);

---

⏳ Deadline Countdown #

Added:

DeadlineCountdown

Features:

• Real-time countdown updates
• Days remaining display
• Hours remaining display
• Minutes remaining display
• Automatic timer refresh
• Deadline expired state

---

📤 Submission Management #

Added:

Submission model

Supported states:

• Pending
• Submitted
• Reviewed
• Late

Example:

SubmissionStatus.submitted

---

🏷 Submission Status Widget #

Added:

SubmissionStatusWidget

Features:

• Status chip UI
• Visual submission tracking
• Easy status management
• Reusable component

---

🎓 Grading System #

Added:

GradingCard

Features:

• Student submission display
• Grade information
• Teacher grading actions
• Feedback-ready structure

---

👨‍🏫 Teacher Workflow #

Added:

TeacherWorkflow

Features:

• Review submission action
• Approval workflow
• Teacher control buttons

---

🏗 Package Architecture #

Added clean and scalable package structure:

lib/

├── models/

│   ├── assignment.dart
│   └── submission.dart


├── widgets/

│   ├── assignment_card.dart
│   ├── deadline_countdown.dart
│   ├── submission_status.dart
│   └── grading_card.dart


├── teacher/

│   └── teacher_workflow.dart


└── zeba_academy_assignment.dart

---

🎨 UI Improvements #

Added:

• Material 3 compatibility
• Responsive widgets
• Reusable components
• Developer-friendly APIs
• Clean Flutter package structure

---

🧪 Testing #

Added unit tests for:

• Assignment creation
• Assignment expiry checking
• Submission status handling
• Grade management

Validation:

flutter test

---

📖 Documentation #

Added:

• Complete README documentation
• Installation guide
• Usage examples
• API documentation
• Contribution guidelines
• GPL-3.0 license information

---

🔐 License #

Released under:

GNU General Public License v3.0 #

This package is open source and can be used, modified, and distributed under GPL-3.0 terms.

---

🚀 Future Roadmap #

Planned features:

Backend Integration #

• Firebase support
• REST API integration
• Cloud assignment storage

Student Features #

• Student dashboard
• Assignment history
• File submission
• Progress tracking

Teacher Features #

• Advanced grading panel
• Bulk evaluation
• Assignment analytics

AI Features #

• AI-assisted grading
• Feedback generation
• Assignment insights

---

👨‍💻 Maintainer #

Sufyan bin Uzayr

Open-source developer

Website:

https://sufyanism.com/

---

🎓 Zeba Academy #

Learning platform for coding, technology, and development.

Website:

https://zeba.academy

---

Thank you for using zeba_academy_assignment ❤️