Skip to content

Roost is a mobile-first digital solution designed to streamline hostel-related operations such as student registration, attendance tracking, complaint management, food scheduling, and fee handling.

Notifications You must be signed in to change notification settings

Muflih-uk/Roost

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

50 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏠 Roost

Project Banner with Mockups

Roost is a mobile-first digital solution to streamline hostel-related operations such as student registration, attendance and food scheduling. It offers a centralized platform for both students and administrators to interact seamlessly and manage hostel life efficiently. Made using Flutter


πŸš€ Features

πŸ‘¨β€πŸŽ“ Student View

  • πŸ“Š Dashboard:

    • Attendance tracking
    • Meal tracking
  • πŸ“† Attendance:

    • Toggle In/Out to mark hostel presence
    • View attendance history by date
  • 🍽️ Food Scheduling:

    • Pre-schedule food availability
    • Overview of student meal preferences by date

πŸ› οΈ Admin Dashboard (In Plans)

  • πŸ‘₯ Student Management (Registration):

    • Add/Update student details
    • Move students between rooms
    • Remove students
  • πŸ“ˆ Attendance Overview:

    • View individual student attendance records

🧰 Tools & Technologies

Component Technology
Planning Google Docs
Design Figma
Frontend Flutter (Mobile)
Backend Express.js (Node.js)
Database MongoDB Atlas
Authentication OTP-based login
Hosting Vercel
File Storage Cloud storage (for profile images)

πŸ” Authentication

  • username and passwords.

πŸ“¦ Project Structure (Coming Soon)

.
β”œβ”€β”€ frontend/         # Flutter mobile app
β”œβ”€β”€ backend/          # Node.js Express API
β”œβ”€β”€ docs/             # Planning & architecture, etc.
└── README.md

πŸ›£οΈ Roadmap

  • βœ… Food scheduling
  • βœ… Attendance toggle and overview
  • βœ… Monthly attendance analysis
  • ⏳ Basic admin dashboard
  • ⏳ Admin room allocation flow
  • ⏳ UI polish & mobile responsiveness

πŸ‘₯ Target Users

  • Students: Schedul meals and mark attendance.
  • Administrators: Manage students and monitor attendance.

🀝 Contribution

Pull requests are welcome. For major changes, please open an issue first to discuss what you'd like to change.


About

Roost is a mobile-first digital solution designed to streamline hostel-related operations such as student registration, attendance tracking, complaint management, food scheduling, and fee handling.

Topics

Resources

Stars

Watchers

Forks

Contributors