Added setting up application to README.md file

Author: BenFaruna

README.md

@@ -1 +1,66 @@
-# how-to-integrate-django-with-mongo
+# Integrate Django with MongoDB
+
+Code sample on [how to integrate `Django` and `MongoDB`](https://docs.appseed.us/technologies/django/integrate-mongodb/). Open source Django dashboard generated by `AppSeed` as the user interface of the web application.
+
+## Requirements
+To use the following code, you need to have the following tools installed on your computer.
+- Python3
+- MongoDB server
+
+## Links
+- [Python](https://www.python.org/downloads/)
+- [MongoDB](https://www.mongodb.com/try/download/community)
+- [Django Soft Dashboard](https://github.com/app-generator/django-admin-soft-dashboard)
+
+
+## Features
+- Simple, intuitive codebase - built for beginners (can be extended with ease)
+- `Design`: [Django Soft Dashboard](https://github.com/app-generator/django-admin-soft-dashboard) - Free Version
+- `Sections` covered by the design:
+    - Admin section (reserved for superusers)
+    - Authentication: Django.contrib.AUTH, Registration
+    - All Pages available in for ordinary users
+- `Persistence`: `MongoDB`
+
+
+## How to use the code
+### Start `MongoDB` service
+For **`Unix`, `MacOS`**
+```bash
+$ sudo service mongod start
+```
+
+For **`Windows`**:
+
+`Mongod` starts automatically when MongoDB is installed as a service. If not check [here](https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-windows/#if-you-installed-mongodb-as-a-windows-service)
+
+### Clone the sources
+```bash
+$ git clone https://github.com/app-generator/how-to-integrate-django-with-mongo.git
+$ cd how-to-integrate-django-with-mongo
+```
+### Create a virtual environment
+For **`Unix`, `MacOS`**:
+```bash
+$ virtualenv -p python3 venv
+$ source venv/bin/activate
+```
+
+For **`Windows`**:
+```bash
+$ virtualenv venv
+$ .\venv\Scripts\activate.bat
+```
+
+### Install dependencies using pip
+```bash
+(venv)$ pip install -r requirements.txt
+```
+
+### Start the API server
+```bash
+(venv)$ python manage.py migrate
+(venv)$ python manage.py createsuperuser # create the admin
+(venv)$ python manage.py runserver
+```
+At this point, the app runs at `http://127.0.0.1:8000/`

requirements.txt

@@ -0,0 +1,8 @@
+asgiref==3.6.0
+Django==4.1.8
+django-admin-soft-dashboard==1.0.12
+djongo==1.3.6
+dnspython==2.3.0
+pymongo==3.12.3
+pytz==2023.3
+sqlparse==0.2.4