Skip to content

emmakamau/PhotoBooth

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 

Repository files navigation

Photobooth

A photo booth that users can view photos and search as well by category.

Technology used

  1. Python
  2. Django
  3. HTML
  4. CSS3
  5. PostgresSQL

Requirements

An IDE such as VS code with Python version 3 installed,a terminal and a browser.

Setup and Instruction

  1. Clone the repository at here.
  2. Extract and open the folder on VS code or navigate to the folder on your terminal.
  3. On the terminal, create a virtual environment python3 -m venv virtual and activate it source virtual/bin/activate. NB virtual is the name of the environment.
  4. Pip install dependancies highlighted on the requirements.txt by running pip install -r requirements.txt
  5. Create a start.sh file in the root directory of the folder and define the secret key.
  6. Run chmod +x start.sh and ./start.sh respectively on the terminal.
  7. View the application on your browser through http://127.0.0.1:5000.

Behaviour Driven Development

BDD focuses on how the user will interact with the application. What you will see and experience:

  1. Landing page with Navbar.
  2. Click on Gallery to view all image uploads.
  3. Select category on the drop down category box and filter by category.
  4. Hover over the image to enlarge it.
  5. Click on the image to view more information on a modal grid style.

Development

To fix a bug or enhance an existing module, follow these steps:

  • Fork the repo
  • Create a new branch (git checkout -b improve-feature)
  • Make the appropriate changes in the files
  • Add changes to reflect the changes made
  • Commit your changes (git commit -am 'Improve feature')
  • Push to the branch (git push origin improve-feature)
  • Create a Pull Request

If you find a bug or would like to request a new function, reach out to me via Email: emmaculatewkamau@gmail.com or on LinkedIn

License

MIT

Copyright (c) 2022 Emmaculate Kamau

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.