Collectorssphere

Die intelligente Sammlungsplattform fuer leidenschaftliche Sammler

Features • Spheres • Tech Stack • Installation • Roadmap

---

Was ist Collectorssphere?

Collectorssphere ist eine moderne, datenschutzfreundliche Progressive Web App zur Verwaltung deiner Sammlungen. Egal ob Hot Wheels, Muenzen, Briefmarken, Vinyl, LEGO, Kameras oder Mineralien — alles an einem Ort, sicher und uebersichtlich.

Kernidee

Ein universeller Collection HUB, der dir hilft, alles was du sammelst professionell zu katalogisieren, zu bewerten und im Blick zu behalten. Spezialisierte Spheres fuer bestimmte Sammelgebiete (Trading Cards, Gaming, etc.) folgen in zukuenftigen Updates.

---

Features

Collection Management

Feature	Beschreibung
Sammlungen	Erstelle beliebig viele Sammlungen mit eigenen Kategorien
Items	Erfasse Items mit Bildern, Tags, Custom-Attributen und Preisen
Flexible Attribute	8+ Attributtypen: Text, Nummer, Tags, Checkbox, Datum, Link, Waehrung
Import & Export	CSV und JSON Support fuer alle Sammlungen
Sharing	Teile Sammlungen mit anderen (Viewer/Editor/Admin Rollen)
Barcode Scanner	EAN-13, EAN-8, UPC-A, UPC-E, Code-128, QR

Dashboard

• Uebersicht ueber alle Sammlungen, Items und Gesamtwert
• Konfigurierbare Dashboard-Tiles (verschieben, ein-/ausblenden, Groessen anpassen)
• Finanz-Charts (Ausgaben, Wert, Gewinn pro Sammlung)
• Top Items nach Wert
• Erinnerungen fuer wichtige Termine

Tools

Tool	Beschreibung
Waehrungsrechner	Live-Wechselkurse fuer internationale Sammlungen
Markt & Portfolio	Edelmetall- und Kryptopreise im Blick
Sammler-News	Kuratierte News aus 14+ Sammelkategorien
Buecher-Suche	ISBN- und Textsuche mit Detailinfos
Vinyl-Suche	Barcode- und Textsuche mit Marktpreisen

PWA & Mobile

• Installierbar auf Smartphone und Desktop
• Offline-Faehigkeit mit Background Sync
• Pull-to-Refresh auf mobilen Geraeten
• Dark/Light Theme

---

Sphere-Konzept

Collectorssphere organisiert sich in spezialisierte Spheres, von denen jede optimiert ist fuer spezifische Sammelkategorien:

                    Collectorssphere
                         HUB
              Universal Collection Manager
                          |
    +-----------+---------+---------+-----------+
    |           |         |         |           |
   TCG       Gaming   Official    Geo        Shop
  Trading    Video     Docs &    Geology    Market-
  Cards      Games     Certs     & Arch.    place

Aktueller Fokus: Der HUB — der universelle Sammlungsmanager — ist die aktive Kernplattform. Die spezialisierten Spheres (TCG, Gaming, Official, Geo, Shop) befinden sich in Entwicklung und werden schrittweise freigeschaltet.

---

Tech Stack

Kategorie	Technologie
Framework	Next.js 16 (App Router, Turbopack)
Sprache	TypeScript (strict)
Styling	Tailwind CSS 4
UI	React 19, Framer Motion, shadcn/ui
Backend	Supabase (PostgreSQL, Auth, Storage, Realtime)
PWA	Custom Service Worker
Hosting	Vercel
Analytics	Vercel Analytics & Speed Insights

---

Installation

Voraussetzungen

• Node.js 18+
• npm
• Supabase Account

1. Repository klonen

git clone https://github.com/westside0106/CollectR.git
cd CollectR

2. Abhaengigkeiten installieren

npm install

3. Umgebungsvariablen

Erstelle eine .env.local Datei mit den erforderlichen Variablen. Eine Vorlage findest du in der Projektdokumentation. Mindestens werden Supabase-Verbindungsdaten benoetigt.

4. Entwicklungsserver starten

npm run dev

Oeffne http://localhost:3000

/ ist die oeffentliche Landing Page. Eingeloggte User werden automatisch zum Dashboard weitergeleitet.

---

Scripts

npm run dev        # Entwicklungsserver
npm run build      # Produktions-Build
npm run start      # Produktions-Server
npm run lint       # ESLint

---

Roadmap

Phase 1: Collection HUB (Aktiv)

• Sammlungen erstellen, bearbeiten, teilen
• Items mit Bildern, Tags, Custom-Attributen
• Dashboard mit konfigurierbaren Tiles
• Finanz-Tracking (Ausgaben, Wert, Gewinn)
• Erinnerungen-System
• 5 integrierte Tools (Waehrung, Markt, News, Buecher, Vinyl)
• PWA mit Offline-Support
• Import/Export (CSV, JSON)
• Onboarding-Flow fuer neue User
• Performance-Optimierung
• Test-Coverage aufbauen

Phase 2: Spezialisierte Spheres (Geplant)

• TCG Sphere (Trading Card Games)
• Gaming Sphere (Video Game Collections)
• Geo Sphere (Mineralien, Fossilien)
• Official Sphere (Dokumente & Zertifikate)
• Shop Sphere (Marketplace Integration)

Phase 3: Advanced Features (Zukunft)

• AI-gestuetzte Item-Erkennung
• Community Features
• Oeffentliche Sammlungen
• Erweiterte Analytics

---

Mitwirken

Beitraege sind willkommen!

1. Fork das Repository
2. Erstelle einen Feature-Branch (git checkout -b feature/dein-feature)
3. Committe deine Aenderungen
4. Push zum Branch (git push origin feature/dein-feature)
5. Oeffne einen Pull Request

---

Lizenz

MIT License - siehe LICENSE fuer Details.

---

Made with Leidenschaft fuer Sammler weltweit