HTMLPortfolio

portfolio (nisarhassan12) — HTML Portfolio Template

By nisarhassan12

A personal portfolio website template written in HTML, SCSS and vanilla JavaScript, with no CSS or JavaScript framework dependencies, open-sourced under the MIT license.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

2 previews
Desktop homepage1 / 2
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-09-30View source

What stands out

A quick read of the recorded project description.

01

Implemented purely in HTML, SCSS and vanilla JavaScript, with no CSS or JavaScript framework dependencies

02

Provides two npm scripts: a development server and a production build

03

Includes a Gitpod online development environment configuration for one-click startup

04

Code is under the MIT license, allowing modification, commercial use and distribution

05

The author asks for attribution when using the theme design

Template Details

This repository contains the open-source code for the author's personal portfolio site. The page structure is written in HTML, styles use SCSS, and interaction logic is vanilla JavaScript, with no CSS or JavaScript libraries and no framework dependencies.

The project provides two script paths for local development and production builds: after installing dependencies, running the development server allows local preview, while the production build outputs minified and optimized site code. The repository also provides a Gitpod online development environment entry point, which can clone the repository, preinstall dependencies and start a web server with one click.

In the README, the author states that contributions are welcome and that the project may be used as a template for one's own portfolio, but asks that attribution be given when using the theme design. The demo site is hosted on surge.sh.

Regarding usage restrictions: the code itself is under the MIT license and may be used, modified, used commercially and distributed for free, but when distributing copies of the code or substantial portions, the original author's copyright notice and the full MIT license notice must be retained; third-party assets such as demo images, fonts and icons must be checked separately under their respective licenses and cannot be judged solely by the code's MIT license; external services such as domains and hosting may incur separate charges.

HTMLPortfolio

Is it right for your project?

Use Cases

  • Modifying it as a base template for a personal portfolio website
  • Learning how to organize an HTML/SCSS/vanilla JS site without frameworks
  • Trying or contributing to the project directly in the Gitpod online environment

Suitable For

  • Developers who need a lightweight portfolio page and do not want to introduce a frontend framework
  • Individuals who want to modify and deploy it themselves based on MIT-licensed code
  • Frontend learners who want to reference a framework-free site build process and directory organization

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Local development requires Node.js to be installed first

  2. 2

    Run npm install to install dependencies

  3. 3

    Run npm run dev to start the development server, with the default address at http://localhost:1234

  4. 4

    Run npm run prod to generate a minified and optimized production build

  5. 5

    It can also be opened in an online environment via the Gitpod button in the repository

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that external services or third-party assets are free.

Must comply with when using

  • The code of this version may be used, modified, used commercially and distributed for free.
  • When distributing copies of the code or substantial portions, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • When using the theme design, attribution is required (giving credit to this repository), which is the author's attribution request beyond the MIT license.
  • Local development requires installing the Node.js environment yourself, which is an external tool dependency.
  • The development server runs by default on local port 1234, and previewing requires accessing that address through a browser.
  • Demo images, fonts, icons and other third-party assets must be checked under their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments or AI may incur separate charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

Please give me (this repo) credit for the theme design.

Original README

You need [Node.js][node] to develop the site locally on your computer.

Original README

This will start the development server at [`http://localhost:1234`][local]

Original README
https://github.com/nisarhassan12/portfolio/blob/master/LICENSE.txthttps://github.com/nisarhassan12/portfolio/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-09-30. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 76 / 100
Technologies
HTML
Website type
Portfolio
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2024-06-15
Screenshot last checked
2026-09-30

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies HTML as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 156f60aba319ad668b29b42540a250389a1573f7253e3bd407cc3ea01aa113eb

2026-09-30T10:58:59.028Z

Source file / repository
[![Gitpod Ready-to-Code](https://img.shields.io/badge/Gitpod-Ready--to--Code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/nisarhassan12/portfolio) 

# Portfolio

> My portfolio site, which is now open source! <br />
> Check out the [live site here →][site]

![image][screenshot]

This repo contains the code for a portfolio site that has a rich user-experience, is performant, and accessible. The website is built using HTML, SCSS, vanilla JavaScript, and it doesn't use any CSS or JavaScript libraries or have any framework dependencies. Everyone is welcome to contribute or use it as a template for their portfolio. Please give me (this repo) credit for the theme design.

#### Online one-click setup for Contributing

Contribute to the portfolio, using a fully featured online development environment; cloned repo, pre-installed dependencies, running web server.

[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/from-referrer/)

## 🚀 Getting Started

You need [Node.js][node] to develop the site locally on your computer.

### 🔋 Step #1. Install the Dependencies

```sh
   npm install
```

### 📟 Step #2. Start the Development Server

```sh
npm run dev
```

This will start the development server at [`http://localhost:1234`][local] that you should browse to check the local dev version of this site.

### ♻️ Step #3. Production Build

```sh
npm run prod
```

This script will create the production build that contains the site code, which is fast and optimized and minified for production.

[site]: https://nisar.surge.sh
[screenshot]: https://user-images.githubusercontent.com/46004116/81985654-fd088c00-964f-11ea-8fae-1ce021b729c8.png
[node]: https://nodejs.org/en/download/
[local]: http://localhost:1234
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

simplefolio

simplefolio

Simplefolio is a minimal single-page portfolio template for developers, built with HTML, Bootstrap, SCSS, and Parcel under the MIT license. It includes Hero, About, Projects, Contact, and Footer sections, with content edited in /src/index.html and theme colors controlled by two SCSS variables.

HTML · Portfolio

Freelancer

Freelancer

A bright, single-page Bootstrap portfolio template for freelancers, designers, and small studios. It includes a responsive portfolio grid with modal detail windows and an SB Forms contact form that requires an API token.

HTML · Portfolio

Resume

Resume

A single-page resume and CV template from Start Bootstrap, built on Bootstrap with a fixed sidebar and content sections.

HTML · Portfolio

Creative

Creative

A single-page marketing template by Start Bootstrap for creative agencies and product services, built on Bootstrap with SCSS, featuring a portfolio grid and call-to-action sections. It includes pre-set SB Forms markers for form integration and npm build scripts for source customization.

HTML · Corporate Website

Grayscale

Grayscale

A dark single-page Bootstrap template from Start Bootstrap for photography, events and brand storytelling, with a large hero and clearly separated sections.

HTML · Corporate Website

startbootstrap-stylish-portfolio

startbootstrap-stylish-portfolio

A one-page Bootstrap portfolio theme from Start Bootstrap with multiple content sections and an off-canvas navigation menu. Basic use means editing HTML/CSS under dist and opening index.html; advanced use relies on npm with Pug and SCSS build scripts.

HTML · Portfolio