zuri-training / Team-64_Favicon-Gen

This project by Team 64 is aimed at building a web application for favicon generation.
0 stars 4 forks source link

Welcome to ZuriconGen

Project Overview

This project is being developed by Team 64 of Zuri Training Organization and is aimed at building a web application for favicon generation.

The main feature is the Favicon Converter which will allow users to upload an image and have it converted to a favicon. The web app also has two other favicon generating features: Favicon Generator and Texticons.

App and team details

App Name : ZuriconGen

Customer : Zuri Training Organization

Development Team :

Information given: Name, GitHub username, and period of collaboration.

  1. Serah Onyinyechi Nwoke (SerahN) [Fullstack developer : July 2022 - August 2022]
  2. Great Okafor (Thelordgreat) [Fullstack developer : July 2022 - August 2022]
  3. (jolomi212) [Fullstack developer : July 2022 - August 2022]
  4. Eke Christina (Crixxee) [Fullstack developer : July 2022 - August 2022]
  5. Arinze Blessing (blessingarizona) [Fullstack developer : July 2022 - August 2022]
  6. Akpe Peace (akpe01) [Fullstack developer : July 2022 - August 2022]
  7. Hermann Wakam (Wakherv7) [Fullstack developer : July 2022 - August 2022]
  8. Adebayo Ganiu (Blaze-snr) [Fullstack developer : July 2022 - August 2022]
  9. Awoyemi Michael (ChrisMike10) [Fullstack developer : July 2022 - August 2022]

Design Team :

  1. David Adebola Adetoro (Bola001) [Product Designer : July 2022 - August 2022]
  2. Fisayo Ogunle (Trippyog44) [Product Designer : July 2022 - August 2022]
  3. Olamide Alamutu (midealamutu) [Product Designer : July 2022 - August 2022]
  4. Matthew Anyebe (mamoblack) [Product Designer : July 2022 - August 2022]
  5. Temilade Mogaji (softlife12) [Product Designer : July 2022 - August 2022]
  6. Amaka Offor (AmakaSilas) [Product Designer : July 2022 - August 2022]
  7. Vanessa Anya (vanessa27-tech) [Product Designer : July 2022 - August 2022]
  8. Oke Prosper (Prospernias) [Product Designer : July 2022 - August 2022]
  9. Bamidele Aminat Olanike (Bamidele-Aminat) [Product Designer : July 2022 - August 2022]
  10. Bukunmu Sonibare (Designbybecca) [Product Designer : July 2022 - August 2022]
  11. Rere Alonge (Rerealonge) [Product Designer : July 2022 - August 2022]
  12. Odogwu Dominion (Kobimdi) [Product Designer : July 2022 - August 2022]
  13. Maureen Ngozi Chukwurah (Guzi-goz) [Product Designer : July 2022 - August 2022]
  14. Udoka Ineh (Udokaineh) [Product Designer : July 2022 - August 2022]

Web URL : http://zuricongen.pythonanywhere.com/

About this documentation file

This file is designed to provide overview, setup instructions and background details of this project.

Members of the development team are assigned to ensure that this file is always up-to-date, and can be followed through conveniently.

Note : Developers must include new dependencies in the requirements.txt file and ensure they are updated in the main branch.

Technologies employed in this project

  1. Client-Side Scripting / Coding

    HTML (HyperText Markup Language)

    CSS (Cascading Style Sheets)

    JavaScript

  2. Server-Side Scripting / Coding

    Django with Python

Set-Up Instructions

As mentioned earlier , this is a Django project.

Please, take note of the operating system you are using as the steps may vary.

This set-up instructions aims at helping a developer get the code from the git repository to run on their system, for possibly further development.

Fetch git code to local machine

Follow these steps to fetch the git code to your system:

Clone this project's repository. To do this, open your code editor and choose "Clone Git Repository", then click on "Clone from GitHub", and enter https://github.com/zuri-training/Team-64_Favicon-Gen.git

As at the time of writing this set-up instructions, the branch used for development is : main

Activate a virtual environment and install the project dependencies

The project dependencies are contained in the requirements.txt file in the main branch.

Run these commands in your command line:

pip
pip install virtualenv
virtualenv envname
envname\scripts\activate
pip install -r requirements.txt

Move into the project directory

The project directory is titled 'website', so run this in your command line:

cd website

The collaborators' worked following this guide: https://github.com/zuri-training/Team-64_Favicon-Gen/blob/main/Collaborators'-Guide.md

Build information

This project runs on Python 3.8.13 as found in the runtime.txt file here: https://github.com/zuri-training/Team-64_Favicon-Gen/blob/main/runtime.txt

Deployment

This web application, ZuriconGen, is deployed on the pythonanywhere.com server. The login credentials can be obtained from the team lead, SerahN. She can be contacted via seraho.nwoke@gmail.com

Note for future maintainers/ developers

Hello future dev, comments are made throughout the codes for easy understanding. Study these well and follow the set-up instructions.

References

The (User Experience Design) Research documentation can be found here: https://docs.google.com/document/d/1lJeFEHFBVzyME7ht9RB-mifZzaeGIxM-HAnsudWQUds/edit?usp=sharing

Design research elements like participant note, pain points, empathy map, user flow, information architecture and idea prioritization can be found here: https://www.figma.com/file/2P8rcupisqFHMPfaX5TeDl/Team-64_Favicon_gen?node-id=95%3A713

The wireframes and designs for this project can be found on the team's figma board here: https://www.figma.com/file/Q6kNdChpgQzLfjIKwSl2Ok/Team-64_Favicon_gen?node-id=50%3A2

The database schema for this project can be found here: https://drive.google.com/file/d/1HiMyBAbYz_H4sFE8chP49i1qXhE_sC2g/view?usp=sharing

The workflow documentation for this project can be found here: https://drive.google.com/file/d/1ewR4YWZk7R6iItfuXfh_NQAaed1TBK31/view?usp=sharing