imfunniee/gitfolio

★ 6,781JavaScriptAudience · developerComplexity · 1/5Setup · easy

Mindmap

mindmap
  root((gitfolio))
    What it does
      Portfolio generator
      Blog support
      GitHub Pages output
    Customization
      Light and dark theme
      Sort repos by stars
      Custom background
      Social media links
    Output
      Repo cards
      Blog post cards
      Static HTML site
    Setup
      npm global install
      Node.js required
      Browser UI included

mindmap root((gitfolio)) What it does Portfolio generator Blog support GitHub Pages output Customization Light and dark theme Sort repos by stars Custom background Social media links Output Repo cards Blog post cards Static HTML site Setup npm global install Node.js required Browser UI included

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Generate a personal portfolio website from your GitHub repos and publish it free on GitHub Pages with one command.

USE CASE 2

Add a blog to your developer portfolio by writing and publishing posts through the included browser UI.

USE CASE 3

Customize your portfolio with dark or light themes, custom background images, and repos sorted by stars or date.

Tech stack

JavaScriptNode.jsnpm

Getting it running

Difficulty · easy Time to first run · 5min

Archived project, no new features or bug fixes are expected, version 2 is planned but not yet released.

In plain English

Gitfolio is a command-line tool that generates a personal website and blog for any GitHub user. You give it your GitHub username and it pulls your repository list from GitHub, then builds a static website displaying your projects as cards. The output goes into a folder on your computer that you can then push to GitHub Pages to publish it for free at the standard GitHub Pages URL for your account. The tool is installed as a global npm package and can be run from the terminal or through a simple browser-based UI. The UI is helpful for two things in particular: creating blog posts and triggering updates to your site when your GitHub profile changes. Blog posts are written through the UI and saved as files inside the output folder. Each post gets a card on the homepage that links to the full post. Customization options are set as flags when running the build command. You can choose between a light and dark theme, provide a custom background image URL, sort your repositories by star count, creation date, or update date, and include or exclude forked repositories. Social media links for Twitter, LinkedIn, Medium, and Dribbble can also be added. Further visual changes are possible by editing the generated CSS file directly. The README notes that this version is archived in anticipation of a version 2 release, so active development on it has stopped. It still works as documented, but no new features or bug fixes are expected on this branch. The project requires Node.js and npm to install and run.

Copy-paste prompts

Prompt 1

Run gitfolio to generate a portfolio site for my GitHub username with a dark theme and repos sorted by star count.

Prompt 2

How do I create a new blog post with gitfolio and publish it to my GitHub Pages portfolio site?

Prompt 3

Walk me through deploying a gitfolio-generated site to GitHub Pages from the command line step by step.

Prompt 4

Customize the gitfolio output CSS to change the card colors and font on my generated portfolio site.

Open on GitHub → Explain another repo

← imfunniee on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.