Link Search Menu Expand Document

Deploy your story map as a web page

Now that your story map is finished, it is time to deploy it as a web page. For that we will use GitHub pages.

GitHub Pages is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository on GitHub, optionally runs the files through a build process, and publishes a website.

To publish your map as a web page follow this steps:

Step 1

Go to GitHub cloud and sign in to your account.

You can click on the View on GitHub button on your GitHub Desktop app to open the repository on your browser.

Open on GitHub screenshot

Step 2

On your repository, click on the Settings button on the top menu bar.

Open on GitHub screenshot

Step 3

If you did not before, you will have to make your repository public in order to use GitHub pages.

Simply click on the General button on the panel on the left.

Open on GitHub screenshot

Scroll down to the bottom of the page and click on Change visibility and then on Change to public.

Open on GitHub screenshot

Confirm that you want to make the repository public.

Open on GitHub screenshot

You might be asked to enter your account password to confirm.

Step 4

On the repository Settings, click on the Pages button on the left panel options.

Open on GitHub screenshot

Step 5

On the Pages settings, click on the dropdown menu under the title Branch and select the main bramch option.

Open on GitHub screenshot

Then click on Save. A message like the one below will appear on the screen.

Open on GitHub screenshot

Step 6

Wait a couple some seconds and the refresh the page.

A new section will appear on the Pages settings window with the details of your deployed page.

Click on the Visit site button to open the story map on a new browser window.

Open on GitHub screenshot

Everytime you change something on your config.js file or add anything to your repository, GitHub pages will built the rendering files and deploy the new version of your map. The only thing you have to do is commit your changes and push the changes to the cloud if you are using GitHub desktop.

Open on GitHub screenshot