Schnellstart

Du entwickelst Projekte mit Tibi, nicht Tibi selbst. Go-Code vom tibi-server und Svelte-Code vom tibi-admin fasst du dafür nicht an. Dein Startpunkt ist immer der Starter.

Kern-Regel aus dem Starter

Dev-Server laufen immer in Docker. Nie yarn dev oder yarn start lokal.

Voraussetzungen

git, yarn, make, docker compose, curl. Arbeit auf dem Code-Server mit *.code.testversion.online.

1. Klonen

Starter klonen

git clone https://gitbase.de/cms/tibi-svelte-starter.git mein-projekt
cd mein-projekt
git remote rename origin template
git remote add origin https://gitbase.de/<org>/<repo>.git

2. Platzhalter ersetzen

In .env, api/config.yml, api/hooks/config-client.js, package.json und frontend/.htaccess (falls genutzt):

• __PROJECT_NAME__ → kebab-case, z. B. mein-projekt
• __TIBI_NAMESPACE__ → snake_case, z. B. mein_projekt
• __ORG__, __PROJECT__ → Gitea-Org und Repo

Prüfen:

Platzhalter prüfen

rg '__[A-Z0-9_]+__' . --glob '*.{yml,js,env,htaccess,json,md,ts,svelte}'

Es darf nichts mehr finden. Sonst ist das Setup nicht fertig.

3. Token erzeugen

Token erzeugen

token=$(openssl rand -hex 20)
cat > api/config.yml.env <<EOF
ADMIN_TOKEN=$token
ADMIN_ASSET_VERSION=$(node -e "process.stdout.write(require('crypto').randomBytes(6).toString('hex'))")-dirty-$(date +%s)
EOF

Trage in .env die Projekt-URLs ein: LIVE_URL, CODING_URL, STAGING_URL, CODING_TIBIADMIN_URL.

4. Starten

Stack starten

yarn install
make docker-up

Vordergrund bei Problemen: make docker-start. Logs: make docker-logs.

5. Erreichbarkeit prüfen

Erreichbarkeit prüfen

curl -I "$CODING_URL"
curl -I "$CODING_TIBIADMIN_URL"
curl -I "$CODING_URL/api/content?limit=1"

• HTML statt JSON unter /api/... → Proxy/Setup noch falsch.
• project not found → Projektdateien liegen da, aber das Projekt ist im laufenden tibi-server noch nicht registriert. Siehe Neues Projekt Schritt 5.

Anmeldung im Admin lokal: admin / admin.

6. Bauen und validieren

Bauen und validieren

yarn validate
yarn build
yarn build:server

Alle drei müssen fehlerfrei durchlaufen. yarn nutzt du nur für diese drei — nie für Dev-Server.

Token-Köpfe (nicht vermischen)

Wofür	Kopf	Wert
Sammlung lesen/schreiben (z. B. Inhalte)	Token	ADMIN_TOKEN aus api/config.yml.env
Eigener Benutzer (JWT)	X-Auth-Token	Token aus POST /api/v1/login
Projekt anlegen/laden (System)	X-Auth-Token (JWT als admin) oder X-Admin-Token	nur wenn Server-Token vorhanden
Deploy-Reload auf Live/Staging	Authorization: Bearer	ADMIN_TOKEN

Weiter: Neues Projekt aufsetzen mit Registrierung, Pfad A/B und Checkliste.

Verifiziert am e3f92eb 2026-10-17 (tibi-svelte-starter), am 68b4278 2026-10-17 (tibi-server)