mvp

README.md

@@ -2,89 +2,90 @@
 
 **Read these instructions carefully. Understand exactly what is expected _before_ starting this Sprint Challenge.**
 
-This challenge allows you to practice the concepts and techniques learned over the past sprint and apply them in a concrete project. This sprint explored **advanced web applications**. During this sprint, you studied **React testing, client-side auth, HTTP methods, and Vercel**. 
+This challenge allows you to practice the concepts and techniques learned over the past sprint and apply them in a concrete project. This sprint explored **advanced web applications**. During this sprint, you studied **React testing, client-side auth, HTTP methods, and Vercel**.
 
 In your challenge this week, you will demonstrate your mastery of these skills by creating **a login page** and **basic CRUD application.**
 
-This is an individual assessment. All work must be your own. Your challenge score is a measure of your ability to work independently using the material covered through this sprint. You need to demonstrate proficiency in the concepts and objectives introduced and practiced in preceding days.
-
-You are not allowed to collaborate during the sprint challenge. However, you are encouraged to follow the twenty-minute rule and seek support from your TL if you need direction. 
-
-_You have **three hours** to complete this challenge. Plan your time accordingly._
+This is an individual assessment. All work must be your own. All projects will be submitted to codegrade for automated review. You will also be given feedback by code reviewers the Monday after challenge submissions. For more information on the review process [click here.](https://www.notion.so/lambdaschool/How-to-View-Feedback-in-CodeGrade-c5147cee220c4044a25de28bcb6bb54a)
 
+You are not allowed to collaborate during the sprint challenge. However, you are encouraged to follow the twenty-minute rule and seek support by dropping a :wave: in your help channel when needed.
 
 ## Introduction
 
 In this project you will create a login page and request a token from the server that you'll use to send all other requests to the server. You will then be able to fetch the color data array, update data, and delete data, and watch the fun happen!
 
-**Note** You can use the sites like the following to get color hex codes:
-
-* [Color-Hex](https://www.color-hex.com/)
-
-### Commits
-
-Commit your code regularly and meaningfully. This helps both you (in case you ever need to return to old code for any number of reasons) and your team lead as the evaluate your solution.
-
 ## Instructions
 
-### Task 1: Project Set Up
-
-- [ ] Create a forked copy of this project
-- [ ] Clone your OWN version of the repository (Not Lambda's by mistake!)
-- [ ] Create a new branch: git checkout -b `<firstName-lastName>`.
-- [ ] Implement the project on your newly created `<firstName-lastName>` branch, committing changes regularly
-- [ ] Push commits: git push origin `<firstName-lastName>`
- - [ ] **LOOK** at the files in your root directory and notice it' is just a plain ol' React App that we've built using create-react-app.
- - [ ] **RUN** npm install install your dependences
- - [ ] **RUN** npm start to fire up your React application.
-
- **Setting up the CodeGrade webhook**
-Go [here](./CodeGrade-webhook.md) to setup the CodeGrade webhook before you begin.
-
-
+### Task 1: Transfer Repo
+* Clone this repository.
+* Implement the project on the automatically generated <firstName-lastName> branch, committing changes regularly.
+* Push commits: git push origin <firstName-lastName>.
+* RUN npm install to install your dependencies.
+* RUN npm start to start your application.
+
 ### Task 2: Project Requirements
-Your finished project must include all of the following requirements.
+Your finished project must include all of the following requirements. **Unlike other projects, the local server used here can not be accessed through the browser. It is started automatically and without the need for starting a server.js file. Feel free to ignore any messages related to MSW or mock service workers. For this and the rest of your sprint challenges, test the functioning of the server directly through your http calls.**
 
-#### Stage 1 - Authentication
-Build a login form to authenticate your users.
+**See reference materials at the bottom of the this document for details on use the API.**
 
-- [ ] Construct an AXIOS request to retrieve a token from the server. You'll use this token to interact with the API
-- [ ] Save the token to localStorage
-- [ ] Build a `axiosWithAuth` module to create an instance of axios with the authentication header
-- [ ] Build a `PrivateRoute` component and use it to protect a route that renders the `BubblesPage` component
+#### Authentication
+> *Build a login form to authenticate your users along with all the components and utilities needed to support authentication.*
 
-#### Stage 2 - Consuming the API
+* [ ] In `Login.js`, build all UI and state functionality needed to capture a username and password.
+* [ ] Add in two routes that display the login component, one for the default path '/' and one for the login path '/login'.
+* [ ] **Make sure that the input for your username and password includes the id="username" and id="password" attributes and an id="submit" on the login button. Codegrade autotests will fail without them.**
+* [ ] Build in functionality that would allow an error to be displayed in the provided p tag if either the username or password is incorrect.
+* [ ] **Make sure your error p tag has an id="error" attribute attached. Codegrade autotests will fail without them.**
+* [ ] Construct an http request that retrieves an auth token from the server when the username `Lambda` and the password `School` is passed into the request.
+* [ ] Save the token to localStorage.
+* [ ] Build a `axiosWithAuth` module within the helpers folder to create an instance of axios with the authentication header.
+* [ ] Build a `PrivateRoute` component within the components folder and use it to protect the route that renders the `BubblesPage` component.
+* [ ] In `App.js`, build the backend to the logout button. When pressed, send an http request to the logout endpoint and remove the authentication token from localStorage. Use window.location.href to redirect to the login page.
 
-- [ ] When `BubblePages` renders, make a GET request to fetch the color data for your bubbles.
-- [ ] In `ColorList.js`, complete the `saveEdit` and `deleteColor` functions to make AJAX requests to the API to edit/delete data
-- [ ] Watch and enjoy as your app responds to updates in the data. Check out `Bubbles.js` to see how this is built.
+#### Consuming the API
+> *Add in the http requests and state changes needed to connect our api to the web application. Consider the effect of authentication on your api requests.*
 
-#### API Documentation
+* [ ] In `services/fetchColorServices.js`, build out fetchColorService function to make a GET request to fetch the color data for your bubbles.
+* [ ] When `BubblePages` mounts, call fetchColorServices and save it's result in state.
+* [ ] In `BubblePage.js`, complete `saveEdit`, and `deleteColor` functions to make API requests for to editing and delete data.
+* [ ] Watch and enjoy as your app responds to updates in the data. Check out `Bubbles.js` to see how this is built.
 
-  * **[POST]** * to `http://localhost:5000/api/login`: returns a token to be added to the header of all other requests. Pass in the following credentials as the `body` of the request: `{ username: 'Lambda School', password: 'i<3Lambd4' }`
-  * **[GET]** to `http://localhost:5000/api/colors`: returns the list of colors and their hex codes.
-  * **[POST]** to `http://localhost:5000/api/colors`: creates a new color object. Pass the color as the `body` of the request (the second argument passed to `axios.post`).
-  * **[PUT]** to `http://localhost:5000/api/colors/:id`: updates the color using the `id` passed as part of the URL. Send the color object with the updated information as the `body` of the request (the second argument passed to `axios.put`).
-  * **[DELETE]** to `http://localhost:5000/api/colors/123`: removes the color using the `id` passed as part of the URL (123 in example).
+#### Testing
+* [ ] Finish the test in `Color.test.js`, `ColorList.test.js`, `BubblePage.test.js`. You will need to use rerendering, function mocking and spies in order to complete.
 
-#### Stage 3 Testing
-- [ ] Finish the test in `BubblePage.test.js` to test that your app is fetching the bubble data from the API
+**Notes:**
+* You are welcome to create additional files but **do not move or rename existing files** or folders.
+* Do not change your `package.json` file except to install additional libraries.
+* In your solution, it is essential that you follow best practices and produce clean and professional results.
+* Schedule time to review, refine, and assess your work and perform basic professional polishing including spell-checking and grammar-checking on your work.
+* It is better to submit a challenge that meets MVP than one that attempts too much and does not.
 
-In your solution, it is essential that you follow best practices and produce clean and professional results. You will be scored on your adherence to proper code style and good organization. Schedule time to review, refine, and assess your work and perform basic professional polishing including spell-checking and grammar-checking on your work. It is better to submit a challenge that meets MVP than one that attempts too much and does not.
+### Reference Materials
 
-### Task 3: Stretch Goals 
+#### API Documentation
+* **[POST]** * to `http://localhost:5000/api/login`: returns a token to be added to the header of all other requests. Pass in the following credentials as the `body` of the request: `{ username: 'Lambda', password: 'School' }`
+* **[POST]** * to `http://localhost:5000/api/logout`: returns a token to be added to the header of all other requests.
+* **[GET]** to `http://localhost:5000/api/colors`: returns the list of colors and their hex codes. This endpoint canYeah only be accessed by an autheticated user.
+* **[POST]** to `http://localhost:5000/api/colors`: creates a new color object. Pass the color as the `body` of the request (the second argument passed to `axios.post`). This endpoint can only be accessed by an autheticated user.
+* **[PUT]** to `http://localhost:5000/api/colors/:id`: updates the color using the `id` passed as part of the URL. Send the color object with the updated information as the `body` of the request (the second argument passed to `axios.put`). This endpoint can only be accessed by an authenticated user.
+* **[DELETE]** to `http://localhost:5000/api/colors/123`: removes the color using the `id` passed as part of the URL (123 in example). This endpoint can only be accessed by an autheticated user.
+
+#### Hex Color Examples
+**Note** You can use the sites like the following to get color hex codes:
+* [Color-Hex](https://www.color-hex.com/)
 
-After finishing your required elements, you can push your work further. These goals may or may not be things you have learned in this module but they build on the material you just studied. Time allowing, stretch your limits and see if you can deliver on the following optional goals:
+## Submission format
 
-* [ ] Build out another form to add a new color to your color list
-* [ ] Build a custom hook called `useApi` that you can use to make all of your API calls
-* [ ] Add more tests to give you further confidence in the code you're shipping
+* [ ] Submit via Codegrade by committing and pushing any new changes.
+* [ ] Check codegrade for automated feedback.
+* [ ] Check codegrade on Monday following the Sprint Challenge for reviewer feedback.
+* [ ] Any changes pushed to your "main" branch will resubmitted to codegrade if pushed before the sprint challenge deadline. Changes after the deadline will not be reviewed.
 
-## Submission format
+## Interview Questions
 
-Follow these steps for completing your project.
+Be prepared to demonstrate your understanding of this week's concepts by answering questions on the following topics. Add your answers to the questions within `interview_answers.md` file. These will not be counted as a part of your sprint score but will be helpful for preparing you for your endorsement interview, and enhancing overall understanding.
 
-- [ ] Ensure that your projects are complete on your <firstName-lastName> branch.
-- [ ] Merge your <firstName-lastName> branch into your main branch.
-- [ ] Push your main branch to github and check that it is registers within codegrade.
-- [ ] Check your personal feedback the following Monday. For more information check [here](https://www.notion.so/lambdaschool/How-to-View-Feedback-in-CodeGrade-Student-facing-c5147cee220c4044a25de28bcb6bb54a)
+1. Explain what a token is used for.
+2. What steps can you take in your web apps to keep your data secure?
+3. Describe how web servers work.
+4. Which HTTP methods can be mapped to the CRUD acronym that we use when interfacing with APIs/Servers.

interview_answers.md

@@ -0,0 +1,15 @@
+# Interview Answers
+Be prepared to demonstrate your understanding of this week's concepts by answering questions on the following topics. These will not be counted as a part of your sprint score but will be helpful for preparing you for your endorsement interview, and enhancing overall understanding.
+
+
+1. Explain what a token is used for.
+Tokens are strings that are used for user authentication. they are normally assigned when we make login post/requests with apis
+2. What steps can you take in your web apps to keep your data secure?
+use routes and authentication tokens are good for keeping data secure this also helps to make sure that the right authentication is happening and users are accessing areas of the application that they should be accessing
+3. Describe how web servers work.
+they hold code inside for each website
+4. Which HTTP methods can be mapped to the CRUD acronym that we use when interfacing with APIs/Servers.
+delete - DELETE
+read - GET
+create - POST
+update - PUT