managarten/apps/uload/docs/cards
Wuesteon d36b321d9d style: auto-format codebase with Prettier
Applied formatting to 1487+ files using pnpm format:write
  - TypeScript/JavaScript files
  - Svelte components
  - Astro pages
  - JSON configs
  - Markdown docs

  13 files still need manual review (Astro JSX comments)
2025-11-27 18:33:16 +01:00
..
api-reference.md refactor: restructure 2025-11-26 03:03:24 +01:00
architecture.md refactor: restructure 2025-11-26 03:03:24 +01:00
components.md style: auto-format codebase with Prettier 2025-11-27 18:33:16 +01:00
examples.md style: auto-format codebase with Prettier 2025-11-27 18:33:16 +01:00
implementation-comparison.md refactor: restructure 2025-11-26 03:03:24 +01:00
modules.md refactor: restructure 2025-11-26 03:03:24 +01:00
README.md style: auto-format codebase with Prettier 2025-11-27 18:33:16 +01:00
server-side-html-cards.md refactor: restructure 2025-11-26 03:03:24 +01:00
templates.md refactor: restructure 2025-11-26 03:03:24 +01:00
themes.md refactor: restructure 2025-11-26 03:03:24 +01:00
unified-cards-migration.md refactor: restructure 2025-11-26 03:03:24 +01:00

Card System Dokumentation

Übersicht

Das Card System in uload ist eine flexible, modulare Architektur für die Erstellung und Verwaltung von wiederverwendbaren UI-Karten. Es ermöglicht die Erstellung von dynamischen, themebaren und vollständig konfigurierbaren Karten für verschiedene Anwendungsfälle.

Inhaltsverzeichnis

  1. Architektur
  2. Komponenten
  3. Module
  4. Themes
  5. Templates
  6. API Reference
  7. Beispiele

Schnellstart

Basis-Verwendung

<script>
	import BaseCard from '$lib/components/cards/BaseCard.svelte';

	const cardConfig = {
		variant: 'default',
		modules: [
			{
				type: 'header',
				props: {
					title: 'Meine Karte',
					subtitle: 'Eine Beispielkarte',
				},
			},
		],
	};
</script>

<BaseCard {...cardConfig} />

Hauptkonzepte

1. BaseCard

Die zentrale Komponente, die als Container für alle Kartentypen dient.

2. Module

Wiederverwendbare Bausteine, aus denen Karten zusammengesetzt werden:

  • HeaderModule
  • ContentModule
  • LinksModule
  • MediaModule
  • StatsModule
  • ActionsModule
  • FooterModule

3. Themes

Anpassbare Designsysteme mit Farben, Typografie, Abständen und Animationen.

4. Templates

Vordefinierte Kartenkonfigurationen für häufige Anwendungsfälle.

Features

  • 🎨 Vollständig themebare Komponenten
  • 📦 Modularer Aufbau
  • 💾 Datenbankgestützte Konfiguration
  • 🎭 Mehrere Varianten (default, compact, hero, minimal, glass, gradient)
  • 📱 Responsive Design
  • Optimierte Performance
  • Barrierefreiheit

Verwendung in der App

Das Card System wird in verschiedenen Bereichen der uload-App verwendet:

  1. Profilseiten - Anzeige von Benutzerinformationen
  2. Link-Verwaltung - Darstellung von Link-Sammlungen
  3. Dashboard - Statistiken und Übersichten
  4. Template Store - Marktplatz für Kartenvorlagen

Nächste Schritte