Simple Portfolio Website with HTML, CSS & JavaScript on GitHub

Ann Jul 09, 2026

Creating a simple portfolio website can be an excellent way to showcase your skills and projects to potential employers or clients. With GitHub, HTML, CSS, and JavaScript, you can build a professional and engaging online presence. Let's dive into the process of creating a simple portfolio website using these tools.

Portfolio Website UI | Frontend Developer
Portfolio Website UI | Frontend Developer

Before we start, ensure you have a basic understanding of HTML, CSS, and JavaScript. If you're new to these technologies, don't worry; there are plenty of resources available online to help you learn. Additionally, having a GitHub account will allow you to version control your project and easily share your portfolio with others.

How To Make A Portfolio Website Using HTML CSS JS | Complete Responsive Website Design
How To Make A Portfolio Website Using HTML CSS JS | Complete Responsive Website Design

Setting Up Your Portfolio Project

To begin, create a new repository on GitHub for your portfolio project. Name it something relevant, like 'yourname-portfolio'. Once the repository is created, clone it to your local machine using the following command in your terminal:

Soft Personal Portfolio – Clean HTML/CSS Website 🌸
Soft Personal Portfolio – Clean HTML/CSS Website 🌸

git clone https://github.com/yourusername/yourname-portfolio.git

Project Structure

an image of a web page with the words hi, i'm divyansh chaudhary
an image of a web page with the words hi, i'm divyansh chaudhary

Create the following folders and files inside your project directory:

  • index.html
  • css/ (folder for your CSS styles)
  • js/ (folder for your JavaScript files)
  • img/ (folder for images)

Initializing the Project

18 Exciting HTML and CSS Project Ideas with source code to Level Up Your Web Development Skills
18 Exciting HTML and CSS Project Ideas with source code to Level Up Your Web Development Skills

Initialize a new Git repository in your project folder and add the initial files:

git init
git add .
git commit -m "Initial commit"

Creating the Basic HTML Structure

Portfolio Website Design
Portfolio Website Design

Open the index.html file and create a basic HTML structure. Include the necessary meta tags, a <title> tag, and the main sections of your portfolio, such as a header, navigation menu, hero section, about, skills, projects, and a footer.

HTML Semantic Elements

Portavia — A modern portfolio template
Portavia — A modern portfolio template
Tips for css style Animation
Tips for css style Animation
Insane Animated Portfolio Website 🤯 using HTML CSS JS
Insane Animated Portfolio Website 🤯 using HTML CSS JS
Github Profile
Github Profile
ReactJS, TailwindCSS Framer Motion, Particle | Responsive Portfolio Website with Advanced Animations
ReactJS, TailwindCSS Framer Motion, Particle | Responsive Portfolio Website with Advanced Animations
Create a Delicious Cupcake Design Using HTML & CSS! 🍰
Create a Delicious Cupcake Design Using HTML & CSS! 🍰
Html, Css Login Tamplates
Html, Css Login Tamplates
login form html css
login form html css
a computer screen with an image of a man on it
a computer screen with an image of a man on it
GitHub Profile
GitHub Profile
the homepage for casey brad's web development
the homepage for casey brad's web development
SOFTWARE DEVELOPER PORTFOLIO
SOFTWARE DEVELOPER PORTFOLIO
Página de aterrizaje exitosa.
Página de aterrizaje exitosa.
Designer Favorite: 20+ Free Portfolio Templates
Designer Favorite: 20+ Free Portfolio Templates
Diseña una landing page de éxito.
Diseña una landing page de éxito.
Web Portfolio 2
Web Portfolio 2
an image of a computer screen with the word'urri is'on it
an image of a computer screen with the word'urri is'on it
CSS Notes for Beginners (Easy + Quick Guide) 🎨
CSS Notes for Beginners (Easy + Quick Guide) 🎨
Technology Black Modern Webflow website template
Technology Black Modern Webflow website template

Use semantic HTML5 elements to improve accessibility and SEO. Some examples include <header>, <nav>, <main>, <section>, <article>, and <footer>.

Adding Content

Fill in the sections with relevant content, such as your bio, skills, and projects. You can use headings, paragraphs, lists, and links to structure the information. Don't forget to include a call-to-action, like a contact form or links to your social media profiles.

Styling Your Portfolio with CSS

Create a new file called style.css inside the css/ folder and link it to your index.html file. Start styling your portfolio by adding global styles, such as colors, fonts, and layout. Then, target specific elements to create a visually appealing design.

Responsive Design

Ensure your portfolio looks good on various devices and screen sizes by using media queries and responsive design techniques. You can use online tools like the Google Chrome DevTools device toolbar to test your design on different screen sizes.

CSS Frameworks and Libraries

If you're short on time or want a head start, consider using a CSS framework or library, such as Bootstrap, Tailwind CSS, or Materialize. These tools provide pre-built components and styles that can help you create a professional-looking portfolio quickly.

Adding Interactivity with JavaScript

JavaScript can enhance the user experience by making your portfolio interactive. Add functionality like smooth scrolling, lightbox galleries, or animations to make your portfolio stand out.

jQuery Library

While you can write JavaScript from scratch, using a library like jQuery can simplify the process and provide cross-browser compatibility. Include the jQuery library in your project by adding the following script tag in your index.html file:

<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>

JavaScript Functions

Create JavaScript functions to handle interactivity, such as smooth scrolling, lightbox galleries, or form submissions. Add these functions to a new file called script.js inside the js/ folder and link it to your index.html file.

Optimizing Your Portfolio

Before launching your portfolio, optimize it for better performance and SEO. Compress and minify your CSS and JavaScript files, optimize images, and ensure your website is mobile-friendly.

SEO Best Practices

Implement SEO best practices, such as using descriptive meta tags, creating an XML sitemap, and submitting your portfolio to search engines. This will help potential employers and clients find your portfolio online.

Now that you've created a simple portfolio website using GitHub, HTML, CSS, and JavaScript, it's time to share it with the world. Push your changes to GitHub, and deploy your portfolio using GitHub Pages or a hosting service of your choice. Keep updating your portfolio with new projects and skills as you grow in your career. Good luck!