⏳ Fading Days

Fading Days is a minimalist browser extension for Chrome and Firefox that makes you aware of the passage of time by counting down to key moments in your life — retirement, milestones, or any date that matters to you.

It calculates not just the remaining days, but also the number of weekends, Christmas Eves, Easter Sundays, and summer vacations left until your target date.

---

✨ Features

• Multiple countdown targets — Set a primary goal (e.g., retirement) and additional targets (e.g., mortgage payoff, 40th birthday). Switch between them with navigation arrows.

• Rich metrics — For each target, see:

  • Total remaining days
  • Remaining weekends (full Saturday + Sunday pairs)
  • Remaining Christmas Eves (December 24)
  • Remaining Easter Sundays (computed via the Gauss algorithm)
  • Remaining summer vacations (July 1)

• Life progress bar — Optionally enter your date of birth to see a fading progress bar showing how much of your life (relative to the target) has already passed.

• Cloud sync — All settings are stored via chrome.storage.sync, so your data follows you across devices logged into the same browser account.

• Multi-language support — Available in 7 languages:

  • 🇬🇧 English
  • 🇵🇱 Polski (Polish)
  • 🇩🇪 Deutsch (German)
  • 🇪🇸 Español (Spanish)
  • 🇫🇷 Français (French)
  • 🇰🇷 한국어 (Korean)
  • 🇨🇳 中文 (Chinese)

  Language can be changed at any time in the extension's settings page. The extension name and description are also translated natively via Chrome's _locales system for better discoverability in Chrome Web Store.

• Dark, minimal design — A somber, thoughtful aesthetic with a deep dark background, muted copper accent color, monospace number fonts, and smooth fade-in animations.

---

📸 UI Overview

Popup (main window)

When you click the extension icon, you see:

1. Header — Current target name with navigation arrows (if multiple targets exist).
2. Main counter — Large, prominent number of remaining days in accent color.
3. Life progress bar — Subtle fading bar (visible only if birth date is set).
4. Metrics grid — 2×2 grid showing weekends, Christmas Eves, Easters, and vacations.
5. Settings button — Gear icon in the footer leading to the options page.

Options page

A full-page settings interface where you can:

• Select your preferred language (7 languages available).
• Enter your date of birth (optional, for the life progress bar).
• Manage target dates — add, edit, rename, or delete countdown targets.
• Links to GitHub repository and Buy Me a Coffee in the footer.

---

🛠️ Technical Details

Property	Value
Platform	Chromium (Chrome, Edge, Opera, Brave, Vivaldi) + Firefox 109+
Manifest	V3
Permissions	storage only
Storage	chrome.storage.sync
Build tools	None required (vanilla JS), optional build.sh for packaging
External deps	Google Fonts (Inter, JetBrains Mono) loaded via CSS

Project Structure

FadingDays/
├── manifest.json              # Extension manifest (MV3, Chrome + Firefox)
├── build.sh                   # Build script for distribution packages
├── README.md                  # This file
├── _locales/                  # Browser native i18n (Store name/description)
│   ├── en/messages.json
│   ├── pl/messages.json
│   ├── de/messages.json
│   ├── es/messages.json
│   ├── fr/messages.json
│   ├── ko/messages.json
│   └── zh/messages.json
├── assets/
│   └── icons/                 # Extension icons (16, 32, 48, 128 px)
│       ├── icon16.png
│       ├── icon32.png
│       ├── icon48.png
│       └── icon128.png
└── src/
    ├── core/                  # Shared modules
    │   ├── calculations.js    # Countdown engine (days, weekends, holidays)
    │   ├── i18n.js            # UI internationalization (7 languages)
    │   └── storage.js         # chrome.storage.sync wrapper
    ├── popup/                 # Popup UI (shown on icon click)
    │   ├── popup.html
    │   ├── popup.css
    │   └── popup.js
    └── options/               # Full-page settings
        ├── options.html
        ├── options.css
        └── options.js

Key Algorithms

• Easter date calculation — Uses the Gauss Easter algorithm to compute the movable date of Easter Sunday for any given year.
• Weekend counting — Iterates from the current date, advancing to the nearest Saturday, then counts complete Saturday–Sunday pairs until the target date.
• Christmas Eve / Vacation counting — Simple year-by-year iteration checking if December 24 or July 1 falls within the remaining date range.

---

🏪 Download from Official Stores

Install Fading Days directly from your browser's official extension store:

• 🦊 Firefox Add-ons: https://addons.mozilla.org/pl/firefox/addon/fading-days-life-countdown/
• 🔵 Chrome Web Store: https://chromewebstore.google.com/detail/fading-days-–-odliczanie/cklkhngecjnkbcemnlfhcmapfcnlbdnb

---

🚀 Installation (Developer Mode)

Chrome / Chromium

1. Clone or download this repository.
2. Open your Chromium browser and navigate to chrome://extensions/.
3. Enable Developer mode (toggle in the top-right corner).
4. Click "Load unpacked" and select the FadingDays/ project folder.
5. The extension icon will appear in your toolbar.

Firefox

1. Clone or download this repository.
2. Open Firefox and navigate to about:debugging#/runtime/this-firefox.
3. Click "Load Temporary Add-on…" and select the manifest.json file inside the FadingDays/ folder.
4. The extension icon will appear in your toolbar.

Note: Temporary add-ons are removed when Firefox is closed. To install permanently, package the extension (./build.sh) and submit it to Firefox Add-ons (AMO).

Building distribution packages

./build.sh

This creates dist/FadingDays-v{version}-chrome.zip and dist/FadingDays-v{version}-firefox.zip ready for upload to Chrome Web Store and Firefox Add-ons.

---

🌍 Adding a New Language

To add support for another language:

1. Open src/core/i18n.js.
2. Add a new translation object to the translations map (e.g., fr: { ... }).
3. Add the language to the SUPPORTED_LANGUAGES array.
4. That's it — the language will automatically appear in the settings dropdown.

---

☕ Support

If you find this extension useful, you can support its development:

---

📄 License

This project is open source. Feel free to use, modify, and distribute it.

---

"The days are long, but the decades are short." — Sam Altman