VITAP Companion App 🎓📱

The VITAP Companion App is a comprehensive mobile application designed to revolutionize the student experience at VIT-AP University. Built with Flutter, this app provides a seamless, user-friendly platform for students to access academic information, engage with the community, and stay informed.

📦 Table of Contents

• Features
• Installation
• Screenshots
• Getting Started
• Project Structure
• Contributing
• Tech Stack
• API Integration
• Performance Metrics
• Security
• Future Roadmap
• License
• Code of Conduct
• Contact

🚀 Features

• 🎓 Academic Hub

  • Real-time attendance tracking
  • Detailed timetable management
  • Comprehensive profile information
  • Grade and performance insights
  • Outing requests with ease

• 💬 Community Platform

  • Engage with others through Posts
  • Like, Dislike and Comment on others posts
  • Moderation tools

• ⏰ Smart Notifications

  • Class alerts
  • Exam alerts
  • Important university announcements

• 🌦️ Live Utilities

  • Local weather updates
  • Campus event notifications
  • Quick access to useful student made tools

• 🎨 User Experience

  • Adaptive theme modes
  • Responsive design
  • Intuitive navigation

💻 Installation

Prerequisites

• Flutter SDK 3.10+
• Dart SDK
• Android Studio or VS Code
• Android device/emulator (Android 6.0+)

Setup Steps

1. Clone the repository

   git clone https://github.com/Udhay-Adithya/vit_ap_student_app.git
   cd vit_ap_student_app

2. Install dependencies

   flutter pub get

3. Run the app

   flutter run

📸 Screenshots

🏗️ Project Structure

vitap_companion_app/
│
├── lib/
│   ├── pages/
│   ├── models/
│   ├── widgets/
│   └── utils/
│
├── assets/
│   ├── fonts/
│   ├── images/
│   └── weather_icons/
│
└── docs/

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Contribution Guidelines

• Follow Flutter/Dart style guidelines
• Write comprehensive unit and widget tests
• Update documentation
• Maintain code quality

🛠️ Tech Stack

• Framework: Flutter 3.24.2
• State Management: Riverpod
• Network: http
• Persistence: Hive/Shared Preferences
• Authentication: VIT-AP VTOP API & VTOP
• Backend: VIT-AP VTOP API

🔌 API Integration

Seamlessly integrates with VIT-AP VTOP API

📊 Performance Metrics

• App Size: < 75 MB
• Startup Time: < 2 seconds
• API Response Time: < 2500ms
• Battery Usage: Optimized for minimal drain

🔒 Security

• Platform-Specific Encryption:
  • iOS: Keychain for secure credential storage
  • Android:
    • AES encryption for data protection
    • AES secret key encrypted with RSA
    • RSA key stored in Android KeyStore
• Secure API communication
• Regular security audits

🗺️ Future Roadmap

• Implement friend scheduling feature with privacy controls
• Add at least 3 new custom themes
• Create push notification system for exam schedules

💖 Support the Project

Maintaining this app involves monthly backend hosting costs. Your support helps keep the project alive!

Donation Methods

• Buy Me a Coffee: Support Project
• Google Pay (GPay): Donate via UPI

Every contribution, no matter how small, helps sustain the app and supports student-driven innovation. 🙏

📄 License

Distributed under GNU General Public License v3.0. See LICENSE for more information.

📢 Disclaimer

Note: This is a community-driven project and is not an official VIT-AP University application. Developed by students, for students.

📧 Contact

Udhay Adithya - [email protected]

Project Link: https://github.com/Udhay-Adithya/VITAP-Companion-App

---

Give a ⭐ to support the project!