SoloSupport

AI-powered customer service for solo Shopify store owners

Stop answering "Where is my order?" twenty times a day. SoloSupport handles 80% of your customer questions automatically, so you can get 2 hours back every day.

The Problem

Solo Shopify store owners face a unique challenge:

• Channel Chaos: Email in one tab, Instagram DMs in another, Shopify chat in a third
• Repetitive Questions: "Where's my order?" "How do I return?" Copy-pasting the same answers
• No Context: Switching apps to look up order details for every inquiry
• No Time for Growth: 2-4 hours/day on customer service = no time for marketing or products
• Expensive Tools: Gorgias ($750/mo) and Zendesk ($150/user/mo) are built for teams, not solo operators

The Solution

SoloSupport is the unified inbox designed specifically for solo store owners:

Feature	What It Does
Unified Inbox	Email + Instagram + Shopify Chat in one dashboard
AI Auto-Responses	80% of questions answered automatically (you approve before sending)
Order Context	Customer history and tracking info displayed next to every message
5-Min Setup	Connect channels, AI learns your policies, start responding faster

Tech Stack

• Framework: Next.js 16 (App Router)
• Frontend: React 19, TypeScript 5, Tailwind CSS 4
• Backend: Supabase (PostgreSQL + Auth + Realtime)
• AI: OpenAI GPT-4
• Integrations: Shopify Admin API, Gmail API, Instagram Graph API
• Deployment: Vercel

Getting Started

Prerequisites

• Node.js 20+
• npm or yarn
• Supabase account
• API keys for OpenAI, Shopify, Google, and Facebook

Installation

# Clone the repository
git clone https://github.com/sungmanch/solosupport.git
cd solosupport

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your API keys

# Run development server
npm run dev

Open http://localhost:3000 to see the landing page.

Environment Variables

# Supabase
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=

# Shopify
SHOPIFY_API_KEY=
SHOPIFY_API_SECRET=

# Google/Gmail
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# Instagram/Facebook
FACEBOOK_APP_ID=
FACEBOOK_APP_SECRET=

# OpenAI
OPENAI_API_KEY=

# App
NEXT_PUBLIC_APP_URL=

Project Structure

src/
├── app/                    # Next.js App Router
│   ├── (dashboard)/        # Protected dashboard routes
│   ├── api/                # API routes (auth, AI, integrations)
│   ├── layout.tsx          # Root layout with SEO metadata
│   ├── page.tsx            # Landing page
│   └── globals.css         # Design system
├── components/
│   ├── HeroAnimation.tsx   # Hero section animation
│   ├── InteractiveDemo.tsx # Interactive product demo
│   ├── dashboard/          # Dashboard components
│   ├── inbox/              # Conversation UI components
│   └── ui/                 # Base UI components
├── lib/
│   ├── ai/                 # OpenAI integration
│   ├── shopify/            # Shopify SDK helpers
│   ├── gmail/              # Gmail API helpers
│   ├── instagram/          # Instagram Graph API helpers
│   └── supabase/           # Database schema & helpers
└── types/                  # TypeScript definitions

Design System

Aesthetic: Editorial Minimal - Typography-driven, restrained

Token	Value	Usage
--color-black	#0f0f0f	Text, buttons
--color-cream	#f5f3ef	Background
--color-accent	#c45d3a	CTAs, highlights
--font-serif	Instrument Serif	Headlines
--font-sans	Satoshi	Body text

Pricing

Plan	Price	Features
Solo	$15/mo	500 conversations, 3 channels, AI responses
Growth	$40/mo	2,000 conversations, SMS, analytics

50% off for early access (first 100 signups)

Target Customer

"Solo Sarah" - A 1-person Shopify store doing $5K-$50K/month in revenue, handling 100-500 customer inquiries monthly, currently burning out on repetitive customer service tasks.

Value Proposition

• Time Saved: 2.5 hours/day (75 hours/month)
• ROI: $3,750/month in time value vs $29/month cost = 129x ROI
• Competitive Edge: 96% cheaper than Gorgias, built for solo operators

Development

# Run development server
npm run dev

# Type checking
npm run lint

# Production build
npm run build

Deployment

The app is deployed on Vercel. Push to main to trigger automatic deployment.

# Manual deploy
vercel --prod

Documentation

Additional documentation is available in the /docs directory:

• PROBLEM.md - Detailed problem analysis
• VALUE-PROPOSITION.md - Value canvas and messaging
• ICP.md - Ideal Customer Profile research
• IMPLEMENTATION-STRATEGY.md - Technical implementation plan

License

Private - All rights reserved

---

Built with care for solo entrepreneurs who deserve better tools.