{"id":24648202,"url":"https://github.com/alissatroiano/team-4-hackathon","last_synced_at":"2025-05-13T01:20:44.741Z","repository":{"id":45425139,"uuid":"436352426","full_name":"alissatroiano/team-4-hackathon","owner":"alissatroiano","description":"Team 4's Repository for the December 2021 Code Institute Hackathon","archived":false,"fork":false,"pushed_at":"2021-12-14T17:48:27.000Z","size":29986,"stargazers_count":2,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-01T05:34:14.919Z","etag":null,"topics":["backend","django","frontend","hackathon","python"],"latest_commit_sha":null,"homepage":"https://covidxmas.herokuapp.com/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alissatroiano.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-08T18:30:25.000Z","updated_at":"2022-08-15T08:04:35.000Z","dependencies_parsed_at":"2022-09-10T11:42:28.908Z","dependency_job_id":null,"html_url":"https://github.com/alissatroiano/team-4-hackathon","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alissatroiano%2Fteam-4-hackathon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alissatroiano%2Fteam-4-hackathon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alissatroiano%2Fteam-4-hackathon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alissatroiano%2Fteam-4-hackathon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alissatroiano","download_url":"https://codeload.github.com/alissatroiano/team-4-hackathon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253851554,"owners_count":21973760,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend","django","frontend","hackathon","python"],"created_at":"2025-01-25T16:14:32.479Z","updated_at":"2025-05-13T01:20:44.719Z","avatar_url":"https://github.com/alissatroiano.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Contents\n[CovidXmas Calendar](#covidxmas-calendar)\n\n[UX](#ux)\n+ [User Stories](#user-stories)\n+ [Wireframes](#wireframes)\n\n[Features](#features)\n+ [Navbar](#navbar)\n+ [Home Page](#home-page) \n+ [Login In Page](#login-page)\n+ [Login Out Page](#logout-page)\n\n[Technologies Used](#technologies-used)\n+ [Languages Used](#languages-used)\n+ [Frameworks, Libraries \u0026 Programs Used](#frameworks-libraries-and-programs-used)\n\n[Deployment](#deployment)\n\n[Credits](#credits)\n+ [Content](#content)\n+ [Media](#media)\n\n# CovidXmas Calendar\n+ We offer a personalized advent calendar with the theme of Happy Holidays with coXmas touch! This was built by team THE CALENDERERS for the Code Institute December 2021 Hackathon.\nIt was built to reflect the merry season spirit to our app users, with a simple but effective design that consists of animated combination on each day of December, \nspecifically picked to inspire and uplift the user after COVID-19, global restrictions and two years of hardship.\n\n\u003cimg src=\"#\"\u003e \n\n\nClick [here](https://covidxmas.herokuapp.com/) to live site.  \n\n## UX\n\n### User Stories\n\n+ As a user, I would like to be able to …\n1. Register my own account, login and logout;\n2. Create, edit, share or delete multiple customized Advent Calendars;\n3. Each day of the calendar has an option to either enter an image, youtube video or a text quote;\n4. Listen to songs from the playlist or upload your own. Playlist can be accessed from the navbar option named \"Play Music\".\n\n+ As a site owner, I want …\n1. The website to be easy to navigate;\n2. The functions to be easy accessible;\n3. User to experience the festive season through interacting with app.\n\n\n### Wireframes \n\nWireframes created with Figma and Balsamiq. The project was developed from initial wireframes and some modifications were made during the development process to assure better usability. \n\n[Wireframes](https://github.com/alissatroiano/team-4-hackathon/tree/master/assets/wireframes)\n\n\n## Features \n\n\n### Navbar \n\n+ Fixed Navbar with Home, Public Calendars, Login In and Log Out buttons to simplify accessibility to all pages;\n+ Collapsed navbar on smaller devices to wrap in all options to ensure smoooth adjustment of menu being displayed.\n\n\n### Home page \n\n+ animated gif of santa claus reindeer climbing across the page to catch the user's attention;\n+ navigation bar on top of the page.\n\n### Public Calendars\n\n+ In this page, user can view calendars which are publicly available.\n\n### My Calendars\n\n+ This page is accessible once user has logged in;\n+ \n\n### Log In page \n\n+ This page is dedicated for handling the user authentication;\n+ Username and password box:\n The user is required to input their registered username and password.\n+ Remember Me:\n ‘Remember Me’ feature checkbox will allow the user to preserve their logged in status. When the user checks the Remember Me option, then the logged in status is stored in the browser cookies.\n+ Forgotten my password:\nIf user forgotten the password - user may click link named \"I've forgotten my password\". Once clicked - user will be redirected to the Reset Password page to input their email address so  the system will send you an e-mail allowing you to reset password.\n\n+ Don't have an account?:\nIf user does not have an account - user may click the link named \"Don't have an account? Sign Up\". Once clicked - user will be redirected to the signup page.\n\n### Sign Up Page\n\n+ This page is dedicated for handling the registration of a new user;\n+ The user is required to input their desired username;\n+ The user has the option to input their email address;\n+ The user is required to input their password twice;\n\n\n### Log Out Page \n\n+ This page is dedicated for handling user log out;\n+ It is accessible upon user login.\n+ Once \"Log out\" is clicked from the navbar; user will be prompted if they want to sign out. Once user confirm - system will sign out the user and return to the homepage.\n\n## Technologies Used\n\n### Languages Used\n\n   + HTML5\n   + CSS3\n   + JavaScript\n   + Python3/Django\n   + SVG\n   + JSON\n\n ### Frameworks Libraries and Programs Used\n\n+ Balsamiq:\n  Balsamiq was used to produce the wireframes throughout the design process.\n\n+ Figma:\n  Figma was used to produce the wireframes throughout the design process.\n\n+ Bootstrap 5:\n    Bootstrap was used to add style to the website.\n+ Git\n    Git was utilised for version control by operating the Gitpod terminal to commit to Git and Push to GitHub.\n+ GitHub:\n    GitHub is used to lay in the project's code upon being pushed from Git.\n\n\n## Bugs \n\nNo bugs were found.\n\n\n## Deployment\n\n The site was deployed to GitHub pages. \n \n * The steps to deploy are as follows: \n\n  - In the GitHub repository, navigate to the Settings tab; \n  - From the source section drop-down menu, select the Master Branch;\n  - Once the mas  ter branch has been selected, the page will be automatically refreshed with a detailed ribbon display to indicate the successful deployment. \n\nThe live link can be found [here](https://github.com/alissatroiano/team-4-hackathon/).\n\n+ Heroku Deployment\n\n + Prerequisites;\n●\tA Github repository\n●\tYour creds.json file open in Gitpod.\n●\tEnsuring your requirements.txt is up to date. You can do so using by entering the following line in your terminal:\npip3 freeze --local \u003e requirements.txt\n\n  + Step 1 - Creating an account;\n\n●\tIf you already have a Heroku account, please sign in to your existing account.\n●\tIf you don't, go to Heroku.com and create a free account.\n\n  + Step 2: Create an app;\n\n●\tClick on the 'New' drop down in the upper right-hand corner.\n●\tSelect 'Create a new app'.\n●\tWhen choosing an app name, it will need to be unique to Heroku.\n●\tIf the Github repository name or project name is not available, choose a name similar by adding other words, dashes, letters or numbers.\n●\tEnter your chosen 'App name' and select your region.\n●\tClick the 'Create app' button.\n\n + Step 3: Add Config Vars;\n\n●\tGo to the 'Settings' tab in your app.\n●\tScroll down to the 'Config Vars' section and click the 'Reveal Config Vars' button.\n●\tWe are going to add two config vars.\n●\tFrom the creds.json file, copy the entire contents.\n●\tEnter CREDS for KEY and then paste the contents from creds.json into the VALUE field.\n●\tThen click the 'Add' button.\n●\tEnter PORT for KEY and then 8000 for VALUE and click the 'Add' button.\n\n+ Step 4: Add Buildpacks;\n\n●\tOn the same 'Settings' tab in your app, scroll down to the 'Buildpacks' section.\n●\tThe buildpacks need to be listed in your Settings in a specific order.\n●\tIt's best to add Python first, click 'Save Changes and repeat for then Node.js.\n●\tIf the buildpacks don't appear with Python first and Node.js second, you change the order by dragging Python to the top.\n\n+ Step 5 - Select Github Deployment Method;\n\n●\tGo to the 'Deploy' tab in your app.\n●\tIn the Deployment method' section, select 'GitHub' and click 'Connect to GitHub'.\n●\tSearch for your Github repository name, which will create a list of repository names.\n●\tClick the 'Connect' button, and your Heroku app will link to your Github repository.\n●\tYou can choose manual deploys for your app; click 'Deploy Branch' in the 'Manual Deploy' section.\n●\tOnce successfully deployed, a green tick will appear next to Deploy to Heroku\n●\tYour app will not update/rebuild each time you push to Github, which will conserve your dyno hours in Heroku.\n●\tYou will need to click 'Deploy Branch' each time you want the app to rebuild after pushing your changes to Github.\n●\tOr you can choose automatic deploys for your app,\n●\tYour app will update/rebuild each time you push to Github, which will not conserve your dyno hours in Heroku\n●\tTo access your deployed app, scroll to the top and click 'Open app'.\n\n\n## Forking the GitHub Repository\n\nBy forking the GitHub Repository you will be able to make a copy of the original repository on your own GitHub account allowing you to view and/or make changes without affecting the original repository by using the following steps:\n\n1. Log in to GitHub and locate the [GitHub Repository](https://github.com/alissatroiano/team-4-hackathon/)\n2. At the top of the Repository (not top of page) just above the \"Settings\" button on the menu, locate the \"Fork\" button.\n3. You should now have a copy of the original repository in your GitHub account.\n\n## Making a Local Clone\n\n1. Log in to GitHub and locate the [GitHub Repository](https://github.com/alissatroiano/team-4-hackathon/)\n2. Under the repository name, click \"Clone or download\".\n3. To clone the repository using HTTPS, under \"Clone with HTTPS\", copy the link.\n4. Open Git Bash\n5. Change the current working directory to the location where you want the cloned directory to be made.\n6. Type `git clone`, and then paste the URL you copied in Step 3.\n\n```\n$ git clone https://github.com/alissatroiano/team-4-hackathon/\n```\n\n7. Press Enter. Your local clone will be created.\n\n## Setup Project\n\n### Create a .py file\n1. Create a `env.py` file in the `covidxmas` folder. See example below.\n\n1. Create a `env.py` file in the `covidxmas` folder. See example of the file contents below.\n\n```\nimport os\n\nos.environ.setdefault('ALLOWED_HOST', '*')\n\n```\n\n2. If you have a virtual environment, then start it\n\n3. Install dependencies\n\n## Run Project\n\n### Execute\n\nFor Bash (Linux/Mac) execute the following line of code from the terminal:\n\n```\npip3 install -r requirements.txt\n\n```\n\nFor Windows execute the following line of code from Powershell\n\n```\npip install -r requirements.txt\n```\n\n4. Run migrations\n\nFor Bash (Linux/Mac) execute the following line of code from the terminal:\n\n```\npython3 covidxmas/manage.py migrate\n\n```\n\nFor Windows execute the following line of code from Powershell\n\n```\npython covidxmas/manage.py migrate\n```\n\n5. Run project\n\nFor Bash (Linux/Mac) execute the following line of code from the terminal:\n\n```\n./run.sh\n\n# or \n\npython3 covidxmas/manage.py runserver 0.0.0.0:8000\n\n```\n\nFor Windows execute the following line of code from Powershell\n\n```\npython covidxmas/manage.py runserver 0.0.0.0:8000\n```\n\n\n## Credits \n \n### Content\n\nQuotes (both Christmas-themed and non-Christmas themed) for the advent calendar boxes used in combination with on-theme gifs from [Giphy](https://giphy.com/)\n\n### Media\n\nImages from [Vecteezy](https://www.vecteezy.com)\n\n\n\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falissatroiano%2Fteam-4-hackathon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falissatroiano%2Fteam-4-hackathon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falissatroiano%2Fteam-4-hackathon/lists"}