Skip to content

2. Setup

Christian Medel edited this page Apr 10, 2022 · 1 revision

Setting up the Azurra framework

Disclaimer: this tutorial requires some experience using the Linux terminal.

This tutorial will guide you to get started using the Azurra framework, a tool to create, maintain and deploy GTK 3 themes using open-source software. Make shure to meet the requirements before starting development.

To easily follow this tutorial, experience with the following technologies is recommended:

  • bash
  • CSS 3
  • SASS
  • SVGs
  • git, if you plan on deploying your theme to an online repository

Let's get started:

  1. To install the framework locally, clone the upstream repository by running git clone https://github.com/B00merang-Project/Azurra_framework
  2. Enter the work directory by running cd Azurra_framework. This is the root directory and all scripts and tools start here. This is also where themes should be placed (unless placed inside a bundle, more on that later).
  3. The vanilla version you just downloaded includes a new theme, named example. Not very original. Let's change that by renaming it to 'TestTheme'.

That was easy! Let's continue by editing the new theme's configuration.