Giter Club home page Giter Club logo

communitypro / portfolio-html Goto Github PK

View Code? Open in Web Editor NEW
323.0 5.0 170.0 1.21 MB

๐ŸŒ Open source portfolio template built with plain Html, CSS and JavaScript for developers to create their portfolio website

Home Page: https://cpro-portfolio-html.netlify.app

License: MIT License

CSS 41.94% HTML 49.55% JavaScript 8.51%
portfolio portfolio-template community-project javascript template html5 css3 community portfolio-website landing-page

portfolio-html's Introduction

Portfolio Template - HTML

Build your portfolio using this super easy template. Free to use if you are a member of the community or a contributor to this project. If not, read our requirements if you plan on using this template for your portfolio.

This project is made from the tireless efforts of the community, so feel free to support our work by contributing, staring โœจ the project or sponsoring us. ๐Ÿ™๐Ÿฝ


Design credit:

How to Contribute

Are you contributing to this project, please ensure all pull requests and contributions comply with our guidelines.

Before making any changes, ensure you have raised an issue here, unless it is a minimal change like Typo error then you can go right ahead.

Folder Structure

โ”œโ”€โ”€ src
โ”‚   โ”œโ”€โ”€ index.html
โ”‚   โ”œโ”€โ”€ css
โ”‚   โ”‚   โ”œโ”€โ”€ style.css
โ”‚   โ”‚   โ”œโ”€โ”€ utilities.css
โ”‚   โ”œโ”€โ”€ assets
โ”‚   โ”‚   โ”œโ”€โ”€ favicon
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ android-chrome-192x192
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ android-chrome-512x512
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ apple-touch-icon
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ favicon-16x16
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ favicon-32x32
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ favicon.ico
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ site.webmanifest   
โ”‚   โ”‚   โ”œโ”€โ”€ profile-image
โ”‚   โ”‚   โ”œโ”€โ”€ logo
โ”‚   โ”œโ”€โ”€ js
โ”‚   โ”‚   โ”œโ”€โ”€ script.js
โ”œโ”€โ”€ .github
โ”‚   โ”œโ”€โ”€ ISSUE_TEMPLATE
โ”‚   โ”‚   โ”œโ”€โ”€ bug.md
โ”‚   โ”‚   โ”œโ”€โ”€ feature.md
โ”‚   โ”œโ”€โ”€ Pull_request_template.md
โ”œโ”€โ”€ CODE_OF_CONDUCT.md
โ”œโ”€โ”€ CONTRIBUTING.md
โ”œโ”€โ”€ LICENSE
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ REQUIREMENTS.md
โ”œโ”€โ”€ package.json
โ””โ”€โ”€ .gitignore

โœจ How to Customize this Template โœจ

This portfolio uses modern HTML5 semantic tags like article, header, footer and more for better accessibility and improve SEO, you can read more about that on Jemima's article: How to improve your SEO ranking. Also learn about metatags and how to generate them for SEO optimization here.

The root page of this project is located at /docs/index.html This is the default page you see when you visit the site. Want to customize this template to suit your style, here are a few things you can change:

1. Logo

The logo of this template is controlled by this line in the index.html markup, replace the ./assets/logo.png with your logo link or replace the current logo image without yours and rename it to logo.png

<!-- Logo -->
<h1 id="logo">
    <a href="#"><img src="./assets/logo.png" alt="Your Logo"></a>
</h1>

2. Navigation Links

<ul class="nav-menu">
   <li><a class="nav-link" href="#">PROJECTS</a></li>
   <li><a class="nav-link" href="#">CONTACT</a></li>
   <li><a class="nav-link" href="#">BlOG</a></li>
   <li><a class="nav-link btn btn-primary" href="#">RESUME <i class="fas fa-arrow-right"></i></a>
   </li>     
</ul>

Replace the # symbol with your respective link. Delete any nav-link that is not being used or edit the name with your own preferred link source.

  • The last navigation link is the highlighted yellow button on the template. Which is styled with the btn & btn-primary classes.

3. Profile Image

Replace the icon or user profile with your profile image. Image can be found in the /assets/profile-image.png.

<img class="profile-image" src="./assets/profile-image.png" alt="" />

You can add the image locally by replacing it with the /assets/profile-image.png. Or replace the src link in the HTML file with your preferred image. I recommend you copy your GitHub profile image link, so the image changes anytime you update it on GitHub.

4. Name

Edit the name on the welcome message with your own name. This line of text can be found in the /docs/index.html file. Replace Franklin with your own name.

<h1>Hi I'm Franklin</h1>

5. Job Title

Summarize what you do in five words and add it into the <h2></h2> line. Add the first two in the first <h2> element and add the remaining four on the next <h2>

<h2>Building digital</h2>
<h2>products, brands, and experience.</h2>

6. Job Description

Update the job description with your information. 20 words recommended.

<p>
  A Frontend Developer and Visual Designer with experience in web
  design, brand identity and product design.
</p>

7. Connect With Me

Replace the # on the connect with me button with a link. You can choose what link you want your visitors to go when they click this button. Social links, email address or phone number, it's completely up to you.

<a href="#" class="btn btn-secondary">Connect With Me</a>
  • Email: <a href="mailto:[email protected]" class="btn btn-secondary">Connect With Me</a> OR
  • Phone: <a href="tel:+23400000000" class="btn btn-secondary">Connect With Me</a>

8. Project

This section showcases your projects using screenshots. It has 3 columns and 2 rows by default but you can add more columns according to your use case. The .project controls the number of columns and rows of the project cards.

<div href="" class="card">
   <div class="project-info">
      <div class="project-bio">
         <h3>Project One</h3>
         <p>React, Redux, SASS</p>
      </div>

      <div class="project-link">
         <a href="#"><i class="fab fa-github"></i></a>
         <a href="#"><i class="fas fa-globe"></i></a>
      </div>
   </div>
</div>

To customize the cards, here are a few things you can change:

Project Title

<h3>Project One</h3>

This is controlled by the <h3></h3> element. Edit the text and add your preferred project name.

Project Stack

This is where you display the tools/technologies used in building the project. Edit the <p></p> element with the specific tools or delete the line completely.

<p>React, Redux, SASS</p>

Project Link

The project links are the icons on the top right of the project cards. One is the github link and the other is the live link. You can paste the respective links into the empty href attributes. The icons are added using an icon library called fontawesome so changing this icon is super easy.

<a href="#"><i class="fab fa-github"></i></a>
<a href="#"><i class="fas fa-globe"></i></a>

Project Styling

The layout of the project cards is controlled by the .project in the style.css file. By using CSS grid-template-columns, the cards are outlined on three columns on desktop mode, two columns on tablet mode and one column on mobile view.

.project {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  grid-auto-rows: minmax(250px, auto);
  grid-gap: 0.9rem;
}

Social Links

The footer links contain social icons that you can link to your specific social channels. By default the icons available are: Facebook, Twitter, LinkedIn, GitHub, Hashnode and the icons image are added locally to the assets folder, so you can add your own custom icon and link it.

<a href="mailto:[email protected]">[email protected]</a>
 <div class="social">
    <a href="#"><img src="./assets/facebook-icon.svg" alt="Facebook"></a>
    <a href="#"><img src="./assets/twitter-icon.svg" alt="Twitter"></a>
    <a href="#"><img src="./assets/linkedin-icon.svg" alt="Linkedin"></a>
    <a href="#"><img src="./assets/github-icon.svg" alt="GitHub"></a>
    <a href="#"><img src="./assets/hashnode-icon.svg" alt="Hashnode"></a>
 </div>

META Tags

Use Metatags.io to generate meta tags for sharing your portfolio and for SEO benefits.

Styling

We are using plain CSS for this project and you can find that in the docs/css/ folder

  • style.css is the main file
  • utilities.css is where reusable styling will be.

Examples

Here are examples of portfolios customized using this template, you can draw inspiration from this list or add yours.


Example 1

Example 2

Sponsor

If you like this project, kindly star โญ and share this project. It means the world to us. You can also offer support by donating to keep this project going.

portfolio-html's People

Contributors

adi611 avatar aditya062003 avatar andrewnashed avatar cemmanuelonyema avatar deevyn9 avatar evavic44 avatar frankiefab100 avatar mannuel25 avatar nishantchandla avatar ogbeidebest avatar priyansumaurya avatar rishikumarray avatar rishvantsingh avatar riyaflix avatar shubhamdev-code avatar shubhamsaini1585 avatar ukane-philemon avatar vermilion4 avatar winniffy avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

portfolio-html's Issues

[BUG] -

Github page is not working

The deployed website on Github Pages in not working

To Reproduce

Steps to reproduce the behavior:

  1. Go to Environments
  2. Click on github-pages
  3. Click on View Deployment
  4. See error

Expected behavior

The website should be displayed on the web

Screenshots

image

Laptop:

  • OS: [macOS]
  • Browser [chrome]
  • Version [ 97.0.4692.99]

[FEAT] - Add background on button

Is your feature request related to a problem? Please describe.

No

Describe the solution you'd like

On the "connect with me button", add a background and text color on the btn-secondary class.
You can find this button class in utilities.css

.btn-secondary {
  background: var(--bg-secondary);
  color: var(--text-color-2);
}

Screenshots

button-background

Describe alternatives you've considered

None

Additional context

It's good to note that the --bg-secondary & --text-color-2 classes are responsible for adding the background and text color on both the light and dark mode.

Replace PNG profile image with SVG

Issue

The profile image uses a PNG format which doesn't serve the best quality.

Recommended Fix

Download the zip file, extract it and add it to the assets folder, don't forget to change it on the html file as well.

Zip File

profile-image.zip

[BUG] - HTML is missing h2 closing tag

Describe the bug

There is no closing tag.

To Reproduce

Steps to reproduce the behavior:

  1. Go to index.html
  2. Line 105

Expected behavior

There should be no errors when parsing HTML

Screenshot

Screenshot 2022-01-25 at 4 28 45 PM

typo error

bug

there's a typo error.

expected behavior

'visual design' should be corrected to 'visual designer'

Screenshots

Screenshot 2022-01-22 205355

[FEAT] - Add about section

Is your feature request related to a problem? Please describe.

No

Describe the solution you'd like

Add about section that contains the image and short bio

[FEAT] - Make project cards responsive

Is your feature request related to a problem? Please describe.

Projects cards are not mobile responsive.

Describe the solution you'd like

Make the cards responsive. The cards are currently using grid which is added to the project class in the style.css file

Describe alternatives you've considered

The cards are currently in 3 columns and two rows, using media-queries, add a new breakpoint at 1000px to make the cards two columns and at 600px one column.

Fix

@media (max-width: 1000px) {
  .project {
    display: grid;
    grid-template-columns: repeat(2, 1fr);
  }
}

@media (max-width: 600px) {
  .project {
    display: grid;
    grid-template-columns: 1fr;
  }
}

Also, in the style.css file, try to arrange the media-queries according to their breakpoints -where 1000px is first and 600px is last.

Each breakpoint can be handled by two persons.

Feature

Creation of navigation bar

[FEAT] - Swap lightmode icons.

Is your feature request related to a problem? Please describe.

Light and dark mode icons inverted.

Describe the solution you'd lIke.

Swap the light mode icon to show on dark mode and dark mode icon to show on light mode.

[BUG] - Navigation transparent on mobile view

Describe the bug

The navigation is transparent on mobile view and the text can be seen behind when the hamburger menu is clicked.

To Reproduce

Steps to reproduce the behavior:

  1. Go to the website: https://cpro-portfolio-html.netlify.app/
  2. Reduce the browser view
  3. Click the hamburger menu button
  4. See the transparent nav-menu

Expected behavior

The navigation menu should not be transparent.

Screenshots

transparent-navigation

Desktop (please complete the following information):

Windows

Smartphone (please complete the following information):**

  • Device: iPhone 7

Recommended fix

Add a background to the navigation menu.
This menu is controlled by the nav-menu class, therefore on the style.css file, add the primary background using the --bg-primary variable

.navbar .nav-menu {
  background: var(--bg-primary);
}

[BUG] - Add Padding To Content

Describe the bug

The contents on the page are too squished and should be spaced out a bit.

To Reproduce

Steps to reproduce the behaviour:

  1. Go to 'https://cpro-portfolio-html.netlify.app/'
  2. See the contents on the main page

Expected behaviour

It is hard to read content as they all appear to be on the same spot with no room to breathe.

Screenshots

Screenshot (355)

Desktop (please complete the following information):

  • OS: Windows 11
  • Browser: Chrome
  • Version: Version 97.0.4692.71

Smartphone (please complete the following information):**

  • Device: Samsung Galaxy Note 10+
  • OS: Android 11
  • Browser: Samsung Internet
  • Version: 16.0.6.23

Additional context

Add padding or margins for the spacing.

[FEAT] - Add metatag guide

Is your feature request related to a problem? Please describe.

No

Describe the solution you'd like

Add a metatag guide for users to generate their own meta tags so when they share their portfolio to social platforms, it will preview the meta image.

Describe alternatives you've considered

Use metatags.io

