This is a personal gallery built with Django Python Framework and PostgreSQL database where a user can upload images and other info such as location, description. The images are also categorised to allow searching of images based on a certain category.
- Type the following command in your terminal to clone this repository
git clone https://github.com/Edu58/Django-Gallery.git
If you are using SSH, use the following command
git clone git@github.com:Edu58/Django-Gallery.git
When you run the commands successfully, you should have a local version of this repository.
- A computer with Python 3 install. Check here for further instructions
- Access to the Internet
- An IDE of your choice e.g. Pycharm, VS Code, Sublime Text
Before starting the application, run pip install -r requirements.txt to install the project dependencies.
To run the app, unzip the cloned folder if it is zipped. Otherwise, navigate inside the folder and
run python manage.py runserver or python manage.py server in your terminal. Any of these 2 should start the
server at
localhost:8000. Once the server is running, open your browser and enter localhost:8000 in your url bar of your
preferred browser, and you should be able to use the app now. This will only work on the computer running the server. It
is not available to anyone else. You should see something similar to the image below on clicking a single image.
To run tests, open your terminal and navigate to the root directory of the project.
Run python manage.py test in your terminal. If all tests run successfully,
you will an OK message in the terminal and the number of tests that have been run.
This project can be deployed for free on Heroku. Follow these instructions to deploy.
- Django - The web framework used
- Django-Bootstrap-V5 - CSS Framework
- JQuery - Javascript Library used for fade effects
- PostgreSQL - Database used
Feel free to submit a pull request or reach out at edumuriithi58@gmail.com.
- Edwin Karimi - Initial work - Django-Gallery
- Twitter - @GISDevEd
- Linkedin - edwin-karimi
- No contributors yet
This project is licensed under the MIT License - see the LICENSE.md file for details