https://github.com/skyost/beerstory
Save your favorite beers and find them back instantly !
https://github.com/skyost/beerstory
android application beer beerstory ios library
Last synced: 2 months ago
JSON representation
Save your favorite beers and find them back instantly !
- Host: GitHub
- URL: https://github.com/skyost/beerstory
- Owner: Skyost
- License: mit
- Created: 2019-12-11T19:18:35.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2025-08-06T12:03:16.000Z (2 months ago)
- Last Synced: 2025-08-06T14:14:33.992Z (2 months ago)
- Topics: android, application, beer, beerstory, ios, library
- Language: Dart
- Homepage: http://skyost.eu/Beerstory/
- Size: 9.76 MB
- Stars: 6
- Watchers: 3
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Beerstory
Never forget a great brew again — Beerstory helps you keep track of your favorite beers and all the details you care about: alcohol degree, photo, your personal rating, tasting notes, tags, price in your favorite bars, and so much more.
Beerstory is more than just a memory aid — it becomes your very own beer journal, letting you build a true history of your tastings.
## Features
Here are some highlights :
* Lightweight and easy to use.
* 100% open-source.
* Save beers, bars, and even your consumption history.
* Powerful tagging and search to quickly find any beer.
## So what are your waiting for ?
Carry your personal beer library in your pocket — download Beerstory now ! Pick your platform :
either the [Google Play Store](https://play.google.com/store/apps/details?id=fr.skyost.beerstory) or the
[Apple App Store](https://itunes.apple.com/app/id1491556149).
You can also try it directly in your [web browser](https://skyost.github.io/Beerstory).
## Developers
### Technologies
Beerstory has been entirely created using [Flutter](https://flutter.dev). Internally, the beers, bars, and
history entries are stored in a SQLite database using [Drift](https://drift.simonbinder.eu/setup/).
State management is handled with [Riverpod](https://riverpod.dev).
[OpenFoodFacts](https://openfoodfacts.org) is used to fetch the beers metadata by barcode scanning.
It's a great initiative that you should check out !
### Building
Before everything, please make sure that Flutter is installed. Then clone this repository, and
generate required files :
```shell
flutter pub get
dart run slang
dart run build_runner build
dart run drift_dev schema steps drift_schemas lib/model/database/database.steps.dart
dart run beerstory:compile_svg
```
Then you can build the app using `flutter build `.
## License
This project is licensed under the [MIT License](https://github.com/Skyost/Beerstory/blob/main/LICENSE).
## Contributions
You have a lot of options to contribute to this project ! You can :
* [Fork it](https://github.com/Skyost/Beerstory/fork) on Github.
* [Submit](https://github.com/Skyost/Beerstory/issues/new/choose) a feature request or a bug report.
* [Donate](https://paypal.me/Skyost) to the developer.