Erste Schritte5 Min. Lesezeit

Installation

Von einem leeren Ordner zu deinem ersten reaktiven Backend. Starte lokal – mit TypeScript, React und allem, was du zum Entwickeln brauchst.

Bevor du loslegst

Du brauchst Node.js 24 oder neuer und das private CLI-Paket für dein Betriebssystem. Die nativen Laufzeiten sind enthalten. Zum Entwickeln deiner App brauchst du keine Rust-Toolchain.

Node.js ≥ 24 macOS arm64 oder Linux x64 npm

Terminal

node --version
npm --version

Du entwickelst im Galaxum-Quellrepository?

Maintainer können das passende Plattformpaket im Repository erzeugen. Dafür wird zusätzlich die Rust-Toolchain benötigt. Der Pack-Schritt baut die nativen Laufzeiten und kann beim ersten Mal länger dauern.

Im Quellrepository

npm ci
npm run pack:dx

Das erzeugte CLI-Paket findest du unter .artifacts/. Die folgenden Schritte führst du außerhalb des Quellrepositories aus.

1 Erstelle dein Projekt

Öffne ein Terminal in dem Ordner, in dem dein CLI-Paket liegt. Erstelle dort eine neue App mit dem Namen my-app:

Terminal

npm exec --package ./omega-cli-0.8.0.tgz -- omega create my-app --local

Die CLI erstellt das Projekt, installiert die Abhängigkeiten, generiert die typisierte API und startet den Entwicklungsserver. --local wählt ausdrücklich die lokale Entwicklung.

Öffne http://127.0.0.1:4300. Du siehst eine funktionsfähige React-App, mit der du Aufgaben erstellen und abhaken kannst. Maßgeblich ist die URL, die dein Terminal ausgibt.

2 Lerne dein Projekt kennen

Frontend und Backend leben in einem Projekt. Du beschreibst deine Daten einmal – daraus entstehen die Typen für deine Funktionen und React-Komponenten.

my-app/ ├── omega/ │ ├── schema.ts # Datenmodell & Regeln │ ├── tasks.ts # Queries & Mutationen │ └── _generated/ # Typisierte API ├── src/ │ ├── main.tsx # React-App & Provider │ └── style.css # Dein Design └── package.json

Bearbeite omega/schema.ts, omega/tasks.ts und src/main.tsx. Die Dateien in _generated/ aktualisiert die CLI. Private Zugangsdaten, lokale Daten und Build-Artefakte liegen in ignorierten Verzeichnissen.

3 Entwickle, speichere, prüfe

Nach dem ersten Start wechselst du in einem zweiten Terminal in dein Projekt. Mit diesen Befehlen arbeitest du weiter:

Zweites Terminal

cd my-app
npm test
npm run doctor

npm run devEntwicklungsserver erneut starten

npm testTests mit isolierten Daten auf der echten Engine

npm run doctorInstallation und Plattform prüfen

npm run buildFrontend und Backend prüfen und bauen

Ändere eine Backend-Funktion und speichere. Der Dev-Server prüft Typen, generiert die API und aktualisiert das Backend. Bei einem fehlerhaften Update bleibt die letzte funktionierende Version aktiv.

Dein Backend steht. Jetzt kommt React.

Im nächsten Guide baust du eine kleine Aufgabenliste und siehst, wie Schema, Funktionen und Live-Queries zusammenspielen.

Mit React startenVom Datenmodell zur ersten Live-Query.