VIT Verse (VIT Connect)

An unofficial, student-developed companion app for VIT Chennai students

Features • Installation • Setup • Contributing • License

---

📋 About

VIT Verse is a feature-rich Flutter application designed to enhance the academic experience of VIT Chennai students. It provides seamless access to VTOP data, community features, and campus utilities... all in one place.

⚠️ Disclaimer: This app is NOT officially affiliated with, endorsed by, or connected to VIT Chennai or VIT University.

---

✨ Features

📚 VTOP Integration

• Smart Login with 3-stage CAPTCHA solving (95%+ accuracy)
• Profile & Academic Data - View attendance, marks, timetable, and grades
• Real-time Sync - Fetch latest data directly from VTOP
• Offline Access - All data cached locally with AES-256 encryption

📊 Performance Analytics

• CGPA/GPA Calculator with predictor and estimator
• Grade History with visual charts and insights
• Attendance Tracking with alerts and predictions
• Performance Trends across semesters

🎓 Community Features

• Faculty Ratings - Anonymous faculty reviews and ratings
• Cab Share - Find students for ride-sharing
• Lost & Found - Report and find lost items on campus

🛠️ Utilities

• Mess Menu - Daily meal schedules
• Laundry Tracking - Track laundry status
• Exam Schedule - Never miss an exam
• Announcements - Stay updated with VTOP notifications

🎨 User Experience

• Dark/Light Mode with customizable themes
• Widget Customization - Personalize your dashboard
• Smooth Animations with Lottie
• Responsive Design for all screen sizes

---

🚀 Installation

Prerequisites

• Flutter SDK 3.7.2 or higher
• Dart SDK 3.0 or higher
• Android Studio / VS Code
• Git

Download

Clone the repository:

git clone https://github.com/vit-verse/vitverse-app.git
cd vit-connect

---

⚙️ Setup

1. Install Dependencies

flutter pub get

2. Configure Environment Variables

Create a .env file in the root directory:

cp .env.example .env

Edit .env and add your configuration:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your_supabase_anon_key_here
GITHUB_VITCONNECT_TOKEN=your_github_token_here
FACULTY_RATING_SCRIPT_URL=https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec

3. Firebase Setup (Optional)

• The app includes Firebase configuration for analytics and crashlytics
• google-services.json is already configured for the project
• Firebase API keys are SHA-1 restricted for security

4. Run the App

flutter run --dart-define-from-file=.env

Or use the VS Code task: "Load .env for debugging"

---

🏗️ Project Structure

lib/
├── core/              # Core utilities, config, theme, services
├── features/          # Feature modules (authentication, dashboard, etc.)
├── firebase/          # Firebase integration (analytics, crashlytics)
├── supabase/          # Supabase integration (optional cloud features)
└── main.dart          # App entry point

assets/
├── icons/             # App icons and UI assets
├── images/            # Images and illustrations
├── lottie/            # Lottie animation files
└── ml/                # ML models for CAPTCHA solving

---

🔒 Security & Privacy

• VTOP Credentials: AES-256 encrypted and stored locally only
• No Data Collection: Your academic data never leaves your device
• Local CAPTCHA Solving: On-device ML models (no external API calls)
• Firebase Analytics: Anonymous usage statistics only
• Community Features: Voluntary participation with visible identity

For complete details, see Privacy Policy .

---

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Quick Start

1. Fork the repository
2. Create your feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'feat: add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

📞 Contact & Support

Developer: Divyanshu Patel
Email: itzdivyanshupatel@gmail.com
GitHub: @divyanshupatel17
LinkedIn: Divyanshu Patel

---

⚠️ Important Notes

1. Educational Purpose: This app is built for educational purposes and to enhance student experience
2. No Warranty: The app is provided "as is" without any warranties
3. Not Affiliated: This is an unofficial app and not endorsed by VIT
4. Use Responsibly: Use only your own VTOP credentials and respect VIT's policies

---

🙏 Acknowledgments

• VIT Chennai students for feedback and testing
• Flutter & Dart communities for excellent documentation
• All open-source contributors whose packages made this possible

---

Made with ❤️ by Div

⭐ Star this repo if you find it helpful!