VubHub - The unofficial vub app

I don't own an android device :(

There is no IOS build yet, however we did build a web application that of course runs on any device. Now you can easily check your class schedules on your computer too. Visit the vubhub.me site to see for yourself. (Please note that the vubhub.me site is still under heavy development)

Now if you want to have a real app experience, you can add the vubhub.me site to your homescreen.

To do so:

• Go to vubhub.me using safari.
• Click the share button on the bottom of the screen (the middle one)
• Select "Add to Home Screen"
• Press the "Add" button

This still does not give you any offline view and currently has no canvas support either, but its a start.

Info

This app hopes to make any VUB students life easier by concentrating all the information and VUB features into a single app. VubHub currently supports an easy to read class schedule, news feed, partial Canvas functionality, a library seat registration system and more, however that's not all because additional features are soon to come. If you like the idea and want to contribute feel free to play around with the code and make some pull requests. If you are not a programmer, don't worry you can still help us by just using the app and giving us feedback and new ideas. You can contact me (the lead developer) via the help section in the app or by create an issue in this repository.

How safe is this?

Safety is very important to us, so we want to be as transparent as possible in what data we save.

Android app

This app is mainly build of two components. The canvas dependant functionality and the canvas independent functionality.

Let us begin with the canvas independent functionality. These are all the features like class schedule view, news feed, campus map etc. These do not depend on any personal information (except the education you select).

The other part, the canvas dependant functionality does not save more information then the actual real canvas app. We just save your 'canvas oauth2 token' which is basically your login identity. This does not mean your password! We never even have your password because you fill it into the canvas site directly (viewed through a webview in the app), which then returns us a oauth2 token. On top of that, some data from canvas is cached and saved to make the app a little smoother (name, user id, email, locale. See user.dart to view the complete structure). This data is still only saved on your device, we do not store any data of you elsewhere. Making the canvas features perfectly safe.

It is however perfectly possible to use the app without canvas if you choose to.

vubhub.me web application

The web application currently does not support canvas yet. This is due to the fact that building a reliable and most importantly safe login system for canvas is hard on the web. On top of that requests like getting class schedule data have to go through our own server because of cors policy.

Currently we use cookies and local browser storage to save your user data (education type, faculty, groups, etc.). And we intent to keep it that way because this is the easiest solution.

Roadmap

• Dark mode
• Message the user when their class schedule changes
• Lecture filters
• Periodic class schedule updates
• More canvas features
  • Announcements
  • Assignments
  • Chat
  • Modules
  • Meetings
  • Files
  • External tools
  • Discussions
  • Syllabus
• Multiple interactive campus map's
• Further desktop web development
• 'Remind me about this lecture' feature
• More 'places' in the places tab, e.i. food places, free rooms etc.
• Additional student news section where students can share information
• Erasmus hoge school support
• Maybe ULB support
• NL locale
• A goddammed IOS build.

Help me!

I don't see any lectures

Check if you have selected the correct education type, faculty, education and groups. If there are still no lectures, try the reload button on the top right. And if all else fails try to remove the app's stored data and retry.

Building the app

Vubhub is written in Dart / flutter so to build the app from source you will need to install flutter. (Note that for ios you also need Xcode to install and sign the app)

Afterwards you can just run flutter build followed by apk, ios or web. This will build the app in debug mode. If you want a release build you need to add the --release flag. So all together that leaves us with:

flutter build apk --release     (android)
flutter build ios --release     (ios)
flutter build web --release     (web)

This will build the app somewhere in the build/ folder. If you don't care about building and you just want to run it directly you can run

flutter run apk --release
flutter run ios --release
flutter run web --release

If you are planning on playing with the vubhub code and making changes, it might be better to run the app in --debug mode.

License

GPL-3.0. See the LICENSE file for more information.