Preview the website locally

Before you publish the changes to the live site, you can preview the website locally on your machine to review the changes you made.

Assuming you are in the VS code terminal and in the root directory of the cloned repository, you can run the following commands to start a local preview server.

  1. Open the terminal in VS Code. You can select ‘Terminal’ > ‘New Terminal’ from the top navigation bar (you can also use the shortcut Ctrl+`).

    Annotated steps to open Terminal in VS Code

  2. Run the following command to install the required dependencies and start the Jekyll server with live reload enabled:

     bundle install && bundle exec jekyll serve --livereload
    

    Bundle Install and Jekyll Serve in PowerShell inside VS Code

    Once you see the following message in the terminal, you may access the preview pages in your preferred web browser via http://127.0.0.1:4000 (or whatever address the terminal shows after the Server address line)

     ...
     You can add fiddle to your Gemfile or gemspec to silence this warning.
     LiveReload address: http://127.0.0.1:35729
         Server address: http://127.0.0.1:4000
     Server running... press ctrl-c to stop.
    

    A preview of the website in the web browser and the VS code editing window side by side

  3. To stop the preview server, you can go back to the terminal (click on the terminal window in VS Code) and press Ctrl+C to stop the server. If you asked to ‘Terminate batch job (Y/N)?’, type ‘Y’ and press Enter (two times) to confirm stopping the server.

    Terminate Preview Server in PowerShell

Next Steps

After previewing the website and ensuring the changes look good, you can follow the instructions in the Publish the changes to GitHub guide to publish the changes to GitHub and make the changes live on the website.


First created: February 12, 2026
Last updated: March 03, 2026

Tutorial maintained by Ken Lui.

Tutorial created by Ken Lui.

Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International icon