Table of contents
This Android application allows you to manage a complete wine cellar entirely offline, with a modern interface following Material You principles.
It offers advanced wine management, powerful sorting options, quick stock editing, and the ability to export the database.
The goal is to provide an elegant, fast, intuitive, and fully customizable application.
- Material You interface (dynamic themes, adaptive colors)
- Add a wine through a multi‑page form (one group of fields = one page)
- Sorting menu allowing wines to be sorted by any field
- Add, edit, and delete wines
- Quick stock adjustment using + / - buttons
- Export the database to CSV or Excel
- All fields are optional when adding a wine
Details
- Wine name
- Producer / Estate
- Cuvée
- Vintage
- Wine type (sparkling, sweet, dry, semi‑dry, dessert, liqueur, other)
- Color (red, white, rosé, other)
Details
- Country
- Wine region
- Sub‑region
- Appellation
- Classification (Grand Cru, Premier Cru…)
Details
- Main grape variety
- Blend
- Percentage of each grape
Details
- Alcohol content (%)
- Residual sugar
- Acidity
- pH
- Bottle volume
- Cork type
- Serving temperature
Details
- Vinification method
- Fermentation type
- Aging duration
- Barrel type
- Time in oak
Details
- Visual appearance
- Aromas
- Flavors
- Structure (tannins, acidity, body)
- Finish
- Overall rating
Details
- Recommended dishes
- Cuisine type
- Occasions
- Aging potential
- Optimal drinking date
- Label condition
- Awards / medals
- Recognized critics
Details
- Price
- Availability
- Distributor / wine shop
- Product code / SKU
- Barcode
- Stock quantity
- Cellar location
- Purchase date
- Purchase price
Details
- General description
- Kotlin + Jetpack Compose (Material You)
- Local database using Room (offline)
- Multi‑screen Compose Navigation
- CSV/Excel export via dedicated libraries
- MVVM architecture
- Kotlin JVM Target 11 | Compile SDK Version 36 | Minimin SDK 26
- Advanced search
- Statistics (distribution by country, color, vintage…)
- Optimized tablet mode
- Encrypted local backup
- Unit tests (ViewModels, Repository)
- UI tests (Compose Testing)
The user can export the complete database as:
- CSV (Excel, LibreOffice compatible)
- XLSX (native Excel)
- Local backup to re‑import into the app
- Clone the repository
- Open in Android Studio
- Run the application on an Android 8+ device or emulator
GNU GENERAL PUBLIC LICENSE 3
- ✨ With a wave of pitbull's magic wand, the following information is updated via the project's Issues.
- 💡 Click on one of the cells to see the progress.
- 🤝 Well, for now I don’t know when I’ll work on it, and I know I only have a whopping 0 followers, but if there’s demand, I might look into it.
AI was used in this project, mainly for error resolution (first Kotlin project for me, I know nothing about it) and for docstrings.
Estimated carbon footprint: 200g.