/marvos-gram

A clone of the popular site Instagram(desktop version)

Primary LanguageHTML

Marvos-Gram

Author

Marvin Chomba Kangangi

Description

A personal clone of the popular photo-sharing site Instagram(desktop version)

User Stories 👪

  1. Sign in to the application to start using.
  2. Upload my pictures to the application.
  3. See my profile with all my pictures.
  4. Follow other users and see their pictures on my timeline.
  5. Like a picture and leave a comment on it.

How to use 🚀

When the user opens the website, he/she will see the will be prompted to sign up or sign in.The user will be able to see posts that other users have posted. He/she can also add their own posts. A user can follow other users and view images posted by those users The user also has a personalized profile where they can edit their profile and view the photos they have postd

Tech used 💻

  1. HTML and CSS
  2. Python
  3. Django
  4. Postgres
  5. Heroku for deployment

Set up and Installation

Prerequisites

The user will require git, django, postgres and python3.6+ installed in their machine. To install these two, you can use the following commands

#git
$ sudo apt install git-all

#python3.6
$ sudo apt-get install python3.6.

#django
$ pip install django==1.11

#postgres
$ sudo apt-get install postgresql postgresql-contrib libpq-dev

Requirements

  1. config==0.4.0
  2. dj-database-url==0.5.0
  3. Django==1.11
  4. django-bootstrap3==11.0.0
  5. django-bootstrap4==0.0.7
  6. django-heroku==0.3.1
  7. gunicorn==19.9.0
  8. Jinja2==2.10
  9. MarkupSafe==1.1.0
  10. Pillow==5.3.0
  11. psycopg2==2.7.6.1
  12. python-decouple==3.1
  13. pytz==2018.7

.ENV file

  1. SECRET_KEY='<SECRET_KEY>'
  2. DEBUG=True #set to false in production
  3. DB_NAME='tribune'
  4. DB_USER='user'
  5. DB_PASSWORD='password'
  6. DB_HOST='127.0.0.1'
  7. MODE='dev' #set to 'prod' in production
  8. ALLOWED_HOSTS='.localhost', '.herokuapp.com', '.127.0.0.1'
  9. DISABLE_COLLECTSTATIC=1

Installation

  1. To access this application on your command line, you need to clone it git clone https://github.com/marvinChomba/marvos-gram.git
  2. Create a requirements.txt in the root folder and copy the requirements above.
  3. Install the required technologies with pip install -r requirements.txt
  4. Create a .env file and copy the .env code above
  5. You can then run the server with: python3.6 manage.py runserver
  6. You can make changes to the db with python3.6 manage.py makemigrations photos python3.6 manage.py migrate
  7. You can run tests: python3.6 manage.py test photos

Django Admin

Username: marvin_chomba Password:<see_me>

Known Bugs ❌

Currently, there are no known bugs

Live link

You can view the live site here

Licence

This project is under the MIT licence

Copyright (c) 2018 marvinchomba