David Latz DL

Profile ins Repo einpflegen

Du legst einen Ordner pro Akteur an, schreibst eine kurze profile.md, ziehst Bilder dazu und pushst. Der Prototyp auf heimatdesign-guidetothewest.vercel.app liest die Daten automatisch beim nächsten Build und zeigt das Profil unter /verzeichnis/<ordnername>.

Wie das funktioniert

Es gibt kein CMS-Backend in dieser Phase. Alle Profile leben direkt im Repo als Markdown-Dateien plus Bildern. Beim Push baut Vercel die Site neu, scannt den Profil-Ordner und rendert die Daten in die Plattform.

Dein Workflow ist immer derselbe:

Ordner mit dem gewünschten URL-Slug anlegen, z.B. kaschkasch, folkwang-design
profile.md ausfüllen (Vorlage liegt bereit)
Hero-Bild plus optional weitere Bilder dazulegen
In GitHub Desktop committen und pushen — fertig

1. Profil-Ordner anlegen

Im Repo (das du via GitHub Desktop schon gepullt hast) zum Verzeichnis prototype/pilot-profiles/ navigieren. Dort liegen schon die _template/-Vorlage und das erste Profil jan-kath/.

Im Finder: Ordner _template/ kopieren
Eingefügten Ordner umbenennen in den gewünschten Slug. Konvention:
- Kleinbuchstaben, Bindestriche statt Leerzeichen
- Keine Umlaute (müller-studio → mueller-studio)
- Keine Sonderzeichen außer Bindestrich
- Beispiele: kaschkasch, jan-kath, creative-nrw
Der Slug wird Teil der URL: /verzeichnis/kaschkasch

2. profile.md ausfüllen

Die Datei hat zwei Teile: oben das Frontmatter (Pflichtfelder zwischen ----Linien), darunter den redaktionellen Text in Markdown.

Hier ist eine vollständige Vorlage zum Kopieren:

---
name: "Studio-Name"
profiltyp: "designer"
stadt: "Köln"
hero: "hero.jpg"

# Optional
gegruendet: 2018
website: "https://studio-name.de"
team_groesse: "5–10"

kontakt:
  email: "kontakt@studio-name.de"
  telefon: "+49 ..."

social:
  instagram: "https://instagram.com/handle"
  linkedin: "https://linkedin.com/company/handle"

disziplinen:
  - "Produktdesign"
  - "Branding"

tags:
  - "nachhaltig"
  - "regional"

status: "draft"
---

# {{ name }}

## Kurzbeschreibung

> Ein bis zwei Sätze, die das Profil ausmachen. Kuratorisch, mit Haltung.

## Langtext

Ausführlicher redaktioneller Text. Mehrere Absätze möglich. Hier kommen Geschichte, Methode,
besondere Projekte, Atmosphäre des Studios, Verbindungen zur Region — alles, was den
Akteur kuratorisch greifbar macht.

## Referenzprojekte

### Projekt 1 — Titel

**Kategorie:** Produktdesign
**Bild:** projekt-1.jpg

Kurzbeschreibung des Projekts.

Was bedeuten die Felder?

Feld	Was rein kommt
`name`	Anzeigename. Wie er auf der Plattform erscheint.
`profiltyp`	Einer von: `designer`, `agentur`, `shop`, `akademie`, `hochschule`, `hersteller`, `wirtschaftsfoerderung`
`stadt`	Köln, Düsseldorf, Dortmund, Essen, Münster, Bochum (oder weitere — dann sag Bescheid)
`hero`	Dateiname des Hero-Bilds, das im selben Ordner liegt
`status`	`draft`, `pending`, `live` — Phase 1 zeigt alle
`website`, `kontakt.`, `social.`	Optional, wird im Profil-Detail verlinkt
`tags`, `disziplinen`	Freie Schlagworte, helfen bei Filtern und Cross-Linking

Mehrere Profil-Typen oder Städte: Wenn ein Akteur z.B. sowohl Designer als auch Hersteller ist, schreib "designer | hersteller". Der primäre Wert (links) wird für die Plattform-Logik genutzt (z.B. Preisstaffel). Beim CMS-Wechsel im Sommer wird das ausgebaut.

3. Bilder dazulegen

Hero-Bild

Eine Datei (z.B. hero.jpg oder hero.png) direkt in den Profil-Ordner ziehen. Diese Datei wird auf der Profilseite groß oben gezeigt und in Verzeichnis-Cards.

Format: JPG, PNG oder WebP — JPG bevorzugt für Fotos
Format-Verhältnis: ungefähr 3:2 oder 16:9 (quer)
Größe: mindestens 1.600 px Breite, gerne mehr
Im Frontmatter: hero: "hero.jpg"

Galerie-Bilder

Zwei Wege, beide funktionieren:

Einfach: alle weiteren Bilder direkt in den Profil-Ordner. Sie werden automatisch als Galerie erkannt.
Aufgeräumt: einen Unterordner galerie/ anlegen und die Bilder dort reinlegen.

Bei beiden Wegen entstehen die Galerie-Slots automatisch in der Profilseite.

Tipp: Verwende sprechende Dateinamen wie moebel-eichenholz.jpg statt IMG_4523.JPG — der Dateiname wird als Bildbeschreibung (Alt-Text) genutzt.

4. In GitHub Desktop committen und pushen

GitHub Desktop öffnen, Repo Heimatdesign/Guidetothewest auswählen
Links siehst du alle neuen / geänderten Dateien — Häkchen bei den richtigen setzen
Unten Commit-Message eingeben, z. B. Profil KASCHKASCH hinzugefügt
Commit to main klicken
Oben mittig: Push origin — fertig

Vercel erkennt den Push und baut die Plattform neu. Nach 1–2 Minuten ist dein Profil live unter https://heimatdesign-guidetothewest.vercel.app/verzeichnis/<dein-slug>.

Bei der allerersten Aktion: schau zur Sicherheit nochmal in Inhalte ins Repo bringen — dort steht der GitHub-Desktop-Workflow im Detail.

Beispiel — Jan Kath

Schau dir prototype/pilot-profiles/jan-kath/ im Repo an — dort siehst du eine vollständig ausgefüllte Vorlage mit Hero, Galerie, Frontmatter und redaktionellem Text. Live dann unter heimatdesign-guidetothewest.vercel.app/verzeichnis/jan-kath.

Wenn du ein neues Profil anlegst, ist das deine beste Referenz: einfach die Struktur kopieren und Inhalte austauschen.

Wenn etwas nicht funktioniert

Profil erscheint nicht nach Push: 1–2 Minuten warten — Vercel braucht Zeit für den Build. Wenn nach 5 Minuten nichts passiert: ruf an, ich schau in die Build-Logs.
Bilder werden nicht angezeigt: Sind sie wirklich im Profil-Ordner abgelegt? Stimmt der Dateiname im hero:-Feld exakt? Groß-/Kleinschreibung beachten.
Frontmatter wird nicht erkannt: Achte auf die zwei ----Linien oben und unten. Keine Tabs, nur Leerzeichen für Einrückung. Notfalls die Vorlage 1:1 neu kopieren.
Profilseite zeigt "404": Der Ordnername ist der Slug. Prüfe, ob der Ordner im Repo angekommen ist (im Browser auf github.com/Heimatdesign/Guidetothewest/tree/main/prototype/pilot-profiles schauen).

Bei jeder Unsicherheit: kurze Nachricht an mich. Ich kann auch via Screen-Share durch das erste Profil führen, damit das einmal sitzt.