Jekyll static site generator with content written in Markdown
portfolio-site — Jekyll Portfolio Template
By cyanidesayonara
A personal portfolio site built with Jekyll and the Chirpy theme, featuring project showcases, a blog, and light/dark mode toggle, deployed on GitHub Pages.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Based on the Chirpy theme with custom modifications
Includes two content sections: project showcases and blog
Provides light/dark mode toggle and responsive layout
Hosted on GitHub Pages with a custom domain
Template Details
This is a personal portfolio website built with the Jekyll static site generator, using a customized version of the Chirpy theme. The site structure is divided into blog posts and project descriptions (_posts), main navigation pages (_tabs, including About, Categories, Tags, Archives), static assets (assets), and configuration and template files (_config.yml, _layouts, _includes). Content is written in Markdown; new posts must be named in the format YYYY-MM-DD-title.md and include front matter such as title, date, categories, tags, and images.
The site provides project showcases, a blog, light/dark mode toggle, and responsive layout. It is hosted on GitHub Pages with a custom domain and automatically deploys when pushed to the main branch. Local development requires Ruby and Bundler; after installing dependencies, you can start a local server with live reload using jekyll serve.
The code is MIT licensed and can be freely used, modified, commercialized, and distributed, but third-party assets such as demo images, fonts, and icons require separate license verification, and external services like domain and hosting may incur costs. The repository provides no additional information about performance or production suitability.
Is it right for your project?
Use Cases
- Building a personal portfolio and project showcase page
- Publishing technical articles and project update blog posts
- Maintaining content in Markdown and automatically deploying to GitHub Pages
Suitable For
- Individual developers who need a static portfolio website
- Users familiar with or willing to use Jekyll and Markdown
- Those planning to host on GitHub Pages and bind a custom domain
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Install Ruby and Bundler locally, then run bundle install to install dependencies
- 2
Run bundle exec jekyll serve --livereload to start the local server, accessible by default at localhost:4000
- 3
Add new posts in the _posts directory with filenames in the format YYYY-MM-DD-title.md, and fill in front matter such as title, date, categories, and tags
- 4
Push to the main branch for automatic deployment via GitHub Pages
- 5
Third-party images, fonts, and icons require separate license verification
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope applies to this version's code and does not imply that external services or third-party assets are free.
Must comply with when using
- The code of this version may be freely used, modified, commercialized, and distributed.
- 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 require separate license verification and cannot be judged solely by the code's MIT license.
- External services such as domain, hosting, database, payment, or AI may incur additional charges.
View Original Text Basis
https://github.com/cyanidesayonara/portfolio-site/blob/main/LICENSEhttps://github.com/cyanidesayonara/portfolio-site/blob/main/README.mdPermission is hereby granted, free of charge
Original License Text
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
- Partly documented · 74 / 100
- Technologies
- Jekyll
- 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
- 2025-04-08
- 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 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-13
Inspect the recorded source material
SHA-256: 9b72aea4ab65017402319b28b24a952e952d09d7503d75ace242b374cb701085
2026-10-13T01:53:04.952Z
Source file / repository# Portfolio Site My personal portfolio website built with Jekyll and the Chirpy theme. Visit at [santtu.fyi](https://santtu.fyi/). ## Features - Responsive design optimized for desktop and mobile browsing - Project showcase with detailed descriptions and images - Blog section with technical articles and project updates - Dark/light mode toggle - Clean, minimalist design focused on readability - Fast loading times and optimized performance ## Technologies - **Framework**: Jekyll static site generator - **Theme**: [Chirpy](https://github.com/cotes2020/jekyll-theme-chirpy) with custom modifications - **Hosting**: GitHub Pages with custom domain - **Languages**: HTML, CSS, JavaScript, Markdown - **Build Tools**: Ruby, Bundler ## Site Structure - `_posts/` - Blog posts and project descriptions - `_tabs/` - Main navigation pages (About, Categories, Tags, Archives) - `assets/` - Images, JavaScript, and CSS files - `_config.yml` - Site configuration - `_layouts/` and `_includes/` - Templates and reusable components ## Local Development 1. Install Ruby and Bundler: ```bash # On Windows with Chocolatey choco install ruby gem install bundler ``` 2. Clone the repository: ```bash git clone https://github.com/cyanidesayonara/portfolio-site.git cd portfolio-site ``` 3. Install dependencies: ```bash bundle install ``` 4. Start the local server with live reload: ```bash bundle exec jekyll serve --livereload ``` 5. Visit `http://localhost:4000/` in your browser ## Adding Content ### New Blog Post Create a new Markdown file in the `_posts` directory with the format `YYYY-MM-DD-title.md`: ```markdown --- title: "Your Post Title" date: YYYY-MM-DD categories: [Category] tags: [tag1, tag2] image: path: /assets/img/posts/image-name.png alt: Description of the image --- Your content here... ``` ## Deployment The site is automatically deployed to GitHub Pages when changes are pushed to the main branch. ## License This project is licensed under the MIT License - see the LICENSE file for details.
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

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

Jalpc
Jalpc is a Jekyll theme for a combined personal homepage and blog. The homepage is split into sections driven by YAML files under _data, so content changes usually do not require editing HTML.
Jekyll · Portfolio

feeling-responsive
A free responsive Jekyll theme built on the Foundation framework, suitable for company sites, portfolios, or blogs. It offers language support, six header styles, customizable navigation and footer, plus documentation and an online demo.
Jekyll · Portfolio
