This Android app shows dish menus for CTU cafeterias from the agata.suz.cvut.cz and studentcatering.cz websites in a much more pleasant and usable way for phones. It shows today's and this week's menu, opening hours, contacts, announcements and addresses for all canteens.
Core parts are written in Kotlin Multiplatform, support for JVM target can be added right away. Other targets require more work (non-JVM web scraping library required), but it still may be manageable for somebody to port this codebase to native or js platforms.
See contributing below.
Menza is the Czech word for school cafeteria.
- AndroidX (Compose, ...)
- ArrowKt
- Decompose
- SQLDelight
- Koin
- Coil-kt
- Ktor
- And more
The core of the all in written in Kotlin Multiplatform!
- Today's menu + dish details
- This week's menu
- Menza opening hours, contacts, announcements and addresses
- Dark theme
- Many themes along with support for Android 12 Material You dynamic theming
- Images download switch on metered networks (~0.7 MB per image)
- Image caching
- No private data collection
- Proper landscape mode and large screen device support
Feel free to contribute, but contact me before please, so we don't do the same thing twice. If you are new to Kotlin/Android, you can write the code yourself, and I'll adjust it to the rules below. So it's fine to write it wrong (different), but don't be surprised when I rewrite it.
Most of the modules are multiplatform, and you should respect it.
That means write as much code as possible into the common code and
if there is no (nice) way to implement feature in a multiplatform manner,
this is the time when you can use platform specific package.
Even in that case put at least an interface into the common code
and tie it using DI (preferred over expected/actual keywords).
The whole app tries to respect clean architecture principles and MVVM architecture. There is also domain layer presented (use cases). The whole app is tied together using DI.
api/core- core classes for network communication, store, synchronization, ...api/agata,api/buffet- implementation for individual canteen providerapi/main- packs all the providers into one interface, contains related business logicapp- only UI related code, purely Android (for now)features- stores all the UI coderoot- decides if the user is already logged instarting- stores setup related codemain- holds main user interface (after login), drawer, top/bottom bar, core navigationtoday- the main screen, shows today canteen offeringweek- shows week canteen offeringinfo- shows canteen infopanels- panels for the today screen (rate us, report a crash, what's new, ...)settings- self-explanatory, includes about screenothers- privacy policy, library notices, ošťurák, ...
core- holds main shared domain logic and templatesOutcome- like Rust'sResult, success orDomainError. all the functions that can fail should returnOutcome.UseCase- base usecase classBaseViewmodel- parent of all the ViewModels
lastaapps- my legacy common shared code (+ crash reporting)
Namely, modules entity, html-parser, scraping and storage.
They were used by the first version of menza and are kept for future in case
I lost access to the API.
Most of the data is obtained from the official Agata API, see the documentation here. To get your API key, please contact the IT center and don't steal mine, they will be more than happy to give you one.
To get FS and FEL buffet data I do scrape their webpages/hardcode info.
Menza is licensed under the GNU GPL v3.0 license.