Additional context

None.

[FEAT] - Rotate Arrow Icon

Is your feature request related to a problem? Please describe.

The arrow icon attached to the resume button on the navbar is pointing in a direction different from the design

Describe the solution you'd like

The arrow icon should point upward to the North-East direction.

Additional context

Screenshot (357)

[BUG] - Light and dark mode icons not showing

Describe the bug

The light and dark mode icons have been added but the icons have not. Raise a PR to add the icons using the ones provided below.

To Reproduce

Steps to reproduce the behavior:

  1. Load the index.html file in a browser.
  2. See the missing icon on the top right.

Expected behavior

Should show the sun icon only. Moon icon will be activated when dark mode is active.

Screenshots

missing-icons

Fix

The icons have already been linked in the HTML file just add the icons to the folder

templates/assets

You can get the icons below. ๐Ÿ‘‡๐Ÿพ

Additional context

Once added, only the sun icon will show. Don't worry about that as the script has not been added to toggle the icons.

Icons

Unzip the icons and add them
icons.zip

[DOCS] - Update Project Tree

The project tree has been changed and needs to be updated.

Preview of the tree.
project-tree

Recommended changes

Update the project tree in the README to match the project structure.

[FEAT] -

Needs little space around the elements

The h2 text and the p text also the connect with me button looks congested. It would be nice to put around some space especially on top of texts

I would like to add some margins

Putting some margins spreads out the elements to look clearer and elegant

Screenshot

image

Add hover on button

On the Resume button with the yellow background, add a hover to the button.

The hover will be a color change.

The button uses

--primary-color: #ffcd42;

Hover would be

--secondary-color: #ffd35c;

[FEAT] - Configure Dependency

Is your feature request related to a problem? Please describe.

Describe the solution you'd like

Setup the dependency to collect users of the project.

Describe alternatives you've considered

Still researching ways to do that.

Additional context

This will help curate the number of users of this project.

dependecny

[FEAT] - Add comunitypro watermark

Is your feature request related to a problem? Please describe.

This is to ensure users can give attribution to the efforts of the community members that built this.

Describe the solution you'd like

Add a badge on the bottom of the social icons that says Template by Communitypro

Describe alternatives you've considered

  1. Use badges

  1. A stylish font
  2. A button, etc.

Additional context

None

Site not loading

After going through the site url present in the repo, nothing loads except from the navbar, also the links doesn't do anything when clicked.
Don't know if this a feature or a bug?

[Feature] - Add project favicon

Describe the solution you'd like

  • Visit https://favicon.io/favicon-converter/ to convert the image to different files.
  • Rename the folder to favicon and add it to the /templates/assets folder.
  • Link the favicon to the HTML file using the code generated below.
 <link rel="apple-touch-icon" sizes="180x180" href="assets/favicon/apple-touch-icon.png">
 <link rel="icon" type="image/png" sizes="16x16" href="/assets/favicon/favicon-16x16.png">
 <link rel="icon" type="image/png" sizes="32x32" href="assets/favicon/favicon-32x32.png">
 <link rel="icon" type="image/png" sizes="192x192" href="assets/favicon/android-chrome-192x192.png">
 <link rel="icon" type="image/png" sizes="512x512" href="assets/favicon/android-chrome-512x512.png">
 <link rel="icon" type="image/x-icon" href="assets/favicon/favicon.ico">
 <link rel="manifest" href="assets/favicon/site.webmanifest">

Additional context
Here is the favicon image:
Big-black-logo

[FEAT] - Generate Meta Tags

Is your feature request related to a problem? Please describe.

No

Describe the solution you'd like

Generate Meta Tags for the template.

Describe alternatives you've considered

Use https://metatags.io/ to generate it, copy the tags generated and paste it into the head of the html page

Additional context

This issue will be broken down into smaller issues so it will be easier to review and fix. Check the box as you fix any of the issues stated below.

Meta information.

Image

Portfolio Preview

Title

Portfolio Template - Open source

Description

Build or customize your portfolio website using this super easy template. Free to use if you are a member of the community or a contributor to this project

  • Update the images src with this link. Use: https://user-images.githubusercontent.com/62628408/150613011-b78a7f5a-0af1-4312-aab0-0022e7258693.png
  • Paste it in the head of the html page

[BUG] - Directly link sponsor to the Sponsor/Support Button

Description
In the introductory section of the README that reads:
This project is made from the tireless efforts of the community, so feel free to support our work by contributing, staring โœจ the project or sponsoring us. ๐Ÿ™๐Ÿฝ

The text sponsoring should redirect a user to the Sponsor button.

[FEAT] - Add footer section

Is your feature request related to a problem? Please describe.

No.

Describe the solution you'd like

Add the footer section

[FEAT] - Add profile image animation

Is your feature request related to a problem? Please describe.

No, I thought this will be a cool idea.

Describe the solution you'd like

Add a simple bouncing animation on users' profile image.

Describe alternatives you've considered

Use CSS @keyframe to create an animation that translates up and down the Y-axis.

Additional context

Nope.

Link badges in README to their respective labels

Link the respective labels to their badges.

You can find the labels here
Copy each label link and use it to wrap their corresponding badge in the README.

Fix

This is an example of the bug label wrapped with it's link.

<a href="https://github.com/CommunityPro/portfolio-html/labels/bug">
<img src="https://img.shields.io/github/labels/Communitypro/portfolio-html/bug">
</a>
  • good first issue
  • help wanted
  • enhancement
  • bug

Fix only one, so others can have a go too.

Badge screenshot

labels

[FEAT] - Make Navigation responsive

A clear and concise description of what the problem is.

Navigation menu not mobile responsive, consider adding a hamburger menu to hide navlinks on mobile view

[FEAT] - Add target="_blank" to external links

Is your feature request related to a problem? Please describe.

It's stressful when a link opens on the same tab instead of opening on a new tab.

Describe the solution you'd like

Adding " target='_blank' " to all the links.

Describe alternatives you've considered

The above solution should be the only solution to that issue.

Additional context

none available

[Feature] - Create REQUIREMENTS.md file

Description
Create a new file named REQUIREMENTS.md which contains important instructions for external users or anyone who is not a member of Community Pro.

[BUG] -

Mis-Alignment

The text on the hero button doesn't align well on mobile, it is left aligned instead of center

Before

Alignment issue

Solution - Center Alignment

The text should be centered
.
alignment expected

Desktop (please complete the following information):

  • OS: Windows
  • Browser chrome

Smartphone (please complete the following information):**

  • Device: Andriod

  • Browser: Chrome

Additional context

Add any other context about the problem here or do you have a recommended fix for this?

Project navigation link not linked to the project section

Issue

Project link not directing to the project section when clicked.

Recommended Fix

Create a new id selector called projects and add it to the project section.

<section id="projects">

</section>

Add the project tag to the project navigation link.

- <li><a class="nav-link" href="#">PROJECTS</a></li>
+ <li><a class="nav-link" href="#projects">PROJECTS</a></li>

[DOCS] - Add Netlify deploy badge

Add Netlify badge to the README so we can monitor deployment status

[![Netlify Status](https://api.netlify.com/api/v1/badges/d831b80b-40d4-473a-b552-13055a16a6da/deploy-status)](https://app.netlify.com/sites/cpro-portfolio-html/deploys)

[FEAT] - Add Fontawesome link

Describe the solution you'd like

Add fontawesome link to the head of the page.

Describe alternatives you've considered

This will help to use icons like the arrow icon on the resume button.

Additional context

Get fontawesome link from: https://fontawesome.com/
Copy the minified version.

Have issues with Fontawesome, use https://cdnjs.com/ search for fontawesome, copy the minified version and add it inside the head of the html file.

Add project images

Extract the zip file, add the images inside to a new folder called projects in the assets folder.

project.zip

  • Extract file
  • Create a project folder in assets
  • Add images to project folder

[BUG] - Add division between Hero section and Project section

Describe the bug

There is too much space between the hero and project sections, so it looks weird.

To Reproduce

Steps to reproduce the behavior:

  1. Go to 'https://communitypro.github.io/portfolio-html/'
  2. Look at the main screen

Expected behaviour

Expect a division line between the two sections.

Screenshots

Screenshot (362)
Convert to:
Screenshot (363)

Desktop (please complete the following information):

  • OS: Windows 11
  • Browser: Chrome
  • Version: 97.0.4692.71

Additional context

Fix

in the HTML: add this between the two sections

</header>
   
  <div class="division"></div>
   
<!-- Projects -->

in the CSS:

.division{
  border: 3px solid var(--card-background);
  background-color: var(--card-background);
  margin: 5.5rem 0;
}

change min-height from 100vh to 60vh in hero section:

#hero {
  display: flex;
  flex-direction: column;
  min-height: 60vh;
}

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.