Back to Home

Soap Stache

A modern e-commerce platform for handcrafted soaps, built with Next.js, Sanity CMS, and Stripe payments. This project features a beautiful, responsive design with Michigan pride themes and comprehensive product management.

Soap Stache
View Live Project
E-commerceNext.jsSanity CMSStripe

🚀 Features

  • Modern E-commerce: Complete shopping cart and checkout experience
  • Content Management: Sanity CMS for easy product and content management
  • Payment Processing: Secure Stripe integration for payments
  • Responsive Design: Mobile-first design with Tailwind CSS
  • Product Management: Advanced product catalog with categories, pricing, and inventory
  • Michigan Pride: Local branding and themed content
  • Real-time Updates: Live content updates through Sanity
  • SEO Optimized: Next.js App Router with optimized performance

🛠️ Tech Stack

Frontend

  • • Next.js 15 - React framework with App Router
  • • React 19 - Latest React with concurrent features
  • • Tailwind CSS 4 - Utility-first CSS framework
  • • React Icons - Icon library for UI elements

Backend & CMS

  • • Sanity CMS - Headless content management system
  • • Sanity Studio - Content editing interface
  • • Sanity Client - JavaScript client for content queries
  • • Sanity Image URL - Image optimization and transformation

Payment & E-commerce

  • • Stripe - Payment processing and checkout
  • • Stripe.js - Client-side payment integration

Development Tools

  • • ESLint - Code linting and formatting
  • • PostCSS - CSS processing
  • • Turbopack - Fast bundler for development

📁 Project Structure

soap-stache/
├── app-soap-stache/          # Next.js frontend application
│   ├── app/                  # Next.js App Router pages
│   │   ├── about/           # About page
│   │   ├── api/             # API routes (Stripe webhooks, checkout)
│   │   ├── cart/            # Shopping cart page
│   │   ├── contact/         # Contact page
│   │   ├── products/        # Product pages
│   │   └── success/         # Order success page
│   ├── components/          # React components
│   │   ├── layout/          # Layout components (Navbar, Footer, Hero)
│   │   ├── ui/              # Reusable UI components
│   │   └── [feature]/       # Feature-specific components
│   ├── contexts/            # React contexts (CartContext)
│   ├── lib/                 # Utility libraries
│   │   ├── sanity.js        # Sanity client configuration
│   │   ├── stripe.js        # Stripe client configuration
│   │   └── stripe-server.js # Server-side Stripe utilities
│   └── public/              # Static assets
└── studio-soap-stache/      # Sanity Studio (CMS)
    ├── schemaTypes/         # Content schemas
    │   ├── soapType.js      # Product schema
    │   └── subscriberType.js # Newsletter subscriber schema
    └── sanity.config.js     # Sanity configuration

📝 Content Management with Sanity

Product Schema

The project includes a comprehensive product schema with the following fields:

  • • Basic Info: Title, slug, description, blurb
  • • Pricing: Price with validation
  • • Media: Product photos with hotspot functionality
  • • Status: New product badges, availability toggle
  • • Display: Featured/Hero product designation
  • • Details: Grit level (0-5), scent profile
  • • Metadata: Launch date, ordering

Content Types

Soap Products (soapType.js)

  • • Complete product catalog management
  • • Image optimization and transformation
  • • Inventory and availability tracking
  • • Special display status (Featured/Hero)

Newsletter Subscribers (subscriberType.js)

  • • Email subscription management
  • • Marketing list integration

Sanity Studio Features

  • • Real-time Collaboration: Multiple editors can work simultaneously
  • • Custom Validation: Business rules for product management
  • • Image Management: Hotspot cropping and optimization
  • • Content Preview: See how content will appear on the website
  • • Version Control: Track content changes over time

💳 E-commerce Features

Shopping Cart

  • • Persistent cart state with React Context
  • • Add/remove items
  • • Quantity management
  • • Cart total calculation

Checkout Process

  • • Stripe Checkout integration
  • • Secure payment processing
  • • Order confirmation
  • • Webhook handling for order updates

Product Management

  • • Dynamic product pages with Next.js dynamic routes
  • • Product filtering and search
  • • Inventory tracking
  • • Featured product sections

🎨 Design System

Components

  • • Layout: Navbar, Footer, Hero sections
  • • Product: ProductCard, ProductGrid, FeaturedProducts
  • • E-commerce: Cart, checkout components
  • • Marketing: ReviewsSection, MichiganPrideSection, EmailSubscribe

Styling

  • • Tailwind CSS 4: Utility-first styling
  • • Responsive Design: Mobile-first approach
  • • Custom Components: Reusable UI elements
  • • Michigan Theme: Local branding and colors

🔧 API Routes

  • /api/checkout - Create Stripe checkout sessions
  • /api/webhooks/stripe - Handle Stripe webhooks
  • Sanity GROQ queries for product data
  • Real-time content updates
  • Image optimization and transformation

📊 Performance

  • Next.js App Router: Optimized routing and rendering
  • Image Optimization: Sanity image transformation
  • Code Splitting: Automatic bundle optimization
  • CDN: Content delivery network for static assets
  • Turbopack: Fast development builds

🔒 Security

  • Environment Variables: Secure API key management
  • Stripe Security: PCI-compliant payment processing
  • Sanity Security: Role-based access control
  • Input Validation: Client and server-side validation

Interested in a similar project?

Let's discuss how we can build something similar for your business.