Skip to content

mr-gordon/path

Repository files navigation

path

Ein minimalistischer, hoch-performanter Pfad- und Task-Manager für macOS und Windows. Entwickelt mit React, TypeScript, Tailwind CSS v4 und Tauri v2 (Rust-Backend).

path wurde entwickelt, um Entwicklern, Designern und Power-Usern die Organisation, das Anpinnen und den schnellen Zugriff auf lokale Projektverzeichnisse und deren zugehörige Aufgaben direkt auf Betriebssystemebene zu erleichtern.


Features

  • YAML-basierte Datenhaltung: Speichert alle Aufgaben und Pfade transparent in einer schlanken paths_config.yaml direkt in deinem Projektverzeichnis.
  • Favoriten & Anpinnen: Pinne wichtige Zielverzeichnisse an und kopiere deine angepinnte Liste mit einem Klick in die Zwischenablage.
  • Details-Sidepanel: Ein edles, ausziehbares Sidepanel im macOS-Glassmorphism-Stil zur Ansicht von Pfaden, Notizen und Keywords mit vollständiger Tastaturunterstützung (Escape zum Schließen).
  • Integrierte Programmier- & Designer-Themes: Wähle in den Einstellungen aus 9 modernen Farbschemata (Default Dark, Default Light, Royal Blue, Midnight Blue, Industrial Red, Nord, Dracula, Monokai, One Dark). Jedes Theme verfügt zudem über farblich exakt abgestimmte Textmarkierungs-Hervorhebungen.
  • Perfekt ausgerichtetes Tabellen-Layout: Aktive und archivierte Jobs nutzen ein synchronisiertes Tabellenlayout (table-fixed) für eine pixelgenaue Spalten-Ausrichtung.
  • Automatisierte Titel-Kürzung (Ellipsis): Zu lange Jobtitel werden harmonisch mit ... ausgepunktet und bei Maus-Hover über einen Tooltip vollständig angezeigt.
  • Aktive & Archivierte Aufgaben: Behalte den Überblick mit separaten Tabellen und intelligentem Buchstaben-Schnellzugriff auf deine Archive. Archivierte Jobs erhalten automatisch den neutralen Status "Archiviert".
  • Intelligente deutsche Sortierung: Numerisch sensible und buchstabengetreue Sortierung (A-Z, Z-A) für deutsche Umlaute und Sonderzeichen mit haptischem Toast-Feedback.
  • Native macOS-Integration: Ein perfekt lokalisiertes Betriebssystem-Menü (Über „path“, Ausblenden, etc.) sowie ein angepasster About-Dialog mit direktem GitHub-Link.

Technische Architektur

  • Frontend: React 19 + TypeScript + Vite
  • Styling: Tailwind CSS v4 (modernes Capsule-Design mit macOS-runden Kanten und CSS-Variablen-basiertem Theme-Switching)
  • Backend / Desktop-Shell: Tauri v2 (schnelle, sichere Rust-Engine mit minimalem Speicher-Footprint)
  • Datenhaltung: YAML (paths_config.yaml) und JSON (settings.json)

Lokale Entwicklung

Voraussetzungen

  1. Node.js (LTS empfohlen)
  2. Rust & Cargo (via rustup.rs)
  3. Platform-spezifische build-tools (z.B. Xcode Command Line Tools auf macOS oder C++ Build Tools auf Windows).

Schritte

  1. Installiere die Frontend-Abhängigkeiten:
    npm install
  2. Starte die Anwendung im Entwicklungsmodus (Hot-Reload für Frontend & Rust-Backend):
    npm run tauri dev
  3. Erstelle einen lokalen Produktions-Release:
    npm run tauri build
    Unter macOS generiert dies die fertige path.app und den Installer path_2.6.5_aarch64.dmg in src-tauri/target/release/bundle/.

Automatisierte Releases in der Cloud (GitHub Actions)

path verfügt über eine vollautomatische CI/CD-Pipeline, um Installer für macOS und Windows parallel zu bauen, ohne dass du physische Hardware für das jeweils andere System benötigst.

So erstellst du ein neues Release:

  1. Erhöhe die Version in src-tauri/tauri.conf.json und package.json:
    {
      "version": "2.6.5"
    }
  2. Pushe deine Änderungen auf GitHub:
    git add .
    git commit -m "bump: version 2.6.5"
    git push origin main
  3. Erstelle einen Tag & Trigger:
    git tag v2.6.5
    git push origin v2.6.5
  4. Die GitHub Action in .github/workflows/release.yml baut daraufhin automatisch:
    • path.app & path.dmg (für macOS)
    • path.exe & path.msi (für Windows) Und lädt sie direkt in deine GitHub-Releases hoch!

Entwickler & Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. © 2026 Christopher Winker.

About

Ein minimalistischer, hoch-performanter Pfad- und Task-Manager für macOS und Windows. Entwickelt mit React, TypeScript, Tailwind CSS v4 und Tauri v2.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors