# Thulur User Guideline

This document explains how to use the Thulur desktop application from a user perspective. Each section below is based on real application screens stored in `docs/screens/`.

## 1. Sign In

The login screen is the starting point of the application.

![Sign in screen](screens/login-sign-in.png)

### What to do

1. Enter your email address in the `Email` field.
2. Click `Continue with Passkey`.
3. The app opens your default browser so you can complete passkey verification using biometrics or a hardware security key.
4. After successful verification, return to the desktop app to continue.

### Validation behavior

- If the email format is invalid, the email field is highlighted in red.
- The red validation state remains visible until the email is corrected.
- If you try to continue with an empty or invalid email field, the app asks you to enter your email before the browser step starts.

### Important note

- The passkey step is completed in the browser, not inside the desktop window.
- If no passkey is registered for this email yet, the browser flow may continue with passkey registration before you return to the app.

## 2. Daily Feed

After sign-in, the app opens the Daily Feed screen.

![Daily Feed screen](screens/daily-feed.png)

### What you can do here

- Review the feed for the currently selected day.
- Use the date controls at the top to move between available days.
- Switch between `Topics & Articles` and `Topics Only` depending on how much detail you want to see.
- Read each topic summary first, then inspect the linked articles below it.
- Click `Show Thread` to open a focused view for that topic.
- Open `Settings` from the gear icon in the top-right corner.

### How the feed is structured

- Each topic is shown as a separate block with a title and a short summary.
- Article cards below the summary show the source, publish time, title and summary text.
- In `Topics & Articles` mode, both the topic summary and the related articles are visible.
- In `Topics Only` mode, the screen focuses on the topic-level summaries.

## 3. Thread View

The thread view opens when you choose `Show Thread` from the Daily Feed.

![Thread view](screens/show-thread.png)

### What this screen is for

- It shows one topic in isolation.
- It lets you open the thread chat.
- It lets you focus on the thread summary and its related article list without the rest of the feed around it.

### What you can do here

- Use `Back` to return to the Daily Feed.
- Review the summary for the selected day shown under the thread title.
- Open the linked article card for more detail.
- Use the left and right arrows at the bottom to move through available days for the same thread.
- Click `Discuss Thread` to open chat for this specific topic.

## 4. Chat

The chat screen lets you ask follow-up questions about the feed or a selected thread.

![Chat screen](screens/chat.png)

### What you can do here

- Type your question in the `Ask Chatbot` field at the bottom.
- Send a message to get a summary, clarification, or follow-up explanation.
- Read the conversation as alternating user and assistant messages.
- Use `Back` to return to the feed.

### Typical usage

- Ask for a simpler explanation of a topic.
- Ask what happened on a selected day.
- Ask for more detail about a specific feed or thread.

### Important note

- Chat can be used as a follow-up tool after reviewing the daily feed or opening a thread.

## 5. Settings: Account & App

The `Account & App` section contains your account information and general app preferences.

![Settings - Account and App](screens/settings-account&app.png)

### Account area

- View the email address currently signed in.
- Review active sessions associated with the account.
- Use `Terminate` to end a listed session.

### App preferences

- `Feed Schedule`: choose the time when the feed should be ready.
- `Theme`: switch the app appearance.
- `Language`: choose the language used for the next generated feed.
- `Suggestions Outside`: turn on or off suggestions outside the scheduled feed cycle.

### Important note

- Changes to feed generation, suggestions and language settings may apply to the next generated feed rather than the feed that already exists for today.

## 6. Settings: Feeds

The `Feeds` section is where you manage followed sources and add new ones.

![Settings - Feeds](screens/settings-feeds.png)

### What you can do here

- Review the list of feeds you already follow.
- Click `Unfollow` to remove a source from your feed list.
- Add and follow a new feed using the `RSS Link or source/topic` field.
- Browse available feeds below and click `Follow` to subscribe.

### How to use it

1. Open `Settings`.
2. Select `Feeds` in the left-side navigation.
3. To remove a source, click `Unfollow` next to it.
4. To add a new source, paste an RSS link or enter a source/topic in the input field.
5. To subscribe from the suggested list, click `Follow`.

### Important note

- Newly followed feeds are intended to appear in your next daily feed.
