Jekyll static site, with content maintained via YAML data files and Markdown files
JekyllPortfolioBlog
portfolio-website — Jekyll Portfolio Template
By iamHrithikRaj
A Jekyll-based personal portfolio and blog template that maintains project, experience, and education information through YAML data files, deployable to Netlify or GitHub Pages.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
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-10-03View source
What stands out
A quick read of the recorded project description.
`_data` contains projects.yml, experience.yml, and education.yml to manage projects, experience, and education information respectively
Project detail pages are Markdown files in the projects directory, linked to list entries via the page-name field
README provides two deployment paths: Netlify and GitHub Pages
Under MIT license, allowing free use, modification, commercial use, and distribution of the code
Template Details
This is a Jekyll static site template for building a personal portfolio website, which also includes blog/project article functionality. Site content is primarily driven by three data files in the `_data` directory: `projects.yml`, `experience.yml`, and `education.yml`, which respectively contain projects, work experience, and educational background; the template renders lists based on these. Project detail pages are Markdown files placed in the `projects` directory, with `title` and `layout: page` in the front matter, and are linked to corresponding entries in `projects.yml` via the `page-name` field.
Before use, you need to modify `_config.yml` to fill in personal information and change `url` to the actual hosting address (the trailing slash must be retained). The README states it can be deployed to Netlify or GitHub Pages, but GitHub Pages only supports the user homepage form `username.github.io`, not the project subpath `username.github.io/repo-name`. Local development requires installing Ruby and Bundler; run `bundle install --path vendor/bundle` and then `bundle exec jekyll serve`.
The template is under the MIT license, allowing free use, modification, commercial use, and distribution of the code, but third-party assets such as demo images, fonts, and icons need separate license verification, and external services like domains and hosting may incur costs. The repository does not provide more detailed style and component documentation; for specific visuals and interactions, refer to the demo site and source code.
JekyllPortfolioBlog
Is it right for your project?
Use Cases
- Build a personal portfolio homepage to centrally showcase projects, work experience, and educational background
- Write separate Markdown detail pages for each project and link them to the project list
- Host the static site on a GitHub Pages user homepage or Netlify
- Run the Jekyll server locally using Ruby and Bundler for development and debugging
Suitable For
- Developers with experience in Jekyll or static sites who are willing to directly edit YAML and Markdown
- Individual developers or students who need to present both a portfolio and project articles
- Those planning to deploy the site using Netlify or a GitHub Pages user homepage
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Click the repository's Use the Template button to create your own copy
- 2
Modify `_config.yml` to fill in personal information, and change `url` to the actual hosting address while retaining the trailing slash
- 3
Fill in `projects.yml`, `experience.yml`, and `education.yml` in the `_data` directory
- 4
For project detail pages, create a new Markdown file in the `projects` directory and add the corresponding `page-name` in `projects.yml`
- 5
Local development requires installing Ruby and Bundler, then running `bundle install --path vendor/bundle` and `bundle exec jekyll serve`
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in a public repository; the free scope is the code of this version and does not imply that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this 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
- When deploying to GitHub Pages, only the user homepage form (username.github.io) is supported, not project subpaths (username.github.io/repo-name); for subpath hosting, use other methods such as Netlify.
- Local development or preview requires installing Ruby and Bundler yourself and running bundle install and jekyll serve; it is not purely static and ready to use out of the box.
- Demo images, fonts, icons, and other third-party assets need to be checked against their respective licenses; they cannot be judged solely based on the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
Use something like Netlify or GitHub Pages to deploy (note, this only works on username.github.io, not username.github.io/repo-name)
Original README
https://github.com/iamHrithikRaj/portfolio-website/blob/main/LICENSEhttps://github.com/iamHrithikRaj/portfolio-website/blob/main/README.mdMake sure to have Ruby and Bundler installed.
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-03. 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
- Partly documented · 73 / 100
- Technologies
- Jekyll
- Website type
- Portfolio · Blog
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
- 2021-08-21
- Screenshot last checked
- 2026-10-03
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 Jekyll 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: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: 340cb5031197c7c39523cac89289dca8f96b9420162116a5cc7aef2589dae8df
2026-10-03T23:26:17.437Z
Source file / repository# Portfolio Template
[](https://bug-busters-portfolio.netlify.app/)
## Make your own!
1. Use the Template button.
2. Update `_config.yml` to contain your information.
1. Change `url` to the URL you'll be hosting it at
2. Make sure it has the /
3. Use something like Netlify or GitHub Pages to deploy (note, this only works on username.github.io, not username.github.io/repo-name)
## Add your portfolio
Head to `_data` and fill out either `projects.yml`, `experience.yml` and `education.yml`.
Project example.
```yaml
- title: Machine Learning Project
event: MLH Fellowship Pre Fellowship - Batch 3.5
date: Fall 2020
```
Experience example.
```yaml
- role: Pre Fellowship Fellow
company: MLH Fellowship
dates: Summer 2021
logo: fellowship.svg
```
Education example.
```yaml
- course: Pre Fellowship Fellow
institute: MLH Fellowship
dates: Summer 2021
logo: fellowship.svg
```
## Add project posts
1. Make a new `.md` file inside of `projects`.
2. Add the header to your markdown file (see below) and change the title to the name of your blog post.
3. Write your project page! Can be a README from GitHub or your Devpost page.
4. Add the `page-name` field to your `projects.yml` (see below).
Top of post markdown file post.
```
---
title: Project
layout: page
---
```
`projects.yml` with the `page-name` field.
```yaml
- title: Machine Learning Project
event: MLH Fellowship Pre Fellowship - Batch 3.5
date: Summer 2021
page-name: project
```
## Development
If you want to test it locally or add some new features, run the below commands. Make sure to have Ruby and Bundler installed.
```
bundle install --path vendor/bundle
bundle exec jekyll serve
```
Explore similar templates
Compare previews and descriptions within the same stack and category.
al-folio
A Jekyll academic homepage theme for scholars and researchers, with a clean responsive design and out-of-the-box support for publication lists, project showcases, CVs, and blogs.
Jekyll · Portfolio
minimal-mistakes
Minimal Mistakes is a two-column Jekyll theme for personal sites, blogs, project documentation, or portfolios.
Jekyll · Portfolio
Beautiful Jekyll
Beautiful Jekyll is a mature, easy-to-use Jekyll blog theme maintained by Dean Attali since 2015, with over 50,000 users.
Jekyll · Blog
jekyll-TeXt-theme
A customizable Jekyll theme for personal sites, team sites, blogs, projects, and documentation.
Jekyll · Blog
startbootstrap-clean-blog-jekyll
The official Jekyll version of Start Bootstrap's Clean Blog theme, offering a blog home page, about page, contact page, and sample post pages, with a Formspree-powered contact form.
Jekyll · Blog
So Simple
A minimal reading-oriented Jekyll theme by Michael Rose for personal blogs, portfolios, and long-form reading. It offers multiple layouts, microformat markup, Disqus comments, Google Analytics, Jekyll SEO Tag, three skins, and aggregation by year, category, and tag with a grid view.
Jekyll · Blog