Recreating portfolio from week 2 using react!
Being a web developer means being part of a community. You’ll need a place not only to share your projects while you're applying for jobs or working as a freelancer but also to share your work with other developers and collaborate on projects.
Your task is to create a portfolio using your new React skills, which will help set you apart from other developers whose portfolios don’t use the latest technologies.
You’ll deploy this application to Netlify. Follow the instructions in the Git Guide or consult the Docs on Netlify to create a build that you can deploy.
AS AN employer looking for candidates with experience building single-page applications
I WANT to view a potential employee's deployed React portfolio of work samples
SO THAT I can assess whether they're a good candidate for an open position
GIVEN a single-page application portfolio for a web developer
WHEN I load the portfolio
THEN I am presented with a page containing a header, a section for content, and a footer
WHEN I view the header
THEN I am presented with the developer's name and navigation with titles corresponding to different sections of the portfolio
WHEN I view the navigation titles
THEN I am presented with the titles About Me, Portfolio, Contact, and Resume, and the title corresponding to the current section is highlighted
WHEN I click on a navigation title
THEN the browser URL changes and I am presented with the corresponding section below the navigation and that title is highlighted
WHEN I load the portfolio the first time
THEN the About Me title and section are selected by default
WHEN I am presented with the About Me section
THEN I see a recent photo or avatar of the developer and a short bio about them
WHEN I am presented with the Portfolio section
THEN I see titled images of six of the developer’s applications with links to both the deployed applications and the corresponding GitHub repositories
WHEN I am presented with the Contact section
THEN I see a contact form with fields for a name, an email address, and a message
WHEN I move my cursor out of one of the form fields without entering text
THEN I receive a notification that this field is required
WHEN I enter text into the email address field
THEN I receive a notification if I have entered an invalid email address
WHEN I am presented with the Resume section
THEN I see a link to a downloadable resume and a list of the developer’s proficiencies
WHEN I view the footer
THEN I am presented with text or icon links to the developer’s GitHub and LinkedIn profiles, and their profile on a third platform (Stack Overflow, Twitter)
The following animation shows the web application's appearance and functionality:
You’ll use vite
to build your portfolio, which will include the following:
-
A single
Header
component that appears on multiple pages -
A single
Navigation
component within the header that will useLink
components fromreact-router-dom
to conditionally render the different sections of your portfolio -
A single
Project
component that will be used multiple times in the Portfolio section -
A single
Footer
component that appears on multiple pages
Note: Because this application doesn’t include a back end or connect to an API, the contact form doesn't need to save this information right now. You'll add back-end functionality in the next few weeks. In the meantime, consider including your email address and phone number on the Contact page.
-
In the command line, navigate to the desired parent folder and run
npm create vite@latest
.- 🔑 Note: This command will automatically create a sub-folder which will house your React application; you do not need to perform a
mkdir
command to create one manually.
- 🔑 Note: This command will automatically create a sub-folder which will house your React application; you do not need to perform a
-
Enter the desired name of your new project folder.
-
From the first list of options, select your framework; for our activities in class, we'll be using
React
. -
From the second list of options, select your variant; for our activities in class, we'll be using
JavaScript
. -
cd
into your newly created project folder and runnpm install
.- In later activities we'll add additional NPM packages to our
vite
apps such as 'bootstrap', 'dotenv', and 'axios'.
- In later activities we'll add additional NPM packages to our
-
Run
npm dev
/npm run dev
and navigate to the prompted URL to see your app.
- Navigate to your
package.json
and modify thescripts
object so that it looks like this example:
"scripts": {
"dev": "vite",
"start": "vite",
"build": "vite build",
"lint": "eslint src --ext js,jsx --report-unused-disable-directives --max-warnings 0",
"preview": "vite preview"
},
- Note the addition of the
"start": "vite"
script.
- Navigate to the
vite.config.js
file and edit the export object so that it looks like this example:
export default defineConfig({
plugins: [react()],
server: {
port: 3000,
open: true
}
})
For each project that is featured in your portfolio, include the following:
-
An image of the deployed application (either a short animated GIF or screenshot)
-
The title of the project
-
A link to the deployed application
-
A link to the corresponding GitHub repository
As with the previous portfolio Challenge, remember that "good" design is subjective; however, your site should look polished. Here are a few guidelines on what that means:
-
Use mobile-first design.
-
Choose a color palette that distinguishes your site from the default Bootstrap theme and unstyled HTML sites. Refer to resources like Coolors or another color scheme generator to help you create something that will stand out.
-
Ensure that the font size is large enough to read and that the colors don't cause eye strain.
-
Consider using animations and React component libraries. Note that this will not affect your grade, but it might impact how potential employers gauge your knowledge.
This project was bootstrapped with Create React App.
In the project directory, you can run:
Runs the app in the development mode.
Open http://localhost:3000 to view it in your browser.
The page will reload when you make changes.
You may also see any lint errors in the console.
Launches the test runner in the interactive watch mode.
See the section about running tests for more information.
Builds the app for production to the build
folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed!
See the section about deployment for more information.
Note: this is a one-way operation. Once you eject
, you can't go back!
If you aren't satisfied with the build tool and configuration choices, you can eject
at any time. This command will remove the single build dependency from your project.
Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except eject
will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.
You don't have to ever use eject
. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.
You can learn more in the Create React App documentation.
To learn React, check out the React documentation.
This section has moved here: https://facebook.github.io/create-react-app/docs/code-splitting
This section has moved here: https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size
This section has moved here: https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app
This section has moved here: https://facebook.github.io/create-react-app/docs/advanced-configuration
This section has moved here: https://facebook.github.io/create-react-app/docs/deployment
This section has moved here: https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify