Getting Started with Jekyll

Jekyll is a great way to create static sites on NorthStack. Instead of using databases and dynamic code that renders server-side, Jekyll allows you to generate static files for your entire site. In this article, we'll show you how to create and deploy a new Jekyll app on NorthStack.


Creating a New Jekyll App

Creating a new Jekyll app is easy with NorthStack. In this section, we'll show you how to create a new app on NorthStack and configure Jekyll.

  1. Begin by opening a new Terminal window.
  2. Next, create a new static app in NorthStack by running the following NorthStack CLI command:
   northstack app:create JekyllExample --stack=static
  1. Now that your app is created, access the location of your newly created NorthStack app:
   cd JekyllExample
  1. From inside your app, run the following to create a new Jekyll app within the app directory:
   jekyll new app --force

Building Your Jekyll App

If you followed along in the previous section, you should now have a new NorthStack app with a Jekyll configuration installed inside the app directory. Here's how to build it:

While inside your NorthStack app, run the following command:

jekyll build -s ./app -d ./app/public

Deploying Your Jekyll App

Deploying a Jekyll app is the same as deploying any other app on NorthStack. To deploy your Jekyll app, run the following command:

northstack app:deploy "My Deploy Message" JekyllExample dev

Your Jekyll app has now been deployed!