Skip to content
Create a personal website that showcases your work as a software developer.
Branch: master
Clone or download
Latest commit a9c983a Jun 25, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github chore: creating funding.yml May 28, 2019
demo feat: Add disqus support (#11) May 31, 2019
packages v0.1.11 Jun 25, 2019
.gitignore feat: init May 28, 2019
.prettierrc feat: init May 28, 2019 v0.1.11 Jun 25, 2019
circle.yml feat: init May 28, 2019
lerna.json v0.1.11 Jun 25, 2019
package.json chore(deps-dev): bump eslint-config-prettier from 4.3.0 to 5.0.0 (#28) Jun 18, 2019
yarn.lock chore(deps-dev): bump prettier from 1.17.1 to 1.18.2 (#21) Jun 25, 2019



Create Portfolio helps you kickstart a personal website that showcases your work as a software developer. It will automatically render a webpage with the owner's profile information, including a photo, bio, and repositories.

Your personal website is waiting to be personalized, though. It includes space to highlight your specific areas of interest in software development, like languages or industries. And it's standing by to publish your next great blog post.

It's all possible using the combination of Saber (for building your website), and GitHub's API (for automatically populating your website with content).


You need Node.js installed on your machine.

Quick Start

Create a new project with a single command:

npx create-portfolio my-site
# OR Yarn
yarn create portfolio my-site

Alternatively, you can install create-portfolio globally:

npm i -g create-portfolio
create-portfolio my-site

Change into your new directory:

cd my-site

Install dependencies:

npm install

Run the website locally:

npm run dev

Now browse to http://localhost:3000 you should see your page.

Build for Production

Run npm run build to create a production build of your app, generated files can be found at ./public folder, then it can be deployed as a static website.

Creating a Post

Check out the example post.

Adding a Social Media Cover Photo

By default, all posts will use your GitHub profile picture when embedded on social media. Should you wish to use a different image you can add under assets.cover:

title: My First Post
layout: post
date: 2019-05-26 20:23:00
  cover: @/images/cover.png
  - life

Site Configuration

Use siteConfig option in saber-config.js for site configuration.

Site Title

It defaults to your GitHub name, you can customize it in saber-config.js:

module.exports = {
  siteConfig: {
    title: 'A Custom Title'

Site Description

It defaults to your GitHub bio, you can customize it in saber-config.js:

module.exports = {
  siteConfig: {
    description: 'Introduce yourself...'

Theme Configuration

Use themeConfig option in saber-config.js for theme configuration.


By default we fetch your top 6 starred repositories from GitHub, if set to pinned-project, it will use pinned repositories instead:

module.exports = {
  themeConfig: {
    projects: 'pinned-repos'


By default it uses dark style:

module.exports = {
  themeConfig: {
    style: 'dark'

Available styles:

  • dark
  • light


This is required, we fetch data for this user.

module.exports = {
  themeConfig: {
    // Your GitHub Username
    github: 'egoist'


Show the link to your Twitter profile.

module.exports = {
  themeConfig: {
    // Twitter handle
    twitter: '_egoistlily'


Add a Sponsor button:

module.exports = {
  themeConfig: {
    // Link to the donation page
    sponsorLink: '',
    // The tip to show when you hover the sponsor button
    sponsorTip: 'Support me'


Showcase your skills:

module.exports = {
  themeConfig: {
    skills: [
        topic: 'nodejs',
        description: `I'm a Node.js core contributor`,
        // `image` is optional, by default we load from GitHub
        image: 'https://...'

The topic should be a valid GitHub topic, if the topic doesn't have a image by default on GitHub, you need to provide one yourself.

You can check if the image exists by visiting{topic} (replace {topic} with actual topic).


You can use Disqus for comments:

  disqus: disqus-short-name

# Note that `siteConfig.url` is required for Disqus

Comments are only enabled for post layout, to disable comments in specific page, you can use the page attribute comments:

title: Hello
layout: post
date: 2018-08-12
comments: false

Hello World!



You can’t perform that action at this time.