Skip to content

Hereetria/shearcraft-booking

Repository files navigation

✂️ ShearCraft Booking — Modern Barber Booking Platform


Live Demo Report Bug Request Feature


📌 Project Overview

ShearCraft Booking is a comprehensive, modern web application that enables barber shops to manage appointments and customers to book services seamlessly. Built with Next.js, Tailwind CSS, and shadcn/ui, it delivers an intuitive user experience with robust security and fully responsive design.

✨ Features

🔐 Authentication & User Management

  • Google OAuth & Email/Password login
  • Email verification & password reset with secure tokens
  • Role-Based Access Control (Admin / Customer)
  • Access & Refresh token–based session management with Remember Me support

📅 Booking System

  • Real-time slot availability & conflict prevention
  • Service & package management with custom pricing/duration
  • Configurable time slots, business hours, lunch breaks, holidays
  • Booking history, modifications, cancellations, and exports

👨‍💼 Admin Dashboard

  • Modern, well-designed admin dashboard UI
  • User, service, and package management
  • Booking oversight with approvals, analytics, and exports
  • Real-time activity feed and system monitoring

📧 Email System

  • Account verification, booking confirmation, password reset
  • Responsive templates with React Email
  • SMTP-based reliable delivery and tracking

🎨 User Interface

  • Responsive, mobile-first design with Tailwind CSS & shadcn/ui
  • Navbar-level Light/Dark styling
  • Smooth animations and accessibility (WCAG)
  • Reusable components with consistent styling

🔒 Security

  • Access/Refresh token rotation
  • Strong password hashing (bcryptjs)
  • Input validation (Zod), Prisma SQL injection protection
  • CSRF, XSS protection, secure headers

🚀 Performance & Optimization

  • SSR & static generation with Next.js
  • Code splitting, lazy loading, and image optimization
  • Redis caching & API rate limiting
  • Optimistic UI updates and real-time session sync

📱 Mobile & Cross-Platform

  • Optimized for touch and gestures
  • Works across modern browsers and devices
  • PWA-ready for app-like experience

🔧 Development & Maintenance

  • TypeScript, ESLint, Prettier for code quality
  • Error boundaries and validation in place
  • Structured, production-ready codebase
  • Built with clean code principles and best practices

⚡ Performance & Optimization

  • SSR + static generation
  • Code splitting, lazy loading, and image optimization
  • Redis (Upstash) for caching & rate limiting

📱 Responsive & UI

  • Mobile-first design
  • Clean, polished Admin Dashboard UI
  • Light/Dark styling limited to navbar

🔧 Development

  • pnpm, Turbopack for fast builds
  • ESLint + Prettier for code quality
  • Error boundaries & structured codebase
  • Built with clean code principles and best practices
  • AI-assisted with Cursor AI

🖼️ Screenshots

Shown below in order:
1. Landing · 2. About · 3. Login
4. Reservation · 5. My Bookings · 6. Dashboard


🧰 Tech Stack

Next.js Badge TypeScript Badge Tailwind CSS Badge shadcn/ui Badge
Prisma Badge NextAuth.js Badge bcryptjs Badge Nodemailer Badge
PostgreSQL Badge Vercel Badge


📥 Installation

Prerequisites

  • Node.js 18+
  • PostgreSQL
  • SMTP email service
  • Google OAuth credentials

Setup

git clone [repository-url]
cd shearcraft-booking

pnpm install
cp .env.example .env   # Configure variables in this file

pnpm db:migrate        # Run database migrations
pnpm dev               # Start development server

📜 License

License: MIT

This project is licensed under the terms described in the LICENSE file.


© 2025 Yusuf Okan Sirkeci — Hereetria

About

A modern barber booking platform built with Next.js, Tailwind CSS, and shadcn/ui, featuring real-time scheduling, secure authentication, and a clean dashboard for appointment management.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages