Willbeckh / iglive

Photo sharing app

Photol

A simple Instagram clone built with love and Django.

Prerequisites

To install this project in your machine, Install the following packages:

• Python3
• Virtualenv
• PostgreSQL
• VsCode

Technology

• Python3
• Django 4.0
• Bootsrap 4
• Javascript
• HTML
• CSS

Tooling

1. Virtualenv
2. PostgreSQL
3. Heroku
4. VsCode

Installing

Create a virtual environment and install the required packages.

# Create a virtual environment
python3 - m venv venv
# activate env
source venv/bin/activate
# install packages
pip install - r requirements.txt

Inside the project directory, create a dotenv file.

touch .env

Add the follwing credentials to the .env file:

DB_USER = <username >
DB_PASSWORD = <password >
DB_HOST = <host >
DB_PORT = <port >
DB_NAME = <dbname >
SECRET_KEY = <secret_key >
MODE = 'dev'

CLOUDINARY_CLOUD_NAME = <cloud_name >
CLOUDINARY_API_KEY = <api_key >
CLOUDINARY_API_SECRET = <api_secret >

Running

To run the application, run the following command:

python3 manage.py runserver

Database

First, create a database of your choice and save the credentials in .env.:

to Get the database up and running run:

python3 manage.py migrate

Testing

This application is created followint the TDD model for database models and their methods respectibvely. To run the tests use:

python3 manage.py test

Deploying

To deploy the application to Heroku follow this guide: Heroku deploy

Aslo click here to see a version of this project deployed to Heroku: Photol

Contributing

Feel free to fork and tweak as you like:) or you can also open an issue or PR: here

Known Issues

At the moment of completion and deploy, no bigs have been found yet, but if you find any you know what it is, it's a feature : )

Author

Created with ❤️ by Willbeckh.

Credits

Me, and StackOverflow.

License

This project is licensed under theMIT license.