Reorganize Firefox configuration and repository documentation
- Configure Firefox with privacy settings and extensions (Bitwarden, Plasma Integration, MetaMask, Kagi Search, uBlock Origin) - Set Kagi as default/only search engine - Add MOZ_USE_XINPUT2=1 for smooth scrolling - Create context/ directory for concise unit documentation - Create tests/ directory for test scripts - Move test-firefox-config.sh to tests/ - Update agents.md with documentation workflow guidelines - Fix syntax errors in desktop.nix and dev.nix
This commit is contained in:
Julian Sutter
parent
67581adde6
commit
449510c746
10 changed files with 994 additions and 111 deletions
73
context/README.md
Normal file
73
context/README.md
Normal file
|
|
@ -0,0 +1,73 @@
|
|||
# Context Directory
|
||||
|
||||
This directory contains concise documentation for discrete units of work performed in this repository.
|
||||
|
||||
## Purpose
|
||||
Document specific configurations, changes, and procedures in a concise format. Prefer clarity over verbosity - use inline comments in code when the config is self-documenting.
|
||||
|
||||
## Organization
|
||||
|
||||
### File Naming
|
||||
- Use lowercase, hyphenated names
|
||||
- Include dates for time-sensitive updates: `feature-update-YYYY-MM-DD.md`
|
||||
- Use descriptive names for ongoing configs: `service-name.md`
|
||||
|
||||
### File Content
|
||||
Each file should document:
|
||||
- **What** changes were made
|
||||
- **Where** the config lives (file paths)
|
||||
- **How** to build/test/deploy
|
||||
- **Why** the change was made (brief context)
|
||||
|
||||
## Examples
|
||||
|
||||
### Service Configuration
|
||||
```markdown
|
||||
# Service Name
|
||||
|
||||
**Config:** `servers/service-name.nix`
|
||||
|
||||
## Purpose
|
||||
Brief description of what this service does.
|
||||
|
||||
## Build & Deploy
|
||||
```bash
|
||||
nixos-rebuild build --flake .#system
|
||||
```
|
||||
|
||||
## Notes
|
||||
Key points to remember.
|
||||
```
|
||||
|
||||
### Event/Update Documentation
|
||||
```markdown
|
||||
# Feature Update - YYYY-MM-DD
|
||||
|
||||
## Changes
|
||||
- Removed: old-feature
|
||||
- Added: new-feature
|
||||
|
||||
## Resolution
|
||||
How the issue was solved.
|
||||
|
||||
## Build
|
||||
Build commands if relevant.
|
||||
```
|
||||
|
||||
## When to Create Files
|
||||
- Major feature additions to services/desktop configs
|
||||
- Significant refactoring or restructuring
|
||||
- Security updates requiring special handling
|
||||
- Cross-service dependencies
|
||||
- Troubleshooting guides for complex issues
|
||||
|
||||
## When NOT to Create Files
|
||||
- Routine package updates
|
||||
- Self-documenting NixOS configurations
|
||||
- Trivial changes covered by code comments
|
||||
- Temporary debugging (use git commits instead)
|
||||
|
||||
## Related Documentation
|
||||
- `agents.md` - Agent instructions and procedures
|
||||
- `README.md` - Project overview
|
||||
- Test scripts in `tests/`
|
||||
33
context/firefox-extension-update-2026-02-16.md
Normal file
33
context/firefox-extension-update-2026-02-16.md
Normal file
|
|
@ -0,0 +1,33 @@
|
|||
# Firefox Extension Update - 2026-02-16
|
||||
|
||||
## Changes
|
||||
|
||||
### Removed
|
||||
- Privacy Badger (`jid1-MnnxcxisBPnSXQ@jetpack`)
|
||||
- Facebook Container (`@contain-facebook`)
|
||||
- Multi-account Containers (`@testpilot-containers`)
|
||||
|
||||
### Added
|
||||
- Bitwarden (`{446900e4-71c2-419f-a6a7-df9c2b2dc922}`)
|
||||
- Plasma Integration (`plasma-browser-integration@kde.org`)
|
||||
- MetaMask (`webextension@metamask.io`)
|
||||
- Kagi Search (`kagi-search@kagi.com`)
|
||||
|
||||
### Kept
|
||||
- uBlock Origin (`uBlock0@raymondhill.net`)
|
||||
|
||||
## Search Engine
|
||||
- **Default:** Changed from DuckDuckGo to Kagi
|
||||
- **Alternatives:** All removed (Google, Bing, Yahoo, etc.)
|
||||
|
||||
## Build
|
||||
```bash
|
||||
nixos-rebuild build --flake .#framework
|
||||
sudo nixos-rebuild switch --flake .
|
||||
```
|
||||
|
||||
## Manual Setup
|
||||
Sign in after first launch:
|
||||
- Bitwarden account
|
||||
- MetaMask wallet
|
||||
- Kagi account (for full search features)
|
||||
52
context/firefox-initial-setup.md
Normal file
52
context/firefox-initial-setup.md
Normal file
|
|
@ -0,0 +1,52 @@
|
|||
# Firefox Initial Privacy Setup
|
||||
|
||||
**User:** jsutter
|
||||
**Config:** `users/jsutter.nix` → `programs.firefox`
|
||||
|
||||
## Privacy Configuration
|
||||
|
||||
### Privacy Policies (Locked)
|
||||
- Password manager: Disabled
|
||||
- Password saving: Disabled
|
||||
- Form history: Disabled
|
||||
- Telemetry: Disabled
|
||||
- Firefox Studies: Disabled
|
||||
- CaptivePortal: Disabled
|
||||
|
||||
### Homepage & Privacy
|
||||
- Search: Disabled and locked
|
||||
- Top Sites/Highlights/Snippets: Disabled
|
||||
- Recommendations: Disabled (extensions, features)
|
||||
|
||||
### Content Blocking
|
||||
- Mode: Strict
|
||||
- Tracking protection: Enabled (social, fingerprinting, cryptomining)
|
||||
- Do Not Track: Enabled
|
||||
- Fingerprinting resistance: Enabled
|
||||
|
||||
### Permissions (Block All)
|
||||
- Location requests
|
||||
- Notification requests
|
||||
- Autoplay (audio/video)
|
||||
- Virtual Reality requests
|
||||
|
||||
### Data Collection
|
||||
- Sanitize on shutdown: Enabled (cache, cookies, history, etc.)
|
||||
- Private attribution: Disabled
|
||||
- Battery API: Disabled
|
||||
|
||||
## Build & Verify
|
||||
```bash
|
||||
nixos-rebuild build --flake .#framework
|
||||
sudo nixos-rebuild switch --flake .
|
||||
```
|
||||
|
||||
## Verification URLs
|
||||
- `about:policies` - Active policies
|
||||
- `about:preferences#privacy` - Privacy settings
|
||||
- `about:preferences#home` - Homepage/new tab settings
|
||||
|
||||
## Notes
|
||||
- Original extensions: uBlock Origin, Privacy Badger, Facebook Container, Multi-account Containers
|
||||
- All privacy settings declaratively managed via Home Manager
|
||||
- Settings persist across Firefox updates
|
||||
45
context/firefox.md
Normal file
45
context/firefox.md
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
# Firefox Configuration
|
||||
|
||||
**User:** jsutter
|
||||
**Config:** `users/jsutter.nix` → `programs.firefox`
|
||||
|
||||
## Extensions (Force Installed)
|
||||
- **uBlock Origin** - Ad blocker
|
||||
- **Bitwarden** - Password manager
|
||||
- **Plasma Integration** - KDE integration
|
||||
- **MetaMask** - Web3 wallet
|
||||
- **Kagi Search** - Default/only search engine
|
||||
|
||||
## Key Settings
|
||||
- **Search:** Kagi only (all other engines removed)
|
||||
- **Homepage:** Blank page (`about:blank`)
|
||||
- **Privacy:** Strict content blocking, Do Not Track, fingerprinting resistance
|
||||
- **Telemetry:** Disabled
|
||||
- **Permissions:** Block location/notifications/autoplay/VR requests
|
||||
- **Tabs:** Ctrl+Tab cycles in recent order, hover previews disabled
|
||||
- **Performance:** Hardware acceleration enabled, smooth scrolling via `MOZ_USE_XINPUT2=1`
|
||||
|
||||
## Build & Test
|
||||
```bash
|
||||
nixos-rebuild build --flake .#framework
|
||||
./tests/test-firefox-config.sh
|
||||
sudo nixos-rebuild switch --flake .
|
||||
```
|
||||
|
||||
## Manual Setup Required
|
||||
- Sign in to Bitwarden
|
||||
- Sign in to MetaMask
|
||||
- Sign in to Kagi (for full features)
|
||||
- Set zoom per device in `about:config`:
|
||||
- Framework: `layout.css.devPixelsPerPx = 1.1` (110%)
|
||||
- Aurora: `layout.css.devPixelsPerPx = 1.2` (120%)
|
||||
|
||||
## Verification
|
||||
- `about:policies` - Check policies are active
|
||||
- `about:preferences#privacy` - Verify privacy settings
|
||||
- Extensions auto-install on first Firefox launch
|
||||
|
||||
## Notes
|
||||
- Extensions cannot be uninstalled (force installed via policy)
|
||||
- Settings are declarative and persist across updates
|
||||
- Title bar hiding requires manual UserChrome.css if desired
|
||||
Loading…
Add table
Add a link
Reference in a new issue