README.md

# Reddit Tweaks Firefox Extension

> **Note:** This project was built with the aid of [Cursor](https://cursor.com) and Claude.

This is a personal project, kept public for reference only. It will never be published to AMO (addons.mozilla.org). If you use it, expect to customize things to your own taste — it's opinionated by design.

## What it does

A Firefox extension that reskins [old.reddit.com](https://old.reddit.com) with a handful of visual tweaks:

- **Badge layout** — replaces the default subreddit link and comment count with styled badges
- **Card layout** — wraps posts in rounded cards with configurable density, spacing, and background style
- **Font override** — swaps in Reddit Sans (and Reddit Mono for code blocks) site-wide
- **Color customization** — per-subreddit badge colors via an inline HSV picker
- **Theming** — separate light/dark palettes with automatic RES night-mode detection

## Screenshots

![Extension overview](docs/reddit-extension-collage.png)

> Extension menu (left), standard old.reddit.com (top right), with extension enabled (bottom right).
> RES (Reddit Enhancement Suite) was enabled during capture.

| View | Full-size image |
|---|---|
| Extension menu | [reddit-extension-popup.png](docs/reddit-extension-popup.png) |
| Without extension | [reddit-extension-disabled.png](docs/reddit-extension-disabled.png) |
| With extension | [reddit-extension-enabled.png](docs/reddit-extension-enabled.png) |

## Installation

1. Clone or download this repo
2. Open Firefox and navigate to `about:debugging#/runtime/this-firefox`
3. Click **Load Temporary Add-on...**
4. Select the `manifest.json` file from this repo's root

The extension will stay loaded until you close Firefox. Repeat step 2-4 after restart.

## Settings

Click the extension icon in the toolbar to open the settings popup. All toggles, color pickers, density controls, and presets live there.

## Fonts

Reddit Sans, Reddit Sans Condensed, and Reddit Mono are bundled under the [SIL Open Font License 1.1](content/fonts/OFL.txt). See that file for full license text and copyright info.

## License

Extension code is [MIT](LICENSE). Bundled fonts are under the [SIL Open Font License 1.1](content/fonts/OFL.txt).
chore: add LICENSE, README, VERSION, .editorconfig, expand .gitignore Add project housekeeping files and sync manifest version to 0.1.0. Also stages previously untracked chat summaries and score-ratio docs. Co-authored-by: Cursor <cursoragent@cursor.com> 2026-08-28 00:27:54 -04:00			`# Reddit Tweaks Firefox Extension`

			`> Note: This project was built with the aid of [Cursor](https://cursor.com) and Claude.`

			`This is a personal project, kept public for reference only. It will never be published to AMO (addons.mozilla.org). If you use it, expect to customize things to your own taste — it's opinionated by design.`

			`## What it does`

			`A Firefox extension that reskins [old.reddit.com](https://old.reddit.com) with a handful of visual tweaks:`

			`- Badge layout — replaces the default subreddit link and comment count with styled badges`
			`- Card layout — wraps posts in rounded cards with configurable density, spacing, and background style`
			`- Font override — swaps in Reddit Sans (and Reddit Mono for code blocks) site-wide`
			`- Color customization — per-subreddit badge colors via an inline HSV picker`
			`- Theming — separate light/dark palettes with automatic RES night-mode detection`

docs: add screenshots section to README with composed collage Three-panel collage (popup, before, after) generated via Pillow script. 4:3 aspect ratio, 1200px max, gradient background with drop shadows. Co-authored-by: Cursor <cursoragent@cursor.com> 2026-08-28 03:09:55 -04:00			`## Screenshots`

			`![Extension overview](docs/reddit-extension-collage.png)`

			`> Extension menu (left), standard old.reddit.com (top right), with extension enabled (bottom right).`
			`> RES (Reddit Enhancement Suite) was enabled during capture.`

			`\| View \| Full-size image \|`
			`\|---\|---\|`
			`\| Extension menu \| [reddit-extension-popup.png](docs/reddit-extension-popup.png) \|`
			`\| Without extension \| [reddit-extension-disabled.png](docs/reddit-extension-disabled.png) \|`
			`\| With extension \| [reddit-extension-enabled.png](docs/reddit-extension-enabled.png) \|`

chore: add LICENSE, README, VERSION, .editorconfig, expand .gitignore Add project housekeeping files and sync manifest version to 0.1.0. Also stages previously untracked chat summaries and score-ratio docs. Co-authored-by: Cursor <cursoragent@cursor.com> 2026-08-28 00:27:54 -04:00			`## Installation`

			`1. Clone or download this repo`
			2. Open Firefox and navigate to `about:debugging#/runtime/this-firefox`
			`3. Click Load Temporary Add-on...`
			4. Select the `manifest.json` file from this repo's root

			`The extension will stay loaded until you close Firefox. Repeat step 2-4 after restart.`

			`## Settings`

			`Click the extension icon in the toolbar to open the settings popup. All toggles, color pickers, density controls, and presets live there.`

			`## Fonts`

			`Reddit Sans, Reddit Sans Condensed, and Reddit Mono are bundled under the [SIL Open Font License 1.1](content/fonts/OFL.txt). See that file for full license text and copyright info.`

			`## License`

			`Extension code is [MIT](LICENSE). Bundled fonts are under the [SIL Open Font License 1.1](content/fonts/OFL.txt).`