# 🎯 Focus Mode Banner — Obsidian Plugin

> ⚡ Vibe coded solution by [Adriano Fontanari](https://adrianofontanari.com)

A lightweight Obsidian plugin that helps you stay anchored to your current note. When Focus Mode is active, a bold warning banner appears every time you navigate away to a different note — a visual interruption to make you think twice before losing context.

---

## Why

You open a note with a clear intention. Then one link leads to another, and five minutes later you've forgotten what you were doing. Focus Mode Banner makes that drift visible and deliberate.

---

## How it works

1. Open the note you want to focus on
2. Toggle Focus Mode via the ribbon icon or command palette
3. Every time you open a different note, a high-visibility banner appears at the top of the editor
4. The banner auto-dismisses after 5 seconds (configurable), or close it manually with ✕
5. Toggle off when you're done

---

## Installation (manual)

1. Go to your vault's `.obsidian/plugins/` folder (create it if it doesn't exist)
2. Create a folder called `focus-mode-banner`
3. Copy these 3 files inside:
   - `main.js`
   - `manifest.json`
   - `styles.css`
4. Restart Obsidian
5. Go to **Settings → Community Plugins** and enable **Focus Mode Banner**

---

## Usage

| Method | Action |
|--------|--------|
| **Ribbon icon** (left sidebar) | Click the 🎯 icon to toggle |
| **Command palette** | `Ctrl/Cmd + P` → "Toggle Focus Mode" |

When active, the ribbon icon turns **red** as a persistent visual indicator.

---

## Settings

Navigate to **Settings → Focus Mode Banner** to configure:

| Setting | Description |
|---------|-------------|
| **Banner message** | Customize the text shown in the warning banner |
| **Auto-dismiss (seconds)** | How long before the banner disappears automatically. Set to `0` to disable auto-dismiss. |

---

## community-plugins.json entry

```json
{
  "id": "focus-mode-banner",
  "name": "Focus Mode Banner",
  "author": "Adriano Fontanari",
  "description": "Activates a Focus Mode: a bold banner appears every time you open a note different from the one where you started your focus session.",
  "repo": "adrianofontanari/obsidian-focus-mode-banner"
}
```

---

## Author

Made by [Adriano Fontanari](https://adrianofontanari.com) using Claude Sonnet 4.6 by Antrophic

---

## License

MIT