BookStax – Dein BookStack-Wiki. In deiner Tasche.
BookStax ist eine native iOS-App, die dein selbst gehostetes BookStack-Wiki direkt aufs iPhone bringt – ohne Kompromisse beim Datenschutz, ohne Umwege über Cloud-Dienste, direkt verbunden mit deiner eigenen Instanz.
✨ Features im Überblick
📚 Bibliothek – deine gesamte Wissensbasis in der Hand
BookStax bildet die komplette BookStack-Hierarchie nativ ab: Bücherregale → Bücher → Kapitel → Seiten. Du kannst durch deine gesamte Dokumentation navigieren, genau so wie im Browser – nur bequemer vom Sofa.
- Vollständige Navigation durch Shelves, Books, Chapters und Pages
- Breadcrumb-Navigation – du siehst immer, wo du dich in der Hierarchie befindest, und kannst mit einem Tipp zurückspringen
- Schnellzugriff auf zuletzt geänderte Inhalte
- Inhalte werden lokal gecacht – auch offline verfügbar
🔍 Suche – alles sofort finden
Die integrierte Suchfunktion durchsucht deine gesamte BookStack-Instanz in Echtzeit. Egal ob du nach einer Seite, einem Buch, einem Kapitel oder einem Regal suchst – BookStax findet es.
- Volltextsuche über alle Inhaltstypen
- Filterung nach Typ: Seiten, Bücher, Kapitel, Regale
- Filterung nach Tags
- Zuletzt verwendete Suchen werden gespeichert
✏️ Editor – Seiten direkt auf dem iPhone erstellen und bearbeiten
BookStax kommt mit einem vollständigen Markdown-Editor, der speziell für die mobile Nutzung entwickelt wurde. Du kannst neue Seiten anlegen und bestehende Seiten direkt auf dem iPhone bearbeiten – mit Live-Vorschau und einer dedizierten Formatierungsleiste.
- Formatierungsleiste mit zwei Reihen: Überschriften (H1–H3), Fett, Kursiv, Durchgestrichen, Inline-Code, Listen, Blockquote, Links, Codeblöcke, Trennlinien
- Live-Vorschau – wechsle jederzeit zwischen Schreib- und Vorschaumodus
- Bild-Upload direkt aus der Fotobibliothek – Bilder werden als Markdown-Referenz in den Text eingefügt
- Tag-Editor – Tags direkt beim Bearbeiten zuweisen, erstellen oder entfernen; vorhandene Tags aus BookStack werden als Vorschlag angezeigt
- Unsaved-Changes-Schutz – die App warnt, bevor du ungespeicherte Änderungen verlierst
- Neue Bücher, Kapitel und Seiten direkt aus der App erstellen
📖 Reader – Seiten komfortabel lesen
Der eingebaute Reader zeigt Seiteninhalte in einem sauberen WebView an – inklusive korrektem Rendering von Tabellen, Codeblöcken und allen BookStack-Formatierungen, genau wie im Browser.
- Kommentare lesen (optional ein-/ausblendbar)
- Seite direkt aus dem Reader heraus bearbeiten
- Seite als Link teilen
- Dark-Mode-kompatibles Rendering
🔒 Sicherer Verbindungsaufbau mit API-Token
Beim ersten Start führt ein mehrstufiger Onboarding-Assistent durch die Einrichtung. Die Verbindung zu deiner BookStack-Instanz wird mit einem API-Token gesichert, das sicher im iOS-Keychain gespeichert wird.
- Geführte Einrichtung in wenigen Schritten
- Inline-Verbindungscheck: die App prüft Server-Erreichbarkeit und Token-Gültigkeit in Echtzeit
- Warnung bei unverschlüsselten HTTP-Verbindungen
- Zugangsdaten werden ausschließlich im iOS-Keychain gespeichert – nicht in der iCloud, nicht bei Dritten
- Paste-from-Clipboard für Token-ID und Secret
🎨 Erscheinungsbild & Personalisierung
BookStax lässt sich optisch an den eigenen Geschmack anpassen – von der Accent-Farbe bis zum App-weiten Farbschema.
- Light / Dark / System-Modus
- 8 Accent-Farben zur Auswahl (z.B. Ocean, Sand, Forest und mehr)
- Adaptives App-Icon mit Light-, Dark- und Tinted-Variante (iOS 18+)
- Sprachen: Deutsch 🇩🇪, Englisch 🇬🇧, Spanisch 🇪🇸
🔄 Sync & Offline
BookStax synchronisiert deine Inhalte lokal und hält sie auch ohne Internetverbindung verfügbar.
- Lokaler Cache via SwiftData – Inhalte bleiben auch offline lesbar
- Optionaler WiFi-only-Modus für die Synchronisation
- Manueller „Jetzt synchronisieren“-Button
- Anzeige des Zeitpunkts der letzten Synchronisation
- Offline-Banner wenn keine Verbindung besteht
🛠️ Technische Details
BookStax ist eine moderne native iOS-App, gebaut mit den neuesten Apple-Technologien:
| Technologie | Details |
|---|---|
| Sprache | Swift 6, SwiftUI |
| Minimum iOS | iOS 18+ |
| Datenspeicherung | SwiftData (lokal, on-device) |
| Zugangsdaten | iOS Keychain |
| API | BookStack REST API v1 |
| Authentifizierung | API-Token (Token ID + Secret) |
| Sprachen | Deutsch, Englisch, Spanisch |
🔐 Datenschutz first – kein Kompromiss
BookStax wurde von Grund auf mit dem Gedanken entwickelt: Deine Daten gehören dir.
- Die App verbindet sich ausschließlich mit deiner eigenen BookStack-Instanz – keine Daten fließen an externe Server
- Keine Telemetrie, keine Tracking-SDKs, keine Analytics
- Keine Account-Erstellung bei Dritten nötig
- Zugangsdaten bleiben im iOS-Keychain – lokal und sicher
- Volle DSGVO-Konformität, weil gar keine personenbezogenen Daten das Gerät verlassen
BookStax ist die App für alle, die ihre Wissensdatenbank wirklich selbst kontrollieren wollen – und das auch unterwegs.
📋 Voraussetzungen
- Eine laufende BookStack-Instanz (selbst gehostet, erreichbar über HTTPS)
- Ein BookStack-Konto mit der Berechtigung „Access System API“
- Ein API-Token (erstellt in den Profileinstellungen deines BookStack-Accounts)
- iPhone mit iOS 18 oder neuer
❓ Noch kein BookStack?
BookStax setzt eine eigene BookStack-Instanz voraus. Kein Problem – die Installation ist einfacher als du denkst. Hier erfährst du, was BookStack ist und wie du es in wenigen Minuten aufsetzt.