# Themes

{% hint style="danger" %}
You must have some knowledge of Html and CSS to create a theme.
{% endhint %}

## Step 1 - Creating the workspace

First of all, you need to be in the themes folder.

```
$ cd themes
```

To clone the correct folder we need to install subversion to allow svn to work.

```
apt-get install subversion
```

Now that we've got svn ready we can clone the default themes's files

```
$ svn export https://github.com/real2two/dashactyl/trunk/themes/default/ <YourThemeName>
```

You'll also need to do the same with the stylesheet.

Firsty, we need to go in the correct directory.

```
$ cd ../assets
```

As we've got svn ready already we can clone the default theme's css file.

```
$ svn export https://github.com/real2two/dashactyl/trunk/assets/default <YourThemeName>
```

## Step 2 Creating The Theme

Now that you've got your workspace ready, you can start making your own theme.

To change the CSS you can go in \`/assets/\<YourThemeName>/style.css\`

And to change the page contents you can edit the files in \`/themes/\<YourThemeName>/\<File.ejs>\`

## Step 3 - Configuring The Theme

To finish creating your theme you need to change the settings.json file to use the new theme's files. To change this visit the Configuration Page and scroll down to Section 1 and set the default theme to the name of the folder of the theme you made in step 1 in settings.json.

## Step 4 - Finishing Up

Now that you've followed the other steps you should be done. To see the new theme's affect you must restart Dashactyl by typing the following command:

```
forever restart index.js
```

{% hint style="warning" %}
You must be in the Dashactyl folder to restart the dashboard.
{% endhint %}

{% content-ref url="configuration" %}
[configuration](https://josh0086.gitbook.io/dashactyl/installation/configuration)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://josh0086.gitbook.io/dashactyl/installation/themes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.