Schnellstart

Es gibt zwei Möglichkeiten zu starten, je nachdem, was Sie vorhaben.

Beide erzeugen einen laufenden Server mit Console + Account. Der Unterschied besteht darin, ob Sie Quelldateien als Gerüst erstellen.

Voraussetzungen

• Node.js 20 oder neuer — node --version
• Ein Terminal

Das war's. Kein Docker. Keine Datenbank. Keine Kontoregistrierung.

Pfad A — os start (Operator / erstmaliger Tester)

Installieren Sie die CLI global und führen Sie sie dann aus:

npm i -g @objectstack/cli
os start

Sie sehen:

◆ ObjectStack
────────────────────────────────────────
🏠 Home: ~/.objectstack
📦 Artifact: none (empty kernel — install apps via Console marketplace)
🗄️ Database: file:~/.objectstack/data/objectstack.db

  ✓ Server is ready

  ➜  API:       http://localhost:3000/
  ➜  Console:    http://localhost:3000/_console/
  ➜  Account:   http://localhost:3000/_account/
  ➜  Console:   http://localhost:3000/_console/

  Plugins: 23 loaded

Das war's. Sie betreiben jetzt ObjectOS.

Was läuft

Die Laufzeitumgebung startet in einem leeren Kernel — keine Objekte, keine Apps — und stellt den marketplace bereit, sodass Sie fertige Apps in Sekunden installieren können.

Per Chat erstellen — der AI Builder

Sobald Sie angemeldet sind, öffnen Sie den KI-Assistenten in der Console (Funkel-Symbol oben rechts) und beschreiben Sie, was Sie benötigen:

„Ich muss Kundensupport-Tickets verfolgen. Jedes hat einen Betreff, eine Beschreibung, eine Priorität (niedrig/mittel/hoch/dringend), einen Status und einen Bearbeiter. Füge eine Kanban-Ansicht hinzu, gruppiert nach Status."

Die KI schlägt einen Plan vor, Sie genehmigen ihn, und die Metadaten sind aktiv — REST-Endpunkte, Console-Ansichten, Audit-Log-Einträge, Berechtigungsschranken. Keine Datei bearbeitet, kein Neustart. Siehe Build → AI Builder für das vollständige Vokabular.

Handcodierung in Ihrer IDE? Führen Sie npx skills add objectstack-ai/framework aus, um Claude Code / Cursor / Copilot / Codex beizubringen, wie man ObjectOS-Metadaten gegen die echten Zod-Schemas verfasst. Siehe Build → IDE Skills.

Eine App aus dem marketplace installieren

Öffnen Sie http://localhost:3000/_console/, melden Sie sich an und wählen Sie eine App aus:

Installieren → neu laden → schon ist sie da, mit ihren Objekten, Ansichten, Berechtigungen und Beispieldaten. Kein Neustart erforderlich.

Häufige Flags

os start --port 3200                       # different port
os start --database postgres://...         # external database
os start --auth-secret "$(openssl rand -hex 32)"  # enable auth in /api/v1/auth/*
os start --home /var/lib/objectos          # persistent home (production)

Siehe Runtime Configuration für jede Option und Docker für den produktionsnahen Weg.

Pfad B — os init (Entwickler)

Verwenden Sie dies, wenn Sie TypeScript schreiben, um Ihr eigenes Datenmodell, Ihre Ansichten und Flows zu definieren.

npx @objectstack/cli init my-app -t app --install
cd my-app
pnpm dev

Sie sehen:

✓ Project initialized!

◆ Compile
  ✓ Build complete (462ms)
  Data: 1 Objects  3 Fields

◆ Development Mode
  ✓ Server is ready

  ➜  API:       http://localhost:3002/
  ➜  Console:    http://localhost:3002/_console/
  ➜  Account:   http://localhost:3002/_account/
  ➜  Console:   http://localhost:3002/_console/

Beachten Sie, dass der Dev-Server Port 3002 verwendet, um eine Kollision mit einem laufenden os start auf Port 3000 zu vermeiden.

Fügen Sie Ihr eigenes Objekt hinzu

Bearbeiten Sie src/objects/task.ts:

// src/objects/task.ts
import { ObjectSchema, Field } from '@objectstack/spec/data';

export const Task = ObjectSchema.create({
  name: 'task',
  label: 'Task',
  fields: {
    subject:   Field.text({ label: 'Subject', required: true, maxLength: 200 }),
    done:      Field.boolean({ label: 'Done', defaultValue: false }),
    due:       Field.date({ label: 'Due' }),
    assignee:  Field.lookup({ label: 'Assignee', reference: 'sys_user' }),
  },
});

Speichern. Der Dev-Server kompiliert neu, und Sie haben sofort:

• /api/v1/data/task — vollständiges CRUD mit Filtern/Sortieren/Paginieren
• Eine „Task"-Ansicht in der Console — Liste, Formular, Detailansicht, alles generiert
• Berechtigungszeilen in der Console — gewähren Sie Lese-/Schreibzugriff pro Rolle
• Audit-Log-Einträge — jedes Anlegen/Aktualisieren/Löschen wird erfasst

Keine Migrationen. Keine Codegenerierung. Kein Neustart.

Projektaufbau

my-app/
├── objectstack.config.ts    # Stack definition (manifest + objects)
├── src/
│   └── objects/             # Your data model — add files here
├── dist/
│   └── objectstack.json     # Compiled artifact (regenerated on save)
├── package.json
└── tsconfig.json

dist/objectstack.json ist das, was Sie in die Produktion ausliefern — binden Sie es in einen laufenden ObjectOS-Container ein, und das wird zu Ihrer App.

Oder starten Sie von einer Vorlage

Produktionsnahe Starter befinden sich unter github.com/objectstack-ai/templates:

git clone https://github.com/objectstack-ai/templates.git
cd templates/packages/todo
pnpm install
pnpm dev    # http://localhost:4002

Jede Vorlage umfasst weniger als 2500 LOC, ist in einer Sitzung lesbar und läuft eigenständig.

Was standardmäßig geladen wird

Beide Pfade geben Ihnen diese 23 Plugins automatisch:

Auth, Security (RBAC + RLS + FLS), Audit, REST API, Console UI, Account UI, Console UI, AI Service, Queue, Jobs, Cache, Settings, Email, Storage, Marketplace, Metadata, ObjectQL, plus dem SQL-Treiber.

Sie importieren oder verdrahten keines davon — sie werden aktiviert, wenn etwas deklariert, dass es sie benötigt.

Nächste Schritte