🔮 Screenshots from manhal.app

🔐 Auth

---

🏠 Home

---

🧭 Navigation

---

📚 Library

---

This project is a full-stack application consisting of a Flutter frontend, a Node.js backend, FastAPI script and MongoDB as the database. The backend provides the API, and the frontend is a Flutter application that communicates with it.

Prerequisites

Before getting started, ensure that the following are installed:

• Git
• Node.js
• Flutter
• [Flutter SDK Version required is 3.6.0]
• [Java Version required is Java 17]
• MongoDB
• MongoDB Compass
• MongoDB Shell

Getting Started

Follow these steps to get the project running locally:

1. Clone the Repository

Clone the project to your local machine using Git:

git clone https://github.com/zaki-reg/manhal.app.git

2. Backend Setup (Node.js + MongoDB)

Navigate to the backend directory:

cd manhal.app
cd backend

Install the required dependencies:

npm install

Run the server using nodemon (it automatically restarts the server on code changes):

nodemon server.js

Ensure that MongoDB is running locally or use a remote MongoDB instance. Update the MongoDB connection URL in the backend configuration if necessary (.env file) by default the port is 4000 the URI: http://localhost:4000

3. Frontend Setup (Flutter)

Navigate to the frontend directory:

cd ..
cd frontend

Get the required Flutter dependencies:

flutter pub get

Run the Flutter app on your local device or emulator:

flutter run

The app should now be running and communicating with the backend.

Troubleshooting If you encounter issues with the flutter run command, ensure that your Flutter environment is correctly set up.

Run this to check your flutter environment:

flutter doctor

For more details:

flutter doctor -v

If nodemon is not working, make sure you have it installed globally by running: npm install -g nodemon.

npm install -g nodemon

Ensure MongoDB is running and properly configured. You can start it manually or using MongoDB Compass. Manually you can run this command:

mongod

With MongoDB compass, All you have to do is click "CONNECT".