We welcome you and thank you for taking the time to do this coding assessment. Please read the guidelines before getting started.
- The purpose of this assessment is to help us evaluate your client side application development coding skills.
- We use Semantic UI React in our projects. The skeleton project that you will be working from has this library already included. We don't care what frontend library you use.
- You are allowed to use any non-human resource. Ex:
- Allowed: StackOverflow, Google, Old Code, Etc...
- Not Allowed: Speaking with anyone that has coding knowledge or is in the Technology field.
- You must use the skeleton project and existing UI as the start for your code
- Check out the API index at http://localhost:3001/rails/info.
- Don't be overwhelmed, supposed to be more steps than you are likely to complete in your given time frame. Try to do them in order, but you can skip steps if you get stuck. If you skip a feature, put in the notes as to why you skipped it.
- Put the time that you start and end on the first line of notes.md. Also, add any grading advice, disclaimers, brags, feedback, or anomalies you encounter along your way.
- Please try to commit often and add messages to your commits so we can more easily review your work.
- We added more steps than we expect you to finish. Don't be overwhelmed and get as far as you can in the time you have. We will take into account the time amount of time you took, the amount of experience you have in ReactJS, etc.
- The Webpack server and API server for the project can be run via
bundle exec foreman start
. - IMPORTANT: You will need to create a .env file in the root directory of the project. The easiest way to do this is to run this command in your terminal:
cp .env.example .env
- IMPORTANT: You will need to obtain an API key for the BreweryDB API from us at DevPoint Labs. Please reach out to us and let us know when you are ready to start the project.
- HINT: Postman is an awesome tool to start making API Requests with to see what data comes back and how you'll want to manage that data in your React Components.
/api/all_beers
- Returns the first 50 Beers from the BreweryDB API/api/beer/:name
- Returns info about the Beer if found by name/api/beer/random
- Returns info about a random Beer
/api/all_breweries
- Returns the first 50 Breweries from the BreweryDB API/api/brewery/:name
- Returns info about the Brewery if found by name
/api/search_all?query=''
- Returns all info from the BreweryDB API matching search query/api/search_beers?query=''
- Returns all info about Beers from the BreweryDB API matching search query/api/search_breweries?query=''
- Returns all info about Breweries from the BreweryDB API matching search query
/api/all_glassware
- Returns all Glassware in the BreweryDB API
/api/all_locations
- Returns the first 50 Locations from the BreweryDB API/api/locations/:city
- Returns the first 50 Locations in the matched city from the BreweryDB API
- Fork this repo so you have a clone of the project in your own github
- Create a new Beers Component -
client/src/components
- Add a new client side route -
/beers
that renders our new Beers Component. Our routes are defined inclient/src/components/App.js
. - Use
axios
,fetch
or any other HTTP Request library to GET the first 50 Beers from/api/all_beers
. The way you choose to display / style this is up to you. - Use
axios
,fetch
or any other HTTP Request library to GET the first 50 Breweries from/api/all_breweries
. The way you choose to display / style this is up to you. You can create a new route and have it on a different page or you could use your Beers Component and a Grid system to show all beers and breweries side by side. - Make sure to use enough attributes to make the site interesting. Most Beers and Breweries have an image or multiple images.
- Paginate the list of Beers and Breweries, loading no more than 10 at a time. Do server-side pagination (NOT client-side): Will Paginate Gem. This is already setup on the server all you have to do is make sure your client side API requests are passing the correct query strings for the rails server to do the pagination
- HINT: you can pass pagination details in the query string. If you pass the
page
andper_page
query string parameters the server will paginate results for you. EXAMPLE:api/all_beers?page=20&per_page=5
- HINT: you can pass pagination details in the query string. If you pass the
- Have the ability to go to other pages via pagination links or Infinite Scroll
- Example Libraries
- Have the ability to click on a Beer / Brewery and show all the information about it. You will use an API Endpoint for this. The way you choose to display / style this is up to you.
- Use any / all of the other API Endpoints to demonstrate your knowledge of React / Redux
- Style the project using: Styles in your components, a Stylesheet, or using the Styled Components Library Styled Components
- Implement live search on all of your components that show lists of items like Beers, Breweries, Etc
- Make your entire site responsive so it looks good on: a large screen, a tablet, and a phone
- React Native App