HTMLPortfolio

Dark-Portfolio — HTML Portfolio Template

By iSev7n

Dark-Portfolio is a static personal portfolio and long-form writing site built with vanilla HTML, CSS, and JavaScript, requiring no framework or build step, with content managed as Markdown files.

Explore the design

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

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-13View source

What stands out

A quick read of the recorded project description.

01

Uses vanilla HTML5, CSS, and JavaScript, with no framework and no build step

02

Tabbed navigation covers pages such as About, Work, Projects, Posts, and Music

03

The article system is based on individual Markdown files under content/posts/*.md, supporting dynamic sorting, real-time filtering, and reading time estimation

04

Includes a lightweight Markdown parser that supports embedding images in articles

05

Provides dark/light theme switching and an rss.xml feed

06

Site-level configuration is centralized in js/config.js, including identity, social links, music integration, and theme defaults

Template Details

Dark-Portfolio is a static website template for personal portfolios and long-form writing, implemented with vanilla HTML5, CSS, and JavaScript, without frameworks, backends, or build tools. The site includes a centered avatar, greeting, and social icons, and organizes pages such as About, Work, Projects, Posts, and Music through tabbed navigation. The projects page displays projects in a grid with detailed descriptions; the article system reads individual Markdown files under content/posts/, supports dynamic sorting, real-time filtering, reading time estimation, and a document-style sidebar grouped by year, and includes a lightweight Markdown parser that can embed images in articles. The site also provides dark/light theme switching and an rss.xml feed.

Content management is file-driven: each article is a .md file containing metadata such as title, slug, date, and tags; site-level configuration is centralized in js/config.js, covering identity information, taglines, social links, music integration, and theme defaults. Local development requires running a static server (the README example uses python -m http.server 5173), because pages rely on fetch and routing. For deployment, the README states that the template is suitable for static hosting environments such as GitHub Pages, Netlify, Cloudflare Pages, or shared hosting, and does not require a server-side runtime.

The README does not provide specific framework version numbers, performance data, or production-readiness statements; the template is positioned as a personal portfolio project, and its structure can be reused with attribution.

HTMLPortfolio

Is it right for your project?

Use Cases

  • Building a personal portfolio website to showcase projects with detailed descriptions
  • Managing and publishing long-form writing content as Markdown files
  • Deploying to static hosting environments such as GitHub Pages, Netlify, Cloudflare Pages, or shared hosting
  • Personal sites that need offline-first operation and rely only on static assets

Suitable For

  • Individual developers who want to control the site with vanilla web technologies and avoid introducing frameworks or build tools
  • Writers who need to both showcase a portfolio and publish long-form content
  • Users who prefer file-driven content management for easier Git diffs
  • Users planning to host the site on a static hosting platform

Getting started & customization

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

  1. 1

    Local development requires running a static server; the README example command is python -m http.server 5173, then visit http://localhost:5173

  2. 2

    Article content goes in content/posts/*.md, and each article includes metadata such as title, slug, date, and tags

  3. 3

    Site-level configuration is modified in js/config.js, including identity, taglines, social links, music integration, and theme defaults

  4. 4

    Deploying to a static hosting platform does not require a server-side runtime

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 that version and does not mean that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of that version's code are permitted.
  • When distributing copies or substantial portions of the code, 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

  • Demo images, fonts, icons, and other third-party assets must be checked against 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.
  • The project is positioned as a personal portfolio project, and the README states that its structure can be reused with attribution, meaning reuse requires retaining attribution.
  • Reusing the project structure requires attribution.
View Original Text Basis

Compiled by DeepSeek based on repository license and README ·2026-10-13. 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 · 75 / 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
2026-02-21
Screenshot last checked
2026-10-13

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.

Review declaration: codex-user-requested-batch-review-20261015 · 2026-10-15

Inspect the recorded source material

SHA-256: 24fd2fefd785d9d4387b211e44964b0d67f0360e1e2a2ec6ca5cb6d1027fa399

2026-10-13T14:59:29.982Z

Source file / repository
# Static Portfolio (HTML / CSS / JavaScript)

<p align="center">
  <img
    src="https://raw.githubusercontent.com/iSev7n/Dark-Portfolio/refs/heads/main/assets/projects/dark-portfolio.png"
    alt="Dark Portfolio Preview"
    width="800"
  />
</p>

A fast, offline-capable personal portfolio built with **vanilla web technologies**.  
No frameworks. No build step. Designed for clarity, longevity, and control.

This site functions as both a portfolio and a long-form writing platform.

---

## Features

- Centered hero with avatar, greeting, and social icons  
- Tab-based navigation (About, Work, Projects, Posts, Music)  
- Projects grid with detailed descriptions  
- Posts system powered by individual Markdown files:
  - Sorted dynamically
  - Live filtering
  - Reading-time estimates  
  - Docs-style post layout with year-grouped sidebar  
- Custom lightweight Markdown parser  
- Embedded images inside posts  
- Offline-first friendly (static assets only)  
- Dark / light theme toggle  
- RSS feed (`rss.xml`)  

---

## Tech Stack

- HTML5  
- CSS (custom properties, responsive layout)  
- Vanilla JavaScript  
- Custom Markdown renderer  
- File-based content system (`.md` posts)  

No backend. No framework. No build tooling.

---

## Local Development

Run a local server (required for `fetch` and routing):

```bash
python -m http.server 5173
```

Open:

```
http://localhost:5173
```

---

## Project Structure

```
/
├── index.html
├── posts.html
├── post.html
├── projects.html
├── experience.html
├── music.html
├── work.html
├── rss.xml
│
├── css/
│   ├── base.css
│   └── pages/
│       ├── music.css
│       ├── post.css
│       ├── posts.css
│       └── projects.css
│
├── js/
│   ├── ui.js
│   ├── data.js
│   ├── icons.js
│   ├── layout.js
│   ├── markdown.js
│   ├── config.js
│   └── pages/
│       ├── posts.js
│       ├── post.js
│       ├── projects.js
│       ├── work.js
│       ├── experience.js
│       ├── about.js
│       └── music.js
│
├── content/
│   └── posts/
│       ├── post_1.md
│       ├── post_2.md
│       └── ...
│
└── assets/
    ├── favicon_io/
    ├── posts/
    └── projects/
```

---

## Content System

### Posts

All writing lives in:

```
content/posts/*.md
```

Each post includes metadata (title, slug, date, tags) and full Markdown content.

This file-based approach allows:

- Clean Git diffs  
- Better scalability  
- Easier long-form writing  
- No centralized JSON bottleneck  

---

## Configuration

Edit site-wide values in:

```
js/config.js
```

Includes:

- Identity and tagline  
- Social links  
- Music integration  
- Theme defaults  

---

## Hosting

Designed for static hosting:

- GitHub Pages  
- Netlify  
- Cloudflare Pages  
- Shared hosting  

No server-side runtime required.

---

## Philosophy

- Predictable UI over clever abstractions  
- Long-term maintainability over trend adoption  
- Systems thinking applied to frontend architecture  
- Calm, readable software that ages well  

---

## License

Personal portfolio project.  
Structure may be reused with attribution.
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