99 lines
2.3 KiB
Markdown
99 lines
2.3 KiB
Markdown
# DeguApp
|
|
|
|
DeguApp is an application designed for beer tasting enthusiasts to rate beers during tastings.
|
|
|
|
## Features
|
|
|
|
- **Adding Beers**: Users can add new beers to the app's database.
|
|
- **Beer Rating**: Users can rate beers based on their taste and experience.
|
|
- **Creating Sessions**: Users can create shared tasting sessions with friends.
|
|
- **Review Overview**: Users can view reviews from all users.
|
|
- **User Average Rating**: Users can see the average rating of each beer.
|
|
|
|
## Technologies Used
|
|
|
|
- **Backend API**:
|
|
- Node.js
|
|
- Express.js
|
|
- Nork
|
|
- TypeScript
|
|
- MongoDB (for database storage)
|
|
|
|
- **Android and Web App**:
|
|
- Expo
|
|
|
|
## Getting Started
|
|
|
|
To get started with DeguApp, follow these steps:
|
|
|
|
1. Clone the repository:
|
|
|
|
```bash
|
|
git clone https://git.filiprojek.cz/fr/deguapp.git
|
|
```
|
|
|
|
2. Install dependencies:
|
|
|
|
```bash
|
|
# frontend
|
|
cd deguapp/frontend
|
|
npm install
|
|
|
|
# backend
|
|
cd deguapp/api
|
|
npm install
|
|
```
|
|
|
|
3. Will be added in the future:)
|
|
|
|
5. Open the app in your browser or Android emulator and start exploring!
|
|
|
|
## Local builds
|
|
### Android
|
|
|
|
```bash
|
|
cd frontend/
|
|
npm i
|
|
|
|
export ANDROID_HOME=$HOME/.Android/Sdk/
|
|
export PATH=$PATH:$ANDROID_HOME/emulator
|
|
export PATH=$PATH:$ANDROID_HOME/platform-tools
|
|
|
|
echo "EXPO_PUBLIC_API_URL=https://degu.filiprojek.cz/api/v1" > .env
|
|
|
|
npx expo prebuild
|
|
|
|
# edit gradle.properties and add info about signing key
|
|
# copy signing key to android/app/[keyname].keystore
|
|
# edit android/app/build.gradle
|
|
|
|
npx react-native build-android --mode=release
|
|
|
|
bundletool build-apks --bundle=./frontend/android/app/build/outputs/bundle/release/app-release.aab --output ./deguapp.apks --ks <upload-key.keystore> --ks-key-alias <upload-key-alias>
|
|
|
|
bundletool install-apks --apks=./deguapp.apks
|
|
```
|
|
|
|
#### Resources:
|
|
|
|
- https://github.com/expo/eas-cli/issues/1300
|
|
- https://reactnative.dev/docs/signed-apk-android#generating-the-release-aab
|
|
|
|
### Server
|
|
|
|
```bash
|
|
cd api/
|
|
npm i
|
|
npm run build
|
|
```
|
|
|
|
## Contributing
|
|
|
|
Contributions are welcome! If you'd like to contribute to DeguApp, please fork the repository and submit a pull request with your changes.
|
|
Use the upstream of the project, which can be found at https:/git.filiprojek.cz/fr/deguapp. **GitHub repository is just a mirror!**
|
|
|
|
## License
|
|
|
|
This project is licensed under the GNU GPLv3 License - see the [LICENSE](LICENSE) file for details.
|
|
|