RESONANT

Deutsche Gitarren Marketplace - Eine vertrauenswürdige Plattform für Gitarren, Amps und Zubehör in Deutschland.

🎸 Über das Projekt

RESONANT ist eine moderne Marketplace-Plattform, speziell entwickelt für die deutsche Gitarren-Community. Wir bieten eine sichere, benutzerfreundliche Alternative zu eBay Kleinanzeigen und Reverb.

Kernfunktionen

• ✅ Authentifizierung & Verifizierung - Sicheres Auth-System mit Email-Verifikation
• ✅ User Profile - Detaillierte Profile mit Bewertungen und Statistiken
• ✅ Multi-Kategorie Listings - Gitarren, Amps & Effekte mit spezifischen Feldern
• ✅ Image Upload & Compression - Optimierte Bildverarbeitung mit ImageKit
• ✅ Search & Filters - Erweiterte Suchfunktionen mit Kategorie-Filtern
• 🚧 Messaging - Sicheres Nachrichtensystem (In Entwicklung)

🛠 Tech Stack

• Framework: Next.js 15 (App Router)
• Language: TypeScript (Strict Mode)
• Styling: Tailwind CSS + shadcn/ui
• Database: Supabase (PostgreSQL + RLS)
• State Management: Zustand + React Query
• Forms: React Hook Form + Zod
• Auth: Supabase Auth

🚀 Quick Start

Voraussetzungen

• Node.js 18+
• npm oder yarn
• Supabase Account

Installation

1. Repository klonen ```bash git clone cd Resonant ```

2. Dependencies installieren ```bash npm install ```

3. Umgebungsvariablen einrichten

   Kopiere .env.example zu .env.local und füge deine Supabase Credentials ein:

   ```bash cp .env.example .env.local ```

   Bearbeite .env.local: ```env NEXT_PUBLIC_SUPABASE_URL=deine_supabase_url NEXT_PUBLIC_SUPABASE_ANON_KEY=dein_anon_key SUPABASE_SERVICE_ROLE_KEY=dein_service_role_key ```

4. Supabase Setup

   Gehe zu Supabase Dashboard und:

   • Erstelle ein neues Projekt
   • Region: Europe (Frankfurt) (wichtig für DSGVO)
   • Kopiere die API Keys aus Settings > API

   Führe die Migration aus:

   • Öffne SQL Editor im Supabase Dashboard
   • Kopiere den Inhalt von supabase/migrations/001_initial_schema.sql
   • Führe die Migration aus

5. Development Server starten ```bash npm run dev ```

   Öffne http://localhost:3000

📁 Projektstruktur

``` src/ ├── app/ # Next.js App Router │ ├── (auth)/ # Protected routes │ ├── actions/ # Server Actions │ └── layout.tsx # Root Layout ├── components/ │ ├── ui/ # shadcn/ui components │ ├── features/ # Feature components (Auth, Profile) │ ├── layout/ # Layout components │ └── providers/ # React Providers ├── lib/ │ ├── supabase/ # Supabase clients │ └── validations/ # Zod schemas ├── hooks/ # Custom React hooks ├── stores/ # Zustand stores ├── types/ # TypeScript types ├── utils/ # Utility functions └── styles/ # Global styles ```

🔐 Sicherheit

• RLS Policies: Alle Datenbank-Tabellen sind mit Row Level Security geschützt
• DSGVO Compliance: Deutsche Datenschutz-Standards
• Email Verification: Required für Account-Aktivierung
• Type Safety: Strikte TypeScript-Konfiguration

📚 Dokumentation

• Setup Guide
• Architecture
• API Specification
• Database Schema

🎯 Roadmap

Phase 1: Auth & Profile ✅

• User Authentication
• Profile Management
• Verification System

Phase 2: Listings ✅

• Multi-Category Listings (Gitarren, Amps, Effekte)
• Create Listings with Category-Specific Fields
• Browse Listings with Advanced Filters
• Image Upload & Compression
• Search & Filters
• Favorites System

Phase 3: Communication

• Messaging System
• Notifications
• Offer Management

Phase 4: Transactions

• Payment Integration (Stripe)
• Escrow Service
• Rating System

🤝 Contributing

Dieses Projekt befindet sich in aktiver Entwicklung. Contributions sind willkommen!

📄 Lizenz

MIT License

👨‍💻 Entwickelt mit

• Cursor AI
• Claude Sonnet 4.5
• Viel ☕ und 🎸