18 KiB
HiveGrid Website — Rework-Mapping
Arbeitsgrundlage für Team + KI-Agenten während des Landing-Reworks. Nicht für User. Lebendes Dokument — bei Bedarf anpassen.
Zweck: Mapping-Arbeit sichtbar machen — welche Sektion existiert wo, in welchem Zustand, was ist zu tun, welche Referenzen. So können Dejan, Haris, David und die KI parallel und ohne Rückfragen weiterarbeiten.
Team & Rollen
| Person | Rolle |
|---|---|
| Dejan | Grundgerüst, Layout, Elemente, Animationen, Infra, Deployment |
| Haris | Marketing-Texte. Kommt ins Spiel, sobald Dejan das Grundgerüst mit Platzhaltern gebaut hat und die Placeholder gegen finale Texte getauscht werden. |
| David | Screens/Screenshots (teils animiert) aus der echten HiveGrid-Software. Ersetzen die aktuellen Placeholder-Screens. |
| Noah | Mitgründer / Handwerksmeister. Ansprechpartner für Content-Entscheidungen (Newsletter, Testimonial-Video, Story). |
Environments
Live — hivegrid.de
- Aktuell noch der v1-Stand von damals.
- Deployed aus Branch
mainvia.gitea/workflows/deploy.yml→ Coolify (App-UUIDd108flfj9rk5hdm6p4b85er7).
Dev — dieser Repo, Branch dejan
- Aktueller Arbeits-Branch.
- Route
/playground= Prototyp der neuen Landing. Wird später zur Startseite (/). - Die aktuelle
/= Ableger von v1, bleibt bis Playground produktionsreif ist. - Playground ist in Production per
notFound()gesperrt +noindex(sieheapp/playground/page.tsx).
Vorlage / Inspiration
/Users/dejancosic/Downloads/hivegrid-v3.html— Haris' Vorarbeit, lokal auf Dejans Rechner (nicht im Repo).- Nur zur Inspiration. Keine finalen Texte, Reihenfolge nicht bindend.
User-Journey (Zielaufbau der neuen Landing)
Reihenfolge auf /playground iterieren, dann in die echte Landing migrieren. Jede Sektion ist unten mit Element-Referenz, Code-Pfad, Status und offenen Punkten gemapped.
1. Hero — Menschlichkeit
- Idee: echtes Foto oder kurze Video-Aufnahme aus unserem Büro. Kein rendered Dashboard-Screenshot mehr. Transportiert Schlichtheit + „vom Handwerker für den Handwerker", nicht vibe-coded.
- Referenzen (Inspiration):
- https://pro.bsport.io — schlichter Foto-Hero
- https://plancraft.com/de-de — Handwerker-Fokus mit echten Aufnahmen
- Aktuell auf
/playground: Text-Hero „Verknüpfen statt ersetzen" mit Honeycomb rechts — wandert zu Sektion 2. - TODO:
- Hero neu bauen als Foto/Video-First-Hero
- Asset von David (Bürofoto/-video)
- Kernbotschaft-Copy von Haris
2. Pain-Point — „Verknüpfen statt ersetzen"
- Element: Honeycomb mit Tool-Logos (kwp, DATEV, Google Drive, Teams, Outlook, Google Calendar) + zentralem HiveGrid-Hub, verbunden über glimmende Datenlinien.
- Code:
app/playground/HoneycombSection.tsx - Status: gebaut ✅ (bare + inline Varianten für lg+ und <lg)
- Details: Kernbestandteil dieser Sektion. Drum herum: spezifische Probleme + spezifische Zahlen (Copy von Haris).
3. Lösungen — ScreenshotAccordion („Scroller")
- Element: Interaktiver Modul-Scroller. Links Accordion mit Modul-Namen, rechts Screenshot des aktiven Moduls. Auto-Cycle + Klick.
- Code:
components/sections/ScreenshotAccordion.tsx - Aktuell auf
hivegrid.de: Module „Verwaltung, Planung, Baustelle, Services" mit Screenshots pro Modul. - Status: existiert ✅ — Content pflegen (Module + Verweise auf
/produkt/*) - TODO:
- Placeholder-Screens (
public/images/screenshot-*.webp) durch echte Software-Screens von David ersetzen - ggf. Modul-Liste an neue Produkt-Struktur angleichen
- Placeholder-Screens (
4. Noahs Geschichte
- Element: Dark Section mit Noah-Foto + Gründer-Story-Text.
- Code:
app/playground/PlaygroundClient.tsx(Story-Section,#0f1a2eBackground, 2-Col-Layout ab lg) - Status: existiert auf
/playground✅, aber muss umgebaut und cooler werden. - TODO:
- Design-Overhaul (Prototyp auf
/playgrounditerieren) - Idee: Video statt/zusätzlich zum Foto — Noah erzählt die Story on-camera
- Text-Feinschliff mit Haris
- Design-Overhaul (Prototyp auf
5. Vergleich — HiveGrid vs. andere Lösungen
- Element: Existiert bereits in Haris' Vorlage
/Users/dejancosic/Downloads/hivegrid-v3.html - Status: nach
/playgroundportieren - TODO: Element aus HTML-Vorlage übernehmen, in HiveGrid-Tokens/Tailwind übersetzen, in Playground einbauen
6. DSGVO-Sicherheit — Pattern Interruption
- Element: Auch in Haris' HTML-Vorlage
- Details: „Pattern Interruption" = bewusster Design-Bruch. Andere Farbe als Brand Identity (nicht Yellow/Teal), damit das Auge stolpert und die DSGVO-Message hängen bleibt. Ist so gewollt und soll bleiben.
- Status: nach
/playgroundportieren - TODO: Übernehmen aus HTML-Vorlage, Farb-/Style-Bruch beibehalten
7. FAQ
- Element: Accordion-FAQ
- Code:
components/sections/FAQSection.tsx, Daten inlib/faqs.ts - Status: existiert auf live und dev ✅ — passt so
- TODO: keine (evtl. Content-Refresh mit Haris)
8. CTAs — „Understory"-Style vereint mit HiveGrid-Design
- Referenzen:
- Style-Idee: https://www.cta.gallery/cta/understory
- Demo-Flow: https://pro.bsport.io/de/demo
- Aktuell auf live: gelbe CTA-Section mit „Demo buchen" + „Kontakt" Buttons (siehe
components/ui/CTABanner.tsx) - Plan: Kombinieren
- Understory-Layout (cooles Bild + starke Headline + CTA-Reihe)
- HiveGrid-Farben (gelber Section-BG wie aktuell live)
- Beide Buttons: „Demo buchen" (primär → Lead-Formular) + „Kontakt" (sekundär)
- TODO:
CTABanner.tsxerweitern um Image-Slot- Bild-Asset von David
- Layout an Understory anlehnen, Style-Tokens (Yellow) behalten
9. Lead-Formular im Footer
- Referenz: https://tool-ctrl.de — Footer-Formular
- Aktuell auf live: Lead-Formular nur unter
/demo. Footer hat nur Newsletter + Links. - TODO:
- Formular in
components/layout/Footer.tsxeinbauen (analog tool-ctrl.de Footer) - Dasselbe Backend nutzen wie
/demo→POST /api/demo-request(siehe Lead-Flow unten)
- Formular in
10. Newsletter
- Status: TBD mit Noah — entscheiden ob Newsletter bleibt oder raus.
- Aktuell: Newsletter-Signup in
components/layout/Footer.tsxeingebaut (+ Flow-Seiten unter/newsletter/*). - TODO: Abstimmung Noah → Entscheidung ja/nein → ggf. Newsletter-UI + Routes entfernen
Element-Inventar & Cross-Mapping
Chronologisches Inventar jeder der drei Landingpages, gefolgt von einer Cross-Mapping-Tabelle, die zeigt welche Sektion welchen Zweck auf welchem Stand erfüllt. Basis für die Entscheidungen: übernehmen / umbauen / droppen / verschieben.
Inventar — hivegrid.de (Live, v1)
Quelle: app/page.tsx auf main.
| # | Element (Code) | Beschreibung | Zweck |
|---|---|---|---|
| 1 | HeroSection |
Badge „SHK-SOFTWARE", Headline „Ihr Betrieb läuft organisiert, automatisiert und effizient.", Sub-Copy, 2 CTAs, Dashboard-Screenshot rechts, heyData-DSGVO-Siegel als Overlay | Wertversprechen + Handlungsaufforderung |
| 2 | ScreenshotAccordion |
Badge „LÖSUNG"; „Der effizienteste Planungs- und Vertriebsprozess."; Modul-Accordion (Verwaltung / Planung / Baustelle / Services) mit Auto-Cycle + Screenshot rechts | Module durchklickbar zeigen |
| 3 | FeaturesGrid |
6 Feature-Cards mit Lucide-Icons (die 6 Produkte) | Produkt-Overview |
| 4 | ChatDemoSectionClient |
Interaktive Phone-Preview mit Rules-basierten Antworten aus lib/chat-demo/assistant.ts |
„Wie fühlt sich das an"-Demo |
| 5 | HowItWorksSection |
4 Schritt-Karten (01–04) mit Screens: Workflow erstellen → Trigger → Aktionen → Aktivieren | Prozess erklären |
| 6 | AdvantagesSection |
4 Vorteil-Kacheln (DSGVO, Mobile, Speed, Support) + heyData-Siegel | Trust / USPs |
| 7 | CTABanner (1) |
„Bereit, Ihren Betrieb zu digitalisieren?" — 1 CTA (Demo) | Mid-Page-CTA |
| 8 | FAQSection |
6 FAQ (Datenquelle: lib/faqs.ts) |
Einwände abbauen |
| 9 | CTABanner (2) |
„Starten Sie jetzt mit HiveGrid." — Demo + Kontakt | Final-CTA |
Inventar — /playground (Dev, Branch dejan)
Quelle: app/playground/PlaygroundClient.tsx.
| # | Element (Code / Ort) | Beschreibung | Zweck |
|---|---|---|---|
| 0 | Dev-Marker (inline) | Gelber Streifen „DEV PLAYGROUND — nicht live" | Kennzeichnung als Prototyp |
| 1 | Hero (inline) + HoneycombSection |
„Verknüpfen statt ersetzen." mit Yellow-Highlight, 2 CTAs; Honeycomb als Full-Bleed-BG rechts (lg+) bzw. inline unter Text (<lg) | Hook + Kernbotschaft + Tool-Visual |
| 2 | Noah-Story (inline) | Dark Section (#0f1a2e), Noah-Foto + Story „Die Geschichte fängt auf der Baustelle an." + Autor-Card |
Social Proof / Origin |
| 3 | Feature-Grid (inline) | 6 Feature-Karten (analog Live, Placeholder-Text) | Produkt-Overview |
| 4 | Stats-Section (inline) | 3 GSAP-Count-Up KPIs (1200+ Betriebe, 8 Std/Woche gespart, 99,9 % Verfügbarkeit) | Zahlen-Wirkung |
| 5 | How-it-works (inline) | 3 Schritt-Karten mit scrub-Progress-Linie (Einrichten / Verbinden / Automatisieren) | Prozess minimalistisch |
| 6 | Dark CTA banner (inline) | „Ein Call-to-Action mit Nachdruck." — Demo + Kontakt | Mid/Final-CTA |
| 7 | FAQ (inline, playground-eigene 4 Fragen) | Placeholder-<details> |
FAQ als UI-Demo, kein Live-Content |
Inventar — hivegrid-v3.html (Haris' Vorlage)
Quelle: /Users/dejancosic/Downloads/hivegrid-v3.html. Nur Landing (Modul-Page und globaler Footer weggelassen).
| # | Element (v3) | Beschreibung | Zweck |
|---|---|---|---|
| 1 | Hero | „Dein ganzer Betrieb. Endlich auf einen Blick." Gründer-Illustration (2 Handwerker Rücken-an-Rücken), 2 CTAs, 3 Trust-Badges, Float-Badge „∞ Eine Plattform statt 7 Insellösungen" | Wertversprechen + Menschlichkeit |
| 2 | Proof Strip | Partner-Logo + Stats „7 → 1 Programme" + Zeit-Ersparnis | Instant Social Proof |
| 3 | Problem Section | „Das Problem: Wechseln? Lieber nicht." 3 Cards + Chaos-Visual (7 zerstreute Tools) | Pain-Point konkret machen |
| 4 | Solution Section | „Die Lösung: Wir bauen auf dem auf, was du schon hast." 3 Bullets + Workflow-Flow-Diagramm | Lösungs-Positioning |
| 5 | Story Section | Navy-BG, Noah-Foto, Story + 3 Stats (7 Programme → 1 Plattform → X Std/Woche) | Social Proof + Origin |
| 6 | Compare Section | „Andere Lösungen vs. HiveGrid" — 2-Spalten-Vergleich mit X/✓, EMPFOHLEN-Pill | Wettbewerbs-Abgrenzung |
| 7 | Trust Band | Teal-BG (Pattern Interruption); Deutschland-Flagge + „100 % Made in Germany" + 4 Trust-Items | Vertrauen (DSGVO) mit visuellem Bruch |
| 8 | Final CTA | Navy-BG „In 30 Minuten siehst du deinen ganzen Betrieb" + 2 CTAs (Demo + Erstgespräch) + „Kein Vertrag / keine Kreditkarte" | Final-Aktion |
| 9 | About Founders | „Über uns: Zwei Welten. Ein Team." 2 Gründer-Kacheln (Handwerk & Technik) | Team-Vorstellung |
Cross-Mapping (Zweck × Stand)
Zeigt für jeden Zweck / jede Journey-Rolle, welche Sektion sie auf welchem Stand erfüllt. Leere Zelle = nicht vorhanden.
| Zweck / Journey-Punkt | hivegrid.de (Live) | /playground (Dev) | v3.html (Haris) |
|---|---|---|---|
| Hook / Wertversprechen (Hero) | #1 HeroSection (Dashboard-Screenshot) | #1 Text-Hero + Honeycomb | #1 Gründer-Illustration + Float-Badge |
| Instant Social Proof | — | — | #2 Proof Strip |
| Pain-Point (Journey 2) | — | #1 Honeycomb (visuell) | #3 Problem + Chaos-Visual |
| Lösungs-Positioning | — | — | #4 Solution + Flow-Diagramm |
| Modul-Übersicht als Scroller (Journey 3) | #2 ScreenshotAccordion ✅ |
— | (auf v3-Modul-Page, nicht Landing) |
| Produkt-Cards (Sekundär-Overview) | #3 FeaturesGrid |
#3 Feature-Grid | — |
| Chat-Demo (Live-only) | #4 ChatDemoSectionClient |
— | — |
| Wie funktioniert's | #5 HowItWorksSection |
#5 How-it-works | (in Solution enthalten) |
| KPI-Zahlen | — | #4 Stats (GSAP Count-up) | (in Story enthalten) |
| Trust / Vorteile | #6 AdvantagesSection + heyData |
— | #7 Trust Band |
| Story / Noah (Journey 4) | — | #2 Dark Story | #5 Navy Story |
| Vergleich vs. andere (Journey 5) | — | — | #6 Compare Section ✅ |
| DSGVO + Pattern Interruption (Journey 6) | (nur als Kachel in Advantages) | — | #7 Teal Trust Band ✅ |
| FAQ (Journey 7) | #8 FAQSection ✅ |
#7 (Placeholder-Content) | — |
| CTAs (Journey 8) | #7 + #9 CTABanner |
#6 Dark CTA | #8 Navy Final CTA |
| Über uns / Team | (eigene Page /ueber-uns) |
— | #9 About Founders |
Legende: ✅ = bevorzugte Quelle für die neue Landing.
Beobachtungen zur weiteren Diskussion:
- v3-Elemente Proof Strip (#2), Problem (#3), Solution (#4) existieren aktuell weder auf Live noch auf Playground → komplett neu bauen oder aus HTML portieren
- Compare (#6, v3) und Trust Band mit Pattern Interruption (#7, v3) existieren nur auf v3 → aus HTML portieren (siehe Journey-Punkte 5 & 6)
- ChatDemo existiert nur auf Live → Entscheidung: übernehmen oder droppen? (nicht in Journey enthalten)
- HowItWorksSection existiert auf Live und Playground → auf Playground stark reduziert (3 statt 4 Schritte, minimalistischer). Entscheidung: welche Version behalten?
- AdvantagesSection (Live) und v3 Trust Band überlappen konzeptionell → nur eine Variante auf der neuen Landing
- Playground-Hero (Text + Honeycomb) wird laut Journey verschoben: Hero (1) wird echtes Foto/Video, Honeycomb rutscht in Sektion 2 (Pain-Point)
Content-Status
- Alle Texte auf
/playgroundsind Platzhalter (Lorem / wip-Wording). - Placeholder-Screens liegen in
public/images/screenshot-*.webpundpublic/images/step-*.webp. Werden durch Davids echte Screens ersetzt. - Finale Texte kommen von Haris, sobald das Grundgerüst steht.
Konvention: Platzhalter mit TODO(haris) oder // PLACEHOLDER markieren, damit sie beim Text-Swap gefunden werden. Placeholder-Screens einheitlich in public/images/ benennen.
Lead-Flow
Details: app/api/demo-request/route.ts + lib/db/demo-requests.ts
Form → POST /api/demo-request
↓
forwardToInbox() ← primary
→ POST {LEAD_INBOX_URL}/v1/leads
Authorization: Bearer {LEAD_INBOX_KEY}
↓ (ok?)
ja → ✅ fertig
nein → insertDemoRequest() → /app/data/demo-requests.db (SQLite fallback)
LEAD_INBOX_URL+LEAD_INBOX_KEYals Env-Vars in Coolify setzen → Leads gehen an die zentrale Inbox.- ⚠️ SQLite-Fallback ist ephemer: In
infrastructure/docker-compose.production.ymlist kein Volume für/app/datagemountet → jedes Deployment löscht die Fallback-DB. TODO:hivegrid_leads:/app/dataVolume ergänzen, falls Fallback verlässlich sein soll. - Kein Admin-UI: Fallback-Leads nur via
docker execauslesbar.
SEO — Fundament erledigt
Siehe Commit d84175e feat(seo): SEO foundation.
Geliefert:
robots.ts,sitemap.ts,manifest.ts,opengraph-image.tsx(+ twitter re-export)- JSON-LD global:
Organization,WebSite; Home:FAQPage; Produktseiten:SoftwareApplication+BreadcrumbList - Erweiterte Metadata + Canonical + Twitter Cards + Security Headers
- Client-only Pages (
/kontakt,/demo,/newsletter/abmelden) in Server-Wrapper +*Form.tsxgesplittet, damitmetadataexportierbar - Hero-Screenshot auf
next/imagemitpriority(LCP-Win)
Offen:
- Google Search Console: Verifizierungs-Token in
app/layout.tsx→metadata.verification.googleeintragen. - Optional: statisches
og-default.png(aktuell wird OG-Bild programmatisch generiert). - Rechtlich klären:
/agb-Body nennt „HiveGrid GmbH" + „Gerichtsstand Hamburg",/impressumsagt „R&D² UG (haftungsbeschränkt)" in Bruchsal. Ausrichten.
Konventionen
- Sprache: UI = Deutsch. Code-Kommentare = Englisch.
- Next.js 16: breaking changes zu älteren Versionen — vor Code-Änderungen Docs in
node_modules/next/dist/docs/prüfen (sieheAGENTS.md). - Prototyping: neue Sektionen/Animationen zuerst auf
/playgroundbauen, dann in die echte Landing übernehmen. - Tailwind v4 (
@tailwindcss/postcss), Design-Tokens inapp/globals.cssals CSS-Variablen. - Animationen: GSAP +
useGSAPin Client Components, alles hinterprefers-reduced-motiongaten.
Roadmap
Build (Dejan / KI):
- SEO Foundation
- Playground scaffolding (Hero mit Honeycomb, Noah-Story, Feature-Grid, Stats, How-it-works, CTA, FAQ)
- Hero (1) neu bauen als Foto/Video-First-Hero
- Pain-Point-Sektion (2) um Honeycomb herum bauen (Text + Zahlen)
- ScreenshotAccordion (3) auf Playground einbauen, an neue Produkt-Struktur angleichen
- Noah-Story (4) redesignen (Prototyp-Iterationen)
- Vergleichs-Sektion (5) aus Haris' HTML portieren
- DSGVO-Sektion (6) mit Pattern Interruption aus Haris' HTML portieren
- CTA-Sektion (8) im „understory"-Stil bauen (Image-Slot in
CTABanner.tsx) - Lead-Formular in Footer (9) integrieren
- Playground → echte Landing migrieren (
/playgroundContent wird zu/)
Content / Assets:
- Haris: Platzhalter-Texte durch finalen Content ersetzen (
TODO(haris)Marker suchen) - David: Bürofoto/-video für Hero (1)
- David: echte Software-Screens für ScreenshotAccordion (3) → ersetzen
public/images/screenshot-*.webp - David: Bild für neue CTA-Sektion (8)
- Noah: Entscheidung Newsletter ja/nein (10)
- Noah: ggf. Testimonial-Video für Story-Sektion (4)
Infra / Legal:
- Lead-Inbox Volume-Mount in production docker-compose (falls SQLite-Fallback zählen soll)
- Rechtliche Entity-Klärung (GmbH vs. UG) → AGB-Body + Footer-Copyright angleichen
- Google Search Console verifizieren + Token in
metadata.verification.googleeintragen
Release:
- Merge
dejan→main→ Deploy → hivegrid.de auf neue Version
Nützliche Referenzen
- Repo: https://git.tool-ctrl.de/toolctrl-labs/HiveGrid-Website
- Live: https://hivegrid.de
- Coolify (Deploy): App-UUID
d108flfj9rk5hdm6p4b85er7 - Deploy-Workflow:
.gitea/workflows/deploy.yml - Design-Tokens:
app/globals.css - Produkt-Daten:
lib/produkt-daten.ts - FAQ-Daten:
lib/faqs.ts - Site-Config (Nav, Footer, Produkte):
lib/site.config.ts