RentHub

A modern rental management platform built with Next.js, Prisma, and Supabase.

🏗️ Architecture Overview

RentHub follows a layered architecture designed for scalability and type safety:

• UI Layer (React): Client components using TanStack Form and ShadCN UI.
• State Layer (Hooks): Custom hooks using TanStack Query for data fetching and mutations.
• Service Layer (Actions): Next.js Server Actions for authenticated business logic and database interactions.
• Data Layer (Prisma): Type-safe ORM managing PostgreSQL via Supabase.

📁 Project Structure

• app/: Next.js App Router (Routes, Layouts, and Server Actions).
• components/: Modular UI components and context providers.
• hooks/: Domain-specific hooks abstracting data logic.
• lib/: Core utilities, Zod schemas, and Prisma configuration.
• prisma/: Database schema and migrations.

🎯 Architectural Patterns

Business Logic & Persistence

Logic is centralized in Server Actions, ensuring security and server-side validation. Prisma provides type-safe access to the PostgreSQL database hosted on Supabase.

State & Data Management

• TanStack Query: Manages client-side server state, caching, and background refetching.
• TanStack Form: Provides type-safe form state and validation.
• Custom Hooks: Abstract specific operations (e.g., useUnit handles fleet management, useBooking handles rental transactions).

🗃️ Features

Fleet Management (Units)

• View availability, status, and vehicle specs.
• Advanced filtering and real-time updates.
• Create, Edit, and Delete units with server-side validation.
• Image uploads via Supabase Storage (units bucket) — upload directly from the form; public image URL is stored in the database.
• Thumbnail image column in the units table with a clickable full-size lightbox preview.

Booking Management (New)

• Centralized booking system linking Customers to Units.
• Real-time price calculation and schedule tracking.
• Automated customer record creation (deduplication by email).
• Status-based workflow (Pending → Confirmed → In Progress → Completed).

Validation & Serialization

• Zod: Shared schemas used for both client and server validation.
• Serializers: Utilities that convert Prisma-specific types (like Decimal) into JSON-safe formats for the frontend.

🗄️ Storage

Unit images are stored in Supabase Storage using the units bucket.

Setting	Value
Bucket	units
Max file size	1 MB
Allowed types	image/jpeg

Uploads happen client-side (via @supabase/ssr browser client). After upload, the public URL is written into the form's imageUrl field and persisted by the existing server action — no schema changes required.

🔐 Auth & Security

Authentication is managed via Supabase Auth. Cookies are used for session management, and Server Actions verify user context before performing any restricted operations.

Stripe Integration (New)

• Every new user signup automatically creates a linked Stripe Customer.
• User UUIDs and Stripe Customer IDs are synced to a local users table via Prisma for future billing and subscription features.

🚀 Getting Started

1. Install: npm install
2. Environment: Configure .env with Supabase and Database credentials.
3. Database: npx prisma generate followed by npx prisma migrate dev.
4. Run: npm run dev

🛠️ Commands

• npm run db:migrate: Create and apply migrations.
• npm run db:studio: Open database GUI.
• npm run lint: Check code quality.

---

Built with Next.js, Prisma, and Supabase