Skip to main content

An step by step example

In this example, I will create a root site for my user deployed to https://tjaart.pages.grit.ucsb.edu

Create a repository

To create a repository, click on the + icon at the top bar, and select "New project repository"

screenshot-2026-02-05-093024.png

On the next screen select "Create from Template"

screenshot-2026-02-05-093042.png

Click "Use Template" on the "Pages/Plain HTML"

screenshot-2026-02-05-093057.png

On the next page, you will enter the repository name. This needs to be your_netid.pages.grit.ucsb.edu for our example, it will be tjaart.pages.grit.ucsb.edu.
Under Project URL, you can select your username.
The project slug should be prefilled to be the same as the project name.
You can set any visibility level. Once done, click Create Project

screenshot-2026-02-05-093136.png

Edit the content

With the repository created, you can use any Git tools to modify the files in the public/ directory, and push the changes to the master branch. If you are not familiar with Git, the easiest way to get started is to use the built in Web IDE.

To open the Web IDE, inside your repository, click on the "Code" button, and then Click on the Web IDE "."

screenshot-2026-02-05-093238.png

Inside the Web IDE, you will be able to edit all the files in the repository. Files in the public/ directory, gets served as the website.

screenshot-2026-02-05-093829.png

Once you are done making changes, you need to commit the changes to the master branch.
First select the branch icon, and then click "Commit and push to 'master'"

screenshot-2026-02-05-093956.png

You will get the following warning message, click Continuescreenshot-2026-02-05-090810.png

Deploy the Pages

Once you committed your changes, a Gitlab runner, will deploy your website, this can take some time, depending on the size of your webisite, and runner availability. To check on the progress, you can go to Build|Pipelines in your project.

screenshot-2026-02-05-090824.png

Once the deployment is successfully completed, you can see configure your page by going to Deploy|Pages. On this page you can also configure any custom domains.

screenshot-2026-02-05-093352.png

You should be able to get to your website, by following the link

screenshot-2026-02-05-094134.png