managarten/uload/docs/reports/cards-profile-fix.md
Till-JS c712a2504a feat: integrate uload and picture, unify package naming
- Add uload project with apps/web structure
  - Reorganize from flat to monorepo structure
  - Remove PocketBase binary and local data
  - Update to pnpm and @uload/web namespace

- Add picture project to monorepo
  - Remove embedded git repository

- Unify all package names to @{project}/{app} schema:
  - @maerchenzauber/* (was @storyteller/*)
  - @manacore/* (was manacore-*, manacore)
  - @manadeck/* (was web, backend, manadeck)
  - @memoro/* (was memoro-web, landing, memoro)
  - @picture/* (already unified)
  - @uload/web

- Add convenient dev scripts for all apps:
  - pnpm dev:{project}:web
  - pnpm dev:{project}:landing
  - pnpm dev:{project}:mobile
  - pnpm dev:{project}:backend

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-25 04:00:36 +01:00

3.1 KiB

Cards on Profile Page - Implementation Report

Date: December 17, 2024
Status: Implemented with simplified approach

Solution Overview

Successfully implemented cards display on user profile pages by creating a simplified rendering approach that avoids complex type imports causing SSR issues.

Changes Made

1. Server-Side Data Loading (/src/routes/p/[username]/+page.server.ts)

  • Removed complex Card type import that was causing 500 errors
  • Implemented direct PocketBase query without type dependencies
  • Added safe JSON parsing for card config/metadata fields
  • Filter cards by page="profile" and visibility="public"

2. Client-Side Rendering (/src/routes/p/[username]/+page.svelte)

  • Removed dependency on complex CardRenderer component
  • Created inline simplified card rendering for three modes:
    • Beginner Mode: Renders modules (header, content, media, links)
    • Advanced Mode: Shows card name and description
    • Expert Mode: Shows card name and description
  • Added "Featured Cards" section above links

3. Card Management (/src/routes/(app)/my/cards/+page.svelte)

  • Updated to load ALL user cards, not just profile ones
  • Existing profile toggle functionality allows users to control visibility
  • Added stats showing total cards vs cards on profile
  • Toggle automatically sets visibility to public when adding to profile

Key Features

Profile Page

  • Cards appear in a responsive grid (1-3 columns)
  • Simple module-based rendering for beginner cards
  • Fallback display for advanced/expert cards
  • Only shows public cards marked for profile display

Management Page

  • Checkbox to toggle "Show on Profile"
  • Warning if card is not public but set for profile
  • Drag-and-drop reordering still functional
  • Direct link to view profile page

Technical Approach

Why This Works

  1. No Type Imports: Server-side code doesn't import complex Card types
  2. Direct Database Access: Uses PocketBase directly with JSON parsing
  3. Simplified Rendering: Inline rendering without complex components
  4. Progressive Enhancement: Basic display with room for improvements

Trade-offs

  • Less feature-rich display than full CardRenderer
  • Advanced/Expert cards show metadata only (not full rendering)
  • No template variable replacement
  • No custom HTML/CSS rendering

Future Improvements

Short Term

  1. Add client-side CardRenderer for better display
  2. Implement template variable replacement
  3. Add preview mode in card management

Long Term

  1. Refactor Card type system for SSR compatibility
  2. Create server-safe card components
  3. Implement full rendering for all card modes
  4. Add card analytics and interactions

Testing

  1. Build succeeds without errors:
  2. Profile page loads without 500 error:
  3. Cards can be toggled for profile display:
  4. Only public profile cards appear:
  5. Responsive layout works:

Conclusion

The simplified approach successfully displays cards on profile pages while avoiding the complex type system issues. This provides a working foundation that can be enhanced incrementally without breaking production.