Gitfolio will help you get started with a portfolio website where you could showcase your work + a blog that will help you spread your ideas into real world.
Check out this live demo to see gitfolio in action.
Install gitfolio
➜ ~ git clone https://github.com/k4ustu3h/gitfolio.git
➜ ~ cd gitfolio
➜ ~ npm install -gUsing the UI
➜ ~ gitfolio uiTip: You can use ui for updating your gitfolio too.
or
➜ ~ gitfolio build <username><username> is your username on github. This will build your website using your GitHub username and put it in the /dist folder.
To run your website use run command, Default port is 3000
➜ ~ gitfolio run -p [port]🎉 Congrats, you just made yourself a personal website!
To include forks on your personal website just provide -f or --fork argument while building
➜ ~ gitfolio build <username> -fTo sort repos provide --sort [sortBy] argument while building. Where [sortBy] can be star, created, updated, pushed,full_name. Default: created
➜ ~ gitfolio build <username> --sort starTo order the sorted repos provide --order [orderBy] argument while building. Where [orderBy] can be asc or desc. Default: asc
➜ ~ gitfolio build <username> --sort star --order descThemes are specified using the --theme [theme-name] flag when running the build command. The available themes are
lightdark
TODO: Add more themes
For example, the following command will build the website with the dark theme
➜ ~ gitfolio build <username> --theme darkTo customize the background image just provide --background [url] argument while building.
➜ ~ gitfolio build <username> --background https://images.unsplash.com/photo-1557277770-baf0ca74f908?w=1634You could also add in your custom CSS inside index.css to give it a more personal feel.
You can either use your GitHub profile picture or you can add your initials in an animated gradient. Just provide -i or --initials argument while building.
➜ ~ gitfolio build <username> --initials K_gitfolio supports adding the following Social links
- Codepen
-c, --codepen <username> - Dev.to
-d, --dev <username> - Dribbble
-D, --dribbble <username> - Email
-e, --email <email> - Facebook
-F, --facebook <username> - Gravatar
-g, --gravatar <username> - Instagram
-I, --instagram <username> - Keybase
-k, --keybase <username> - Medium
-m, --medium <username> - Pinterest
-p, --pinterest <username> - Pinterest Domain verification key (meta name="p:domain_verify" content="specify the key inside this")
-P, --pinterest_key <key> - Reddit
-r, --reddit <username> - Stack Exchange
-E, --stackexchange <user id> - Steam
-S, --steam <username> - Telegram
-T, --telegram <username> - Twitter
-w, --twitter <username> - XDA Developers
-x, --xda <user id> - YouTube
-y, --youtube <channel id>
➜ ~ gitfolio build <username> --twitter <twitter_username> --dribbble <dribbble_username>Head over to GitHub and create a new repository named username.github.io, where username is your username. Push the files inside/dist folder to repo you just created.
Go To username.github.io your site should be up!!
To update your info, simply run
➜ ~ gitfolio updateor use the Update options in gitfolio's UI
This will update your info and your repository info.
To Update background or theme you need to run build command again.
- Hat tip to anyone who's code was used
- The original gitfolio made by @imfunniee
