Warum Galaxum?

Ein zusammenhängender Workflow

Eine interaktive App braucht ein Datenmodell, Backend-Logik und eine Oberfläche, die Änderungen mitbekommt. Galaxum verbindet diese Teile: Du definierst dein Schema und deine Funktionen in TypeScript. Die generierte API bringt deren Typen bis in deine React-Komponenten.

const tasks = useQuery(api.tasks.list);
const create = useMutation(api.tasks.create);

await create({ title: "Build something meaningful" });

Das ist der Kern des Modells. Wie du Provider, Authentifizierung und Fehlerzustände einrichtest, zeigt der vollständige React-Guide.

Daten, die mitdenken

Eine Live-Query ist eine abonnierte Backend-Funktion. Galaxum erfasst ihre tatsächlichen Datenzugriffe – auch leere Ergebnisse und fehlende Datensätze. Wenn sich relevante Daten ändern, wird die Query neu ausgeführt und das Ergebnis an die verbundenen Clients übertragen.

Gleiche abonnierte Queries teilen sich einen Cache. Verschiedene Live-Queries und Mutationen nutzen im React-Client eine gemeinsame WebSocket-Verbindung. Der SDK-Kern funktioniert auch unabhängig von React.

Änderungen mit einer verlässlichen Bestätigung

Eine Mutation bündelt Datenänderungen, Validierung und Ergebnisbestätigung. Schema, Eigentümerregeln und globale Anwendungsinvarianten werden vor der Veröffentlichung geprüft. Schlägt eine Regel fehl, wird die Mutation abgewiesen.

Bei einem vorübergehenden Verbindungsfehler verwendet ein erneuter Sendeversuch denselben Idempotenzschlüssel. Solange der ursprüngliche Beleg aufbewahrt wird, liefert eine Wiederholung das ursprüngliche Ergebnis. Der Standard-React-Client wartet außerdem, bis aktive benannte Queries die bestätigte Revision erreicht haben.

Raum für Experimente. Auch mit Daten.

Neue Funktionen betreffen oft Code und Daten zugleich. Galaxum unterstützt Daten-Branches und separat laufende Git-/Daten-Worktrees, damit du Änderungen in einem isolierten Entwicklungsstand ausprobieren kannst.

npx omega branch create experiment
npx omega branch use experiment

# Zurück zum Hauptzweig
npx omega branch use main

# Merge-Vorschau anzeigen, noch nicht übernehmen
npx omega merge experiment

Eine Übernahme erfolgt ausdrücklich und mit Validierung. Worktree-Merges prüfen die gespeicherte Vorschau und die Revisionen der beteiligten Datenstände. Haben sich die geprüften Daten geändert, ist eine neue Vorschau nötig.

Git-Code-Merges bleiben ein eigener Schritt. Galaxum behauptet damit keine atomare gemeinsame Veröffentlichung von Git und Datenbank.

Lokal anfangen. Den Datenfluss verstehen.

Die CLI enthält die nativen Laufzeiten. Neue Projekte starten mit der Rust-RAM/WAL-Engine; SQLite kann ausdrücklich als alternative Engine gewählt werden. Deine App-Funktionen laufen im TypeScript-/JavaScript-Ausführungspfad des Hosts.

Mit einem lokalen Projekt kannst du Funktionen schreiben, echte Engine-Tests ausführen und die Reaktivität in mehreren Browserfenstern nachvollziehen. Ein selbst betriebener Projektserver unterstützt außerdem verbundene Entwicklungsprojekte.

Was heute möglich ist

Galaxum ist aktuell eine Developer Preview. Diese Dokumentation beschreibt den vorhandenen Entwicklungsworkflow.