Giter VIP home page Giter VIP logo

milestone-45's Introduction

CODE INSTITUTE: MILESTONE PROJECT 1

ENGLISH WINE: A REFERENCE GUIDE

site display on different screens

This website was designed to give the user a "one stop reference guide" for the wine industry in England. Brief information about the various counties that produce wine, the current producers in the market and the wines available from these producers.

This is the first of four Milestone Projects required for the Full Stack Web Development course provided by Code Institute. The main goal for this project was to produce a "static front-end site to present useful information to the users" using HTML and CSS.

CONTENTS

UX

PROJECT GOALS

The main aim of this project was to create a website that would give the user a single site to visit that would allow them to access other sites to gain more information, eg Wikipedia and contact details of current wine producers.

USER STORIES

  • As a new user / customer, I want to learn more about the regions in England that produce wine.
  • As a new user / customer, I want to learn more about the various producers in England and get in touch with them to arrange winery visits.
  • As a new user / customer, I want to learn more about the wines currently being produced in England and buy them direct from the producer cutting out the "middle man".
  • As a producer, I want to have contact details for my peers in an easy to use website.
  • As a producer, I want to see what new wine is being launched on to the market by my peers.
  • As a wine supplier, I want to be able to contact producers direct and get that information easily.
  • As a wine supplier, I want to be able to see what new wine is being launce on to the market by existing producers.

Back to Contents

DESIGN PROCESS

  1. The initial concept for the project came from my interest, and desire to champion, the growing English Wine market. I wanted to have a simple website, that could be used by various user groups of any knowledge level, to give them access to information that would increase their awareness of the English wine market. This resulted in the decision to have a landing page, an about page (basic introduction to English wines), a regions page, a producers page and a wines page (although this started off as a varietals page).

  2. I chose to have a black and white image as the page background as I felt it had a strong impact on the user and with a simple title and "Find Out More" button in the middle of the screen it would make the user enter the website. This was carried on throughout the rest of the website but then removed as it was detracting from the information being provided on the cards. The "Racing Green" (#007542) colour was chosen to frame the body section of the pages as it is a striking colour and "fits" the subject matter well (in my opinion).

  3. I used Balsamiq to create my wireframes and used it to organise the flow of the site and how the different pages would respond to different screen sizes.

  4. The website design did change as I coded as I realised I was "learning on the job". I used the Bootstrap card component, which I didn't know existed before I started coding, instead of seperate images and text elements on the latter pages of the site. These were easy to use but were also challenging as they did not behave, initially, in the way I thought they should have done.

  5. I feel that I have fulfilled the brief for the project but am aware that I strayed from the original design. I referred to my User Stories and wireframes throughout the process and all changes made were to improve the initial design choices that were made.

Back to Contents

FONTS

I chose the Mulish font family for my headers and the Poppins font family for my body text as I liked the simplicity of their styles. Both fonts were chosen from Google Fonts.

COLOURS

I used a "Racing Green" (#007542) colour for the Navigation Bar and Footer and then used www.0to255.com to pick complimentary colours to work with for the buttons and cards throughout the project. The black and white image for index.html was used as I felt it gave the site a professional feel.

WIREFRAMES

The site mock-ups were designed using Balsamiq wireframes. A pdf of the wireframe can be found here. I concentrated on how the different pages would look on different screen resolutions and mapped the corresponding elements on desktop, tablet and mobile screens accordingly. The varietals page changed during the coding process to become wines as I felt that this was more relevant to the various users.

Landing Page

Landing Page

About Page

About Page

Regions Page

Regions Page

Producers Page

Producers Page

Varietals Page

Varietals Page

Sign Up Form

Sign Up Form

Back to Contents


TECHNOLOGY USED

LANGUAGES AND FRAMEWORKS

  • HTML
  • CSS
  • JavaScript - this was used for the modal form and also for the "scroll up" button to allow the user to return to the top of the screen. The JS code for this was borrowed from the W3 Schools website after a search to find out how to create this.
  • jQuery
  • Font-Awesome - all icons were taken from this site.
  • Bootstrap - I relied on Bootstrap for the responsive grid design, carousel and card components.
  • Google fonts - as previously stated, the fonts used were taken from here.
  • Popper
  • Popper JS

TOOLS

  • Git - version control and recording of all changes to site during development process
  • GitHub - used for hosting website
  • GitPod - IDE used for code editing.
  • Balsamiq - wireframing
  • Google Fonts - used to select font families
  • W3C Validator - used to test my HTML to ensure there were no errors
  • W3C Validator CSS - used to test my CSS to ensure there were no errors
  • WAVE - used to test accesibility of site
  • 0to255.com - colour picker
  • Free Formatter - html formatter to help keep things tidy!
  • Am I Responsive - used to create responsive image for readme.MD
  • Favicomatic - used to generate the Favicon on the webpage tab

Back to Contents


FEATURES

FEATURES IMPLEMENTED

  • Static NavBar across all pages so that the user can navigate the site easily.
  • Links to external websites so that the user can get more information on the particular item they are interested in - region, producer or wine.
  • Social media links to the site owners pages.
  • Embeded video on About page giving information on the process of wine making in England.
  • Carousel images on About page showing "hero" style images.
  • Bootstrap cards which will allow future search functionality.
  • Button at bottom of screen to allow user to return to the top of the page without scrolling.
  • Favicon used in title of web page.
  • Hover used on all buttons and web/email address links.
  • Modal form used for sign up along with ability to leave the form if the user doesn't wish to submit at that particular moment in time.

FUTURE FEATURES

  • Increase the content of the Regions page as there are more regions in England that produce wine. This would require an A to Z "search" function to be added to allow quick navigation to that particular information card.
  • Increase the content of the Producers page as there are more regions in England that produce wine. This would require an A to Z "search" function to be added to allow quick navigation to that particular information card.
  • Increase the content of the Wines page as there are more regions in England that produce wine. This would require an A to Z "search" function to be added to allow quick navigation to that particular information card.
  • The addition of a search bar in the NavBar to allow instant site navigation for the user.

Back to Contents


TESTING

RESPONSIVENESS

The sites responsiveness was tested by the following methods:

  • Chrome Developer Tools were used to test responsiveness on all screen sizes.
  • Physical testing was carried out on Desktop, Tablet and various Mobile devices.
    • Throughout the whole process I was testing the responsiveness of the site on my laptop, iPhone X and iPad.
    • Once the site was in a state that I was happy with, I submitted it for Peer review.
    • I also asked friends and family to have a look at the site from a user perspective, rather than a coder perspective.
  • All links were tested to ensure they worked on all devices.
  • NavBar was tested to ensure it worked on all devices.
  • Modal Form was tested to ensure that all fields required input from the user.

BROWSER COMPATIBILITY

The site was tested on the following browsers that I have access to:

  • Google Chrome
  • Mozilla Firefox
  • Microsoft Edge

CODE VALIDATION

All HTML and CSS was passed through W3C Validator and W3C Validator CSS.

ACCESIBILITY VALIDATION

The site was tested on the WAVE site. Passed with minimal errors although Contrast errors were generated due to colour choices. This will be something I look at for future projects.

ISSUES EXPERIENCED

There were several issues observed during development and testing:

  • The initial images selected for the information cards on the Producers and Wines pages were of different sizes and some were had backgrounds and some didn't. As this was my first project I sourced new images for the Producers page and used stock images for the Wines page. This was not the intended outcome but allowed for consistency across the affected pages.
  • Cards would reshape on the Wines page due to too much text. This meant the responsiveness of the page was inconsistent on different device types. Reduced content to allow for consistency as I felt that the links to the various sites would give the user the informtation they required.
  • The addition of a "Back to Top" button has caused problems with the accesibility of the page which I tested on the WAVE website. As this was a function added using a JS code snippet from W3 Schools, I am unable to fix it at present.

Back to Contents


DEPLOYMENT

HOSTING

The site is hosted on GitHub Pages.

Deployment of the site was achieved by following the steps below:

  • opening GitHub in my Google Chrome (or any browser)
  • signing in to GitHub using my username and password
  • selected my repositories
  • navigating to the repo to be deployed (iainm342/milestone-1)
  • clicking on settings in the top navigation bar
  • scrolling down the page until you reach GitHub pages
  • selecting Branch:Master
  • selecting Root
  • clicking on Save
  • URL generated for use
  • site is now live on GitHub Pages

CLONING

If you wish to use my project, feel free, you can clone a copy to your machine by doing the following:

  • open GitHub
  • navigate to the repo (iainm342/milestone-1)
  • click the green Code dropdown button
  • select the option to open with GitHub
  • follow the onscreen instructions and open with GitHub or another IDE

Back to Contents


CREDITS

IMAGES AND TEXT CONTENT

The images and card, text content used were sourced from various sites:

IMAGE EDITING

  • I used the Shutterstock editing tool for the vector image used for the logo and Adobe Photoshop to transform the index.html background image to black and white.

CODING IDEAS

Knowledge, and inspiration, was taken from the Code Institute projects - Whiskey Drop and Resume - for certain aspects of the site as this was the first time I have written any major piece of code.

W3 Schools for the JS code to install a "Back to Top" button which was then styled with an icon from Font Awesome.

Back to Contents


ACKNOWLEDGEMENTS

Thank you to the following people:

  • My mentor Seun Owonikoko for her time, guidance and putting up with my "wobble" on our first mentor call...
  • The guys in the class of May 20 on Slack - always there for a chat when needed!
  • My partner, Paul, for putting up with the growing obsession I have towards coding.

Back to Contents


milestone-45's People

Contributors

iainm342 avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.