> For the complete documentation index, see [llms.txt](https://cykadev.gitbook.io/rsspace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cykadev.gitbook.io/rsspace/navigating-the-ui.md).

# Navigating the UI

## Accessing the interface

There are two ways to access the user interface of the application. They are essentially both the same (with a few design differences), but they give you more flexibility on how you wish to manage RSSpace.

### Through the top-level page

When RSSpace is added to your Space organization, it enables what we call a "Top-level page". What that does is it creates a new tab that you can pin to your side navigation in order to access the user interface quickly (and in a bigger window than the [homepage extension tab](#undefined)).

In order to enable it, simply click on the three horizontal dots you can see below your control area in the top-left corner of your Space organization and enabling the RSSpace Dashboard toggle switch. Here's a little GIF to guide you:

<figure><img src="/files/yhE6gxD9tCXDeQ4gxyTm" alt=""><figcaption><p>How to enable the RSSpace Dashboard top level page</p></figcaption></figure>

Once that's done, you can access the RSSpace Dashboard from your side navigation bar.

<figure><img src="/files/b5PsocurhzD5udeQVp1b" alt=""><figcaption><p>RSSpace tab</p></figcaption></figure>

### Through the homepage extension tab

If you'd rather hide the colorful RSSpace logo from your navigation bar, you can also access the extension homepage through the Extensions page of your Space organization. To do so, simply follow the same instructions as the [top-level page](#through-the-top-level-page), but for the Extensions tab. Once that's done, you should be able to access the currently installed Space applications by clicking the newly enabled tab:

<figure><img src="/files/RfeF8CjdSpyirqkQUYUC" alt=""><figcaption><p>Installed applications page</p></figcaption></figure>

You probably know this already, but you should then click the RSSpace application to access the homepage of the application:

<figure><img src="/files/ZO5yx7k8tI2HbCGYTROn" alt=""><figcaption><p>Application homepage</p></figcaption></figure>

> It is probably more convenient for you to pin the RSSpace Dashboard tab! But if you just occasionally want to manage your subscriptions, customization options and bookmarks, this option is better to avoid cluttering your interface.

## Navigation

You can navigate between different sections of the application by clicking the tabs at the top.

<figure><img src="/files/Q1oCF3I4sU25OFFaOcy4" alt=""><figcaption><p>Currently available tabs</p></figcaption></figure>

## Feeds

The "Feeds" tab lets you access all your currently followed RSS feeds. You can add new ones or delete existing ones.

### Following a feed

To follow a new feed, simply press the blue "New feed" button at the top right of the interface. It will open the following modal:

<figure><img src="/files/yzmg20HL6ElvDwSKrJzu" alt=""><figcaption><p>RSS subscription modal</p></figcaption></figure>

You can then input your RSS feed URL. It will be validated, and if everything is in order, it'll automatically be added to your feeds grid!

You can also enable slow mode for this specific subscription by ticking the corresponding checkbox in the settings section. If you're not sure what that does, hover over the question mark next to it or read about it [here](/rsspace/frequently-asked-questions.md#what-is-slow-mode)!

Slow feeds will be displayed with a clock icon next to their name:

<figure><img src="/files/RZt6k9GziYoN1mXUmbNX" alt=""><figcaption><p>Example slow mode feed</p></figcaption></figure>

### Deleting a feed

Deleting a feed is as easy as following a new one. Simply hover over a feed card, and click the "Delete RSS feed" button that appears at the top right corner:

<figure><img src="/files/P0Zoz1hgReCT0pC5HeWm" alt=""><figcaption><p>Feed delete button example</p></figcaption></figure>

A confirmation modal will then appear to make sure you didn't click the button by mistake. If you validate it, the feed will be removed from your grid.

## Settings

The settings section allows you to tweak the user interface. For now there are few options available (theme, UI elements, tabs) but I am adding more customization options with each update.

### Theme

The theme of the application can be changed independently from the global Space theme.

**Please note: it seems like there is a bug with the "Auto" mode, where even in dark mode, Space will communicate that light mode is on. In that case, you should either set your Space theme to "Dark" (and not "Auto"), or you should set the RSSpace theme to "Dark".**

The theme options are the same as the ones you can find in Space:

<figure><img src="/files/mRqHPmv9aaXj2eLeqnaT" alt=""><figcaption><p>Theme options</p></figcaption></figure>

### UI elements & Tabs

Under the "Theme" section, you can find a section titled "UI elements", followed by another one called "Tabs". They allow you to toggle elements across the UI:

<figure><img src="/files/dA9QEPZtpY0BqSG9qA9Y" alt=""><figcaption><p>UI elements &#x26; Tabs</p></figcaption></figure>

Below is a list of all the currently customizable UI elements and tabs:

| Title                            | Description                                                                                                       |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Show statistics in the Feeds tab | Toggles the statistics area (subscriptions and scans) that can be found in the bottom left part of the Feeds tab. |
| Tabs - Customization             | Toggles the Customization tab in the top bar.                                                                     |
| Tabs - Bookmarks                 | Toggles the Bookmarks tab in the top bar.                                                                         |

Unlike the Theme options, it is necessary to press the "Save" button to make sure your settings persist. The tab bar will not be updated unless you press it.

## Customization

The customization tab lets you choose the pieces of information you want to see on your RSS feed notifications. Additionally, it allows you to set individual themes and special options for specific elements. Funky!

### Preview

On the right part of the Customization tab, you can see a live preview of what your RSS notifications look like. With a default configuration, it will look like this:

<figure><img src="/files/otR8hzHcVP6VbFO4PlqK" alt=""><figcaption><p>Preview of a default configuration</p></figcaption></figure>

### Parameters

The checkboxes on the left will let you customize this appearance, by adding, removing or customizing specific items:

<figure><img src="/files/5cuRogb7aDYU17jF58sS" alt=""><figcaption><p>Customizable items</p></figcaption></figure>

Below are the currently available customization options:

| Name             | Description                                                                                                                       |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Outline          | Groups both "Feed name" and "Icon".                                                                                               |
| Feed name        | Show the name of the RSS feed at the top of the notification.                                                                     |
| Icon             | Show an icon of your choice next to the feed name.                                                                                |
| Title            | Displays the title of the RSS feed item above the content preview.                                                                |
| Clickable title  | Only available if "Title" is checked. Makes the title blue and clickable.                                                         |
| Content preview  | Lets you read a snippet of the RSS item's content. Its maximum length will eventually be customizable.                            |
| Image preview    | Only available if "Content preview" is checked. Shows a preview of the metadata image linked to the RSS feed's link on the right. |
| Buttons          | Groups both "Read more button" and "Bookmark button".                                                                             |
| Read more button | Displays a blue button opening a tab to the RSS feed item's link.                                                                 |
| Bookmark button  | Displays an outlined button to save the RSS item's link in your RSSpace bookmarks.                                                |
| Date             | Shows the publication date of the item at the bottom of the notification.                                                         |
| Theme            | Changes the global theme of the notification, changing the icon and left border color.                                            |

Below is the list of customizable theming per toggleable element:

| Name                   | Description                                               | Possible values                                                                                                                               |
| ---------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Icon                   | Changes the icon that is displayed next to the feed name. | A lot. There's an icon picker.![](/files/whAFJaYD3YLWiFR63I0d)                                                                                |
| Content preview length | Changes the maximum length of the content preview.        | <ul><li>Raw (no limit)</li><li>Short (100 characters)</li><li>Medium (200 characters)</li><li>Long (300 characters)</li></ul>                 |
| Read more button theme | Changes the color of the "Read more" button.              | <ul><li>Primary</li><li>Regular</li><li>Danger</li><li>Secondary</li></ul>                                                                    |
| Bookmark button theme  | Changes the color of the "Bookmark" button.               | <ul><li>Primary</li><li>Regular</li><li>Danger</li><li>Secondary</li></ul>                                                                    |
| Date format            | Changes the format of the footer date.                    | <ul><li>Short (11/20/22, 11:35 PM)</li><li>Medium (Nov 20, 2022, 11:35:34 PM)</li><li>Long (November 20, 2022 at 11:35:34 PM GMT+1)</li></ul> |

Simply press the "Save" button to save your configuration, and all your next RSS notifications should follow your custom layout!

## Bookmarks

Since version 1.1.0 of RSSpace, you can save specific RSS items in your bookmarks. To do so, simply click the "Bookmark" button on any notification (make sure not to disable that button!):

<figure><img src="/files/EjQp6Wz7xROMQvsruT1d" alt=""><figcaption><p>RSS notification with a Bookmark button</p></figcaption></figure>

The chatbot will then tell you that the bookmark has been saved. You can now access it in the Bookmarks tab:

<figure><img src="/files/frVGsZaFsNN2eYtft20T" alt=""><figcaption><p>Example bookmarks in the Bookmarks tab</p></figcaption></figure>

This tab contains all your saved bookmarks. You simply have to click the title of the item to open a new tab in your browser directly at the link of the RSS item! A real time saver.

You can delete a bookmark by clicking the "X" icon at the right. In order to make sure you didn't make a mistake, you will be prompted to confirm the deletion of the item.

> If you don't want to see the modal every time you're deleting a bookmark, simply press the "X" icon while pressing Shift on your keyboard! It will skip the verification process.

## Reporting a bug

Since version 1.1.0 of RSSpace, you can report bugs directly from the user interface of the application. To do so, simply click the "Bug report" button in the footer of the application:

<figure><img src="/files/3pQtvoQ2fpBvzEo3vwuW" alt=""><figcaption><p>Footer links</p></figcaption></figure>

You will then access the bug report form:

<figure><img src="/files/Q6kAetNCccJiqQQ996pC" alt=""><figcaption><p>Bug report form</p></figcaption></figure>

Simply fill in the required information, press send, and you're good to go! Thank you for your service.

## What's next?

I will keep adding more customization options and useful RSS-related features to help you supercharge your experience.&#x20;