gatsby-starter-minimal-portfolio

Prerequisite

• Computer (Windows or Linux based OS)
• Node
• Yarn
• Git
• GitHub Account for deploying to GitHub Pages

Create and run a new project

• Create a new project from gatsby-starter-minimal-portfolio.

  gatsby new your-github-username.github.io dotnetthailand/gatsby-starter-minimal-portfolio

• CD to your project folder.

  cd your-github-username.github.io

• Run your project.

  cd your-github-username.github.io

• Open a browser and navigate to http://localhost:8000.
• You will find your minimal-portfolio in a browser.

Customize your portfolio

• Edit content of SiteConfig.js to your profile information.
• Add a new Markdown file in content folder and put your activity's details into it.
• Edit data/projects.yml to your interesting projects.
• Edit content of src/pages/contact.tsx to your contact information (We use Gatsby theme shadowing).

Deploy to GitHub Pages

• Create an empty repository with a name as your-github-username.github.io.
• Set a new GitHub Secret with the following key and value:
  • New PUBLIC_REPO_ACCESS_TOKEN key and set a value to a GitHub personal access token with the "public_repo" scope.
• Push this project source to your GitHub repository with the following command.

  git remote set-url origin git@github.com:your-github-username/your-github-username.github.io.git
  git push -u origin main

• Wait until GitHub Actions deployment has finished.
• Go to GitHub Pages settings of your repository and set a deployment branch to gh-pages. Then click Save button.
• Open a browser and navigate to https://your-github-username.github.io.
• You will find your minimal portfolio website in a browser.
• Later, when you edit source code, you just commit your changes and push theme to GitHub again and a project will be deployed to GitHub Pages automatically.

upgrade --latest https://classic.yarnpkg.com/en/docs/dependency-versions#toc-semantic-versioning

$ yarn upgrade @dotnetthailand/gatsby-theme-minimal-portfolio --latest