# Progressive

**Progressive** is an Obsidian plugin that displays a progress bar in the file explorer sidebar, showing the percentage of tasks that have been completed across your notes.  
It supports daily, weekly, monthly, or custom notes and can track either the latest, today’s, or all notes in a folder.  
The progress bar color dynamically changes based on completion percentage for quick visual feedback.

---

## Difference from *progress-tracker*

While both *Progressive* and *progress-tracker* help visualize task completion, **Progressive** is a different approach:

| Feature | Progressive | progress-tracker |
|----------|--------------|------------------|
| **Display Location** | Sidebar (always visible in file explorer) | Inside individual notes |
| **Purpose** | Passive overview of total progress | Per-note task tracking |
| **Setup** | Automatic, no embedding or commands required | Manual embedding (inline in notes) |
| **Customization** | Theme-aware, multicolor, black/white modes | Fixed color and layout |
| **Focus** | Minimalism, zero interaction needed | Detailed tracking inside notes |

In short, **Progressive** gives you *a global visual cue* of how complete your workspace is without needing to open a single note.

---

## Features

- Shows a progress bar in the **sidebar**, always visible.  
- Supports **daily**, **weekly**, **monthly**, and **custom** note types.  
- Tracking modes: **latest note**, **today’s note**, **all notes in a folder** or a **custom note**.
- Progress bar color changes through 12 levels depending on completion, but also features Black and White and themed based visuals.
- Works with both **single notes and entire folders**.  
- Automatically updates when notes are modified.  

---

## How to use

1. Go to **Settings → Progressive**.  
2. Choose a note or folder to track. 
3. Select the note type (**Daily**, **Weekly**, **Monthly**, or **Custom**).  
4. Choose a tracking mode:
   - **Latest** → only the most recently modified note
   - **Today** → today’s note (or this week/month if selected)
   - **All** → all notes inside the selected folder
5. The progress bar will appear automatically in your sidebar.

---

## Manual installation

To install manually, copy the following files into your vault:

```
VaultFolder/.obsidian/plugins/progressive/
```

Files required:
```
main.js
styles.css
manifest.json
```

Then reload Obsidian and enable **Progressive** from the Community Plugins tab.

---

## Funding & Feedback

If you like **Progressive**, you can support its development by:
- Giving feedback on GitHub
- Reporting bugs or feature requests
- Sharing it with others in the Obsidian community
- Funding : If you really want to donate, give money to a charity

---

## Documentation

For the latest Progressive documentation and updates, visit:  
[https://github.com/kelen-argosi/progressive](https://github.com/kelen-argosi/progressive)