JonKazama-Hellion
ed11827321
- README: Ko-fi Badge und Link in Impressum-Tabelle - newtab.html: Ko-fi-Link in About-Section mit Kaffeetassen-Icon - .gitignore: v2-planning.md ausschliessen
355 lines
13 KiB
Markdown
355 lines
13 KiB
Markdown
# ⬡ Hellion Dashboard v1.5.2
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[](https://ko-fi.com/hellionmedia)
|
|
|
|
**Kein Account. Kein Abo. Keine Cloud. Alle Daten bleiben 100% lokal.**
|
|
|
|
Ein persönlicher Bookmark-Dashboard als Browser-Extension.
|
|
Boards, Drag & Drop, 8 Themes, Suchleiste, Sticky Notes — alles im Browser, alles offline.
|
|
Keine externe Datenübertragung, keine Tracker, keine Analytics, keine Werbung.
|
|
|
|
Entwickelt von **[Hellion Online Media — Florian Wathling](https://hellion-media.de)** — JonKazama-Hellion.
|
|
|
|
---
|
|
|
|
## Was diese Extension NICHT ist
|
|
|
|
- Kein Cloud-Sync und kein Account-System
|
|
- Keine Datenerfassung oder Telemetrie
|
|
- Keine Drittanbieter-Abhängigkeiten oder Build-Tools
|
|
- Kein Netzwerkverkehr außer Favicon-Abruf (Google Favicons API)
|
|
|
|
## Was diese Extension IST
|
|
|
|
Ein lokaler, privater NewTab-Ersatz für alle gängigen Browser.
|
|
Bookmarks werden in `chrome.storage.local` gespeichert — nichts verlässt den Browser.
|
|
Was angezeigt wird, ist was gespeichert ist. Keine Magie.
|
|
|
|
---
|
|
|
|
## Features
|
|
|
|
### Boards & Bookmarks
|
|
|
|
- Boards als Gruppen für Links — per Drag & Drop umsortierbar
|
|
- Bookmarks mit Favicon, Titel, optionaler Beschreibung
|
|
- Boards per Blur-Button verstecken (Privat-Modus)
|
|
- HTML-Import von Browser-Lesezeichen (Chrome, Edge, Firefox)
|
|
- JSON Export & Import (Backup & Restore)
|
|
|
|
### Suchleiste
|
|
|
|
- Google, DuckDuckGo oder Bing — per Klick wechselbar
|
|
- Ein/ausblendbar über Settings
|
|
|
|
### Sticky Note
|
|
|
|
- Schwebendes Notiz-Widget, frei positionierbar
|
|
- Text und Position werden persistent gespeichert
|
|
|
|
### 8 Themes
|
|
|
|
| Theme | Akzent | Stil |
|
|
|---|---|---|
|
|
| Nebula | `#b359ff` Magenta | Cosmic Nebula |
|
|
| Crescent | `#d4bd8a` Gold | Minimalist Night |
|
|
| Event Horizon | `#9d5cff` Purple | Deep Space |
|
|
| Merchantman | `#2eb8b8` Emerald | Industrial Sci-Fi |
|
|
| Julia & Jin | `#7db3ff` Aetherial Blue | FFXIV Night |
|
|
| SC Sunset | `#ff8c3d` Amber | Planet-Side |
|
|
| Hellion HUD | `#32ff6a` Neon Green | Circuit Board |
|
|
| Hellion Energy | `#1eff8e` Acid Green | Tactical |
|
|
|
|
### Bild-Credits
|
|
|
|
| Theme | Quelle | Lizenz |
|
|
|---|---|---|
|
|
| Nebula | [Temel / mrwashingt0n](https://pixabay.com/de/users/mrwashingt0n-15745216/) auf Pixabay | Pixabay License (frei) |
|
|
| Crescent | [Daniil Silantev](https://unsplash.com) auf Unsplash | Unsplash License (frei) |
|
|
| Event Horizon | Eigenes Werk — Stillframe von [hellion-initiative.online](https://hellion-initiative.online) | Hellion Online Media |
|
|
| Merchantman | [Roberts Space Industries](https://robertsspaceindustries.com) — Made by the community | RSI Community Content |
|
|
| SC Sunset | Screenshot aus Star Citizen von Cloud Imperium Games | Fan Content |
|
|
| Julia & Jin | Eigenes Werk — Final Fantasy XIV Screenshot, bearbeitet in Photoshop | Hellion Online Media |
|
|
| Hellion HUD | Eigenes Werk — AI-generiert und nachbearbeitet für hellion-media.de | Hellion Online Media |
|
|
| Hellion Energy | Eigenes Werk — AI-generiert für hellion-media.de | Hellion Online Media |
|
|
|
|
### Onboarding & Dialoge
|
|
|
|
- 6-stufiger Willkommens-Flow beim ersten Start
|
|
- Custom Frosted-Glass-Dialoge statt nativer Browser-Popups
|
|
- Backup-Reminder alle 7 Tage (warnt vor Datenverlust bei Browser-Reset)
|
|
|
|
### Settings (Accordion)
|
|
|
|
- Einklappbare Sektionen mit Chevron — About/Danger Zone standardmäßig geschlossen
|
|
- Compact Mode — reduziert Abstände für mehr Bookmarks
|
|
- Shorten Titles — kürzt lange Titel auf eine Zeile
|
|
- Open in New Tab — Bookmarks in neuem Tab öffnen
|
|
- Show Descriptions — Beschreibungen unter Bookmarks anzeigen
|
|
- Hide Extra Bookmarks — Boards ab 5/10/20 Bookmarks einklappen
|
|
- Suchleiste ein/ausblenden
|
|
- JSON Export / Import
|
|
- Onboarding wiederholbar
|
|
- Danger Zone — Reset aller Daten
|
|
|
|
### Theme-Picker (eigener Header-Button)
|
|
|
|
- 8 Themes als zentriertes Modal
|
|
- Hintergrundbild per URL oder lokaler Upload
|
|
|
|
---
|
|
|
|
## Browser-Kompatibilität
|
|
|
|
| Browser | Status | Manifest |
|
|
|---|---|---|
|
|
| Chrome | ✅ Kompatibel | V3 (`manifest.json`) |
|
|
| Edge | ✅ Kompatibel | V3 (`manifest.json`) |
|
|
| Brave | ✅ Kompatibel | V3 (`manifest.json`) |
|
|
| Opera | ✅ Kompatibel | V3 (`manifest.opera.json`) |
|
|
| Opera GX | ✅ Kompatibel | V3 (`manifest.opera.json`) |
|
|
| Vivaldi | ✅ Kompatibel | V3 (`manifest.json`) |
|
|
| Firefox | ✅ Kompatibel | V3 (`manifest.firefox.json`) |
|
|
|
|
> **Firefox-Hinweis:** Ab v1.2.0 läuft die Extension auf Manifest V3 — identisch zu Chrome/Edge.
|
|
> `manifest.firefox.json` bleibt als separate Datei erhalten für Firefox-spezifische Anpassungen.
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
### Chrome / Edge / Brave / Vivaldi
|
|
|
|
```text
|
|
1. Repository als ZIP herunterladen oder git clone
|
|
2. chrome://extensions öffnen (bzw. edge:// / brave://)
|
|
3. Entwicklermodus aktivieren
|
|
4. "Entpackte Erweiterung laden" → Ordner auswählen in dem manifest.json liegt
|
|
5. Neuen Tab öffnen
|
|
```
|
|
|
|
### Opera / Opera GX
|
|
|
|
```bash
|
|
# manifest.opera.json als manifest.json verwenden:
|
|
copy manifest.opera.json manifest.json # Windows
|
|
cp manifest.opera.json manifest.json # Linux/Mac
|
|
```
|
|
|
|
```text
|
|
1. opera://extensions öffnen
|
|
2. Entwicklermodus aktivieren
|
|
3. "Entpackte Erweiterung laden" → Ordner auswählen
|
|
4. Neuen Tab öffnen
|
|
```
|
|
|
|
> **Opera-Hinweis:** Opera GX priorisiert Speed Dial — der enthaltene Workaround
|
|
> übernimmt die New-Tab-Seite zuverlässig. Details: [src/js/opera/README.md](src/js/opera/README.md)
|
|
|
|
### Firefox
|
|
|
|
```bash
|
|
# manifest.firefox.json als manifest.json verwenden:
|
|
copy manifest.firefox.json manifest.json # Windows
|
|
cp manifest.firefox.json manifest.json # Linux/Mac
|
|
```
|
|
|
|
```text
|
|
1. about:debugging#/runtime/this-firefox öffnen
|
|
2. "Temporäres Add-on laden"
|
|
3. Die manifest.json aus dem Projektordner auswählen
|
|
```
|
|
|
|
> **Hinweis:** Temporäre Add-ons werden beim Browser-Neustart entfernt.
|
|
> Für dauerhafte Installation ist eine signierte `.xpi`-Datei nötig.
|
|
|
|
---
|
|
|
|
## Browser-Bookmarks exportieren & importieren
|
|
|
|
| Browser | Export-Pfad |
|
|
|---|---|
|
|
| Chrome / Edge | Einstellungen → Lesezeichen → Exportieren |
|
|
| Firefox | Lesezeichen → Alle Lesezeichen → Importieren und Sichern → Als HTML exportieren |
|
|
|
|
Die exportierte `.html`-Datei über den **Import**-Button in der Extension laden.
|
|
|
|
---
|
|
|
|
## Datenschutz
|
|
|
|
- Keine externe Datenübertragung (außer Google Favicons API für Icons)
|
|
- Speicherung in `chrome.storage.local` (Chromium) bzw. `browser.storage.local` (Firefox)
|
|
- Keine Tracker, keine Analytics, keine Werbung
|
|
- Keine Cookies, keine Session-Daten
|
|
- Storage-Quota-Prüfung warnt bei 8 MB+ (Limit: 10 MB)
|
|
- Permissions: `storage`, `bookmarks`
|
|
|
|
---
|
|
|
|
## Tech-Stack
|
|
|
|
| Komponente | Details |
|
|
|---|---|
|
|
| Sprache | JavaScript (Vanilla ES2020, keine Frameworks) |
|
|
| Styling | CSS Custom Properties (Theme-System) |
|
|
| Fonts | Lokale Fonts (Rajdhani, Inter, Cinzel) |
|
|
| Storage | `chrome.storage.local` / `localStorage` Fallback |
|
|
| Favicons | Google Favicons API (`/s2/favicons`) |
|
|
| Drag & Drop | Pointer Events API (nativ) |
|
|
| Build | Kein Build-Schritt — direkt lauffähig |
|
|
| CI/CD | GitHub Actions (Security, Quality, Release) |
|
|
|
|
---
|
|
|
|
## Architektur
|
|
|
|
```text
|
|
hellion-newtab/
|
|
├── manifest.json # Chrome, Edge, Brave, Vivaldi (MV3)
|
|
├── manifest.firefox.json # Firefox (MV3)
|
|
├── manifest.opera.json # Opera / Opera GX (MV3 + Workaround)
|
|
├── newtab.html # Haupt-HTML (UI-Struktur, Modals, Settings Panel)
|
|
├── LICENSE # CC BY-NC-SA 4.0
|
|
├── CHANGELOG.md # Versionshistorie
|
|
├── SECURITY.md # Sicherheitsrichtlinie und Meldeprozess
|
|
├── DISCLAIMER.md # Haftungsausschluss
|
|
│
|
|
├── src/
|
|
│ ├── js/
|
|
│ │ ├── storage.js # Storage Abstraction + Quota-Prüfung
|
|
│ │ ├── state.js # Globaler State, Defaults, Hilfsfunktionen
|
|
│ │ ├── dialog.js # Custom Dialog-System (HellionDialog.alert/confirm)
|
|
│ │ ├── themes.js # Theme-Definitionen & Anwendungslogik
|
|
│ │ ├── boards.js # Board/Bookmark Rendering, Event Delegation, Modals
|
|
│ │ ├── drag.js # Drag & Drop (Pointer Events, Board + Bookmark)
|
|
│ │ ├── settings.js # Settings Panel, Theme-Modal, Accordion
|
|
│ │ ├── search.js # Suchleiste (Google, DuckDuckGo, Bing)
|
|
│ │ ├── sticky.js # Sticky Note Widget (Drag, Persist, Toggle)
|
|
│ │ ├── data.js # JSON Export / Import mit Validierung
|
|
│ │ ├── onboarding.js # Mehrstufiger Willkommens-Flow
|
|
│ │ ├── app.js # Init, Clock, globale Events (Einstiegspunkt)
|
|
│ │ └── opera/ # Opera GX Workaround-Skripte
|
|
│ │ ├── background.js # Tab-Management gegen Speed Dial
|
|
│ │ └── redirect.js # Content Script Redirect
|
|
│ └── css/
|
|
│ └── main.css # Styles + Theme-System + Responsive Breakpoints
|
|
│
|
|
├── assets/
|
|
│ ├── fonts/ # Lokale Fonts (Rajdhani, Inter, Cinzel)
|
|
│ ├── themes/ # 8 Theme-Hintergrundbilder
|
|
│ └── icons/
|
|
│ ├── icon16.png
|
|
│ ├── icon48.png
|
|
│ └── icon128.png
|
|
│
|
|
└── .github/
|
|
└── workflows/
|
|
├── security.yml # CodeQL-Analyse + Dependency Review
|
|
├── quality.yml # Struktur, Manifest, Syntax, Versions-Konsistenz
|
|
└── release.yml # ZIP-Pakete (Chrome + Firefox + Opera) + SHA256
|
|
```
|
|
|
|
### Design-Prinzipien
|
|
|
|
- **Zero Dependencies** — Kein npm, kein Build, kein Framework. Direkt lauffähig
|
|
- **Privacy First** — Alle Daten lokal, kein Server-Kontakt
|
|
- **Modular** — 12 JS-Dateien mit klarer Zuständigkeit
|
|
- **Responsive** — Tablet (768px) und Smartphone (480px) Breakpoints
|
|
- **Secure** — `createElement` statt `innerHTML`, URL-Validierung, Storage-Fehlerbehandlung
|
|
- **Event Delegation** — Ein Listener pro Board-Liste statt pro Bookmark (Performance)
|
|
- **Theme-System** — CSS Custom Properties, 8 Themes, Custom-Background-Support
|
|
|
|
---
|
|
|
|
## GitHub Actions
|
|
|
|
### Security Scan (`security.yml`)
|
|
|
|
- **CodeQL-Analyse** — Statische Sicherheitsanalyse für JavaScript
|
|
- **Dependency Review** — Prüft Pull Requests auf bekannte Schwachstellen
|
|
- **Zeitplan** — Automatisch wöchentlich (Montag 06:00 UTC) + bei Push/PR
|
|
|
|
### Code Quality (`quality.yml`)
|
|
|
|
- **Projektstruktur** — Alle Pflichtdateien und -ordner vorhanden
|
|
- **Manifest-Validierung** — JSON-Syntax, Version, Permissions
|
|
- **JavaScript Syntax-Check** — `node --check` für alle JS-Dateien
|
|
- **Versions-Konsistenz** — manifest.json, manifest.firefox.json und newtab.html müssen übereinstimmen
|
|
- **Icon-Prüfung** — Alle Extension-Icons vorhanden
|
|
|
|
### Release (`release.yml`)
|
|
|
|
- **Trigger** — Bei Git-Tag (`v*`)
|
|
- **Pakete** — Chrome-ZIP + Firefox-ZIP + Opera-ZIP (alle MV3)
|
|
- **Checksummen** — SHA256 für alle Artefakte
|
|
- **GitHub Release** — Automatisch mit Installationsanleitung
|
|
|
|
```bash
|
|
# Release erstellen:
|
|
git tag v1.5.2
|
|
git push origin v1.5.2
|
|
# → GitHub Action erstellt automatisch Release mit ZIP-Dateien
|
|
```
|
|
|
|
---
|
|
|
|
## Entwicklung
|
|
|
|
```bash
|
|
# Repository klonen
|
|
git clone https://github.com/JonKazama-Hellion/Hellion-NewTab.git
|
|
|
|
# Extension im Browser laden (siehe Installation)
|
|
|
|
# Nach Änderungen: Extension neu laden
|
|
chrome://extensions → Hellion NewTab → Neu laden
|
|
```
|
|
|
|
Kein Build-Schritt nötig. Dateien ändern, Extension neu laden, fertig.
|
|
|
|
---
|
|
|
|
## Sicherheit
|
|
|
|
Sicherheitslücken bitte **nicht** über öffentliche Issues melden.
|
|
Details zur Meldung, Reaktionszeiten und Sicherheitsarchitektur: [SECURITY.md](SECURITY.md)
|
|
|
|
---
|
|
|
|
## Lizenz & Impressum
|
|
|
|
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
|
|
|
|
- Kostenlos für private Nutzung
|
|
- Teilen und Modifikation erlaubt mit Namensnennung
|
|
- Kommerzielle Nutzung ohne Erlaubnis verboten
|
|
|
|
Vollständige Lizenz: [LICENSE](LICENSE) | [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Entwickler** | Florian Wathling |
|
|
| **Unternehmen** | Hellion Online Media |
|
|
| **Web** | [hellion-media.de](https://hellion-media.de) |
|
|
| **Impressum** | [hellion-media.de/impressum](https://hellion-media.de/impressum) |
|
|
| **Bug Reports** | [kontakt@hellion-media.de](mailto:kontakt@hellion-media.de?subject=Hellion%20NewTab%20%E2%80%93%20Bug%20Report) |
|
|
| **Security** | [SECURITY.md](SECURITY.md) |
|
|
| **Support** | [Ko-fi](https://ko-fi.com/hellionmedia) |
|
|
|
|
---
|
|
|
|
### Einsatz von AI
|
|
|
|
AI (Claude Code, Opus 4.6 von Anthropic) wurde als Hilfsmittel eingesetzt — für Fehleridentifikation, Code-Review und Qualitätssicherung. Architektur, Features und alle Entscheidungen sind Eigenleistung.
|
|
|
|
---
|
|
|
|
> Vollständige Versionshistorie: [CHANGELOG.md](CHANGELOG.md)
|
|
|
|
**Hellion NewTab** — [Hellion Online Media](https://hellion-media.de) — JonKazama-Hellion |