Skip to content

Photon3009/Auberge

Repository files navigation

Auberge - IET Hostel Management App

🏨📱 Auberge - IET Hostel Management App 🚀

  • Welcome to Auberge, the cutting-edge hostel management app designed with 💖 for hostel residents and administrators alike! Powered by the latest technologies like Flutter, Firebase, and Google Sheets API, Auberge offers a seamless and efficient platform for managing all aspects of hostel life.

  • 📢 Stay informed! With Auberge, residents receive important announcements from administrators right at their fingertips. No more missing out on crucial updates!

  • 🛠️ Report maintenance issues made easy! Residents can effortlessly submit maintenance complaints through the app, ensuring a swift resolution to any problems.

  • 🍽️ Hungry? Check out the daily mess menu! Auberge provides daily updates on the mess menu, making it a breeze for residents to plan their meals. 🍕🍔🍲

  • 😋 Share your thoughts on food quality! With Auberge, residents can provide valuable feedback by rating the food they eat. Let's make the mess even better together! 👍👎

  • 🌟 Elegant and user-friendly! Auberge boasts a sleek interface that guarantees a delightful user experience. Smooth sailing through every feature! ⛵

  • 🌟 Join the Auberge community! As an open-source app, we warmly welcome contributions from passionate developers like you! 🤝 Together, we can make Auberge even more extraordinary! 🚀

With Auberge, hostel management has never been more efficient and enjoyable. Join us in this exciting journey of innovation and excellence!

Logo

Table of Contents

Features

  • Announcements and Notifications 🔔: Administrators can effortlessly send important announcements to all residents through the app in real-time. Stay informed about events, notices, and updates!

  • Complaint Management 🛠️: Lodge maintenance complaints with ease through a user-friendly interface. We ensure prompt attention to problems, leading to a smoother living environment.

  • Mess Menu Updates 🍽️: Access daily updated mess menus through the app to plan your meals accordingly and improve your mealtime experiences.

  • Food Rating System 🌟: Provide feedback on the quality of daily mess food through our rating system. Foster transparency and encourage continuous improvement in food services.

  • User-Friendly UI 🎨📱: Auberge boasts a beautiful and intuitive user interface, ensuring a pleasant experience for all users. The clean design enhances navigation and usability.

  • Future Feature Expansion 🚀🔮: As an open-source project, we welcome contributions from developers like you! Expect exciting new features in the future, ensuring the app remains relevant and constantly evolving to meet users' needs.

UI Preview

Splash Screen Onboarding Screen Login/SignUp Screen
animated animated animated

UserSection

Announcements Screen User Complaint Screen Mess Screen User Profile Screen
animated animated animated animated

Admin Section

Mess Menu Change Screen Admin Complaint Screen Mess Screen Create Announcement Screen
animated animated animated animated

Getting Started

To run this app on your local machine, follow these steps:

Prerequisites

  • Flutter SDK: Make sure you have Flutter installed on your machine. You can download it from the official Flutter website.

Installation

  1. Clone the repository:
   git clone https://github.com/Photon3009/Auberge.git
  1. Navigate to the project directory:
   cd Auberge
  1. Install dependencies:
   flutter pub get

Firebase Setup

In order to enable authentication and Firestore services for the Auberge app, follow these steps to set up Firebase in your project:

Step 1: Create a Firebase Project

  1. Go to the Firebase Console.

  2. Click on "Add project" and provide a name for your project.

  3. Follow the on-screen instructions to create the Firebase project.

Step 2: Enable Authentication

  1. In the Firebase Console, navigate to "Authentication" from the left-side menu.

  2. Click on "Get started" and then choose the "Sign-in method" tab.

  3. Enable the sign-in methods you want to use for authentication (e.g., Email/Password, Google Sign-In, etc.).

Step 3: Enable Firestore Database

  1. In the Firebase Console, navigate to "Firestore Database" from the left-side menu.

  2. Click on "Create database" and choose "Start in test mode" for development purposes.

  3. Choose a region for your database.

  4. Click "Enable" to create the Firestore database.

Step 4: Add Firebase Configuration to Your App

  1. For Flutter apps, add the Firebase configuration to the android/app and ios/Runner folders.

    • For Android:

      • Download the google-services.json file from the Firebase Console.
      • Place the google-services.json file inside the android/app directory.
    • For iOS:

      • Download the GoogleService-Info.plist file from the Firebase Console.
      • Place the GoogleService-Info.plist file inside the ios/Runner directory.
  2. In your Flutter project, add the Firebase packages:

    dependencies:
      flutter:
        sdk: flutter
      firebase_core: ^latest_version
      firebase_auth: ^latest_version
      cloud_firestore: ^latest_version
    

Google Sheets API Setup

  • You can check out this youtube video for setting up GSheets API for this project or can follow below steps: Youtube Link
  1. Create a new project on the Google Developers Console.

  2. Enable the Google Sheets API for your project.

  3. Generate and download the API credentials (JSON format).

  4. Don't forget to place your API credentials and spreadsheetID in auberge\lib\ghseets.dart.

ghseets
  1. At last add sheets for all hostels of IET LKO in your spreadsheet project like below: (Enter any dummy data in them to test the app)
ghseets

Run the app

flutter run

Contributing

We welcome contributions to Auberge! 👋 By contributing to Auberge, you can help us refine existing features, add exciting new functionalities, improve user experience, and address issues. Your expertise and creativity can play a vital role in making Auberge even more robust and user-friendly.

Whether it's coding, testing, documenting, or providing valuable insights, your contributions are valuable and highly appreciated. Together, we can foster a collaborative environment that empowers users and elevates the app to new heights.

To contribute, follow these steps:

Fork the Repository

  • Click on the "Fork" button at the top right of this repository to create your fork.

Create a New Branch

  • Create a new branch for your changes:
git commit -m "My feature implementation"
git push origin my-feature

Make Changes

To make changes to the project or add new features, follow these steps:

  1. Open the project in your preferred code editor or IDE.

  2. Navigate to the relevant files you want to modify or add new features.

  3. Make the necessary changes to the codebase.

  4. Save the changes.

Commit and Push

After making the changes, follow these steps to commit and push them to your GitHub repository:

  1. Open a terminal or command prompt.

  2. Navigate to the project directory.

  3. Add the changes to the staging area:

Commit and Push

After making the changes, follow these steps to commit and push them to your GitHub repository:

  1. Open a terminal or command prompt.

  2. Navigate to the project directory.

  3. Add the changes to the staging area:

   git add . //The dot . adds all the changed files to the staging area. Alternatively, you can specify the file name to add individual files.
   git commit -m "Brief description of the changes made" //Commit the changes with a descriptive message
   git push origin main //Replace main with the branch name if you are using a different branch.

Submit a Pull Request

  • Go to the original repository on GitHub and click on "Compare & pull request."

  • Fill in the necessary details about your changes and click on "Create pull request."

  • Your pull request will be reviewed, and once approved, your changes will be merged into the main repository.

Pre-Release Version

A pre-release version of Auberge is available for testing and feedback. You can access the pre-release on the Releases page. Please download the APK file for the pre-release and feel free to provide feedback and report any issues you encounter. Your feedback is valuable in improving Auberge for everyone. Screenshot (633)

Testing Credentials

User Credentials

Admin Credentials

License

This project is licensed under the MIT License.

Contact

For any inquiries or questions, you can reach out to the project maintainer:

If you like this project then, show ❤️ by ⭐ this repository.

Happy coding😊