Modern marketplace platform for yard sales and estate sales with integrated helper services, shipping, and secure payments.

• Layered Marketplace: Main marketplace hub with nested individual sale marketplaces
• Helper Services: Professional photography, listing management, setup assistance, and delivery
• Multi-Carrier Shipping: USPS, FedEx, DHL, and DoorDash Drive integration
• Secure Payments: Stripe, PayPal, Venmo, Cash App, Apple Pay, Google Pay
• Identity Verification: KYC pipeline with document upload and verification
• Real-time Updates: Live inventory and pricing updates
• Rich Media: Photo and video uploads with optimization

• Framework: Next.js 15 (App Router)
• Language: TypeScript 5.7
• Styling: Tailwind CSS v4 with PostCSS
• UI Components: Radix UI primitives
• State Management: Zustand
• Forms: React Hook Form + Zod validation
• Testing: Jest + Playwright + Storybook
• Payments: Stripe + PayPal
• Storage: Vercel Blob Storage
• Package Manager: pnpm 10.26.1

• Node.js 22.x
• pnpm 10.26.1

# Install dependencies
pnpm install

# Copy environment variables
cp .env.local.example .env.local

# Fill in your API keys in .env.local

# Run development server
pnpm dev

Open http://localhost:3000 in your browser.

• pnpm dev - Start development server with Turbo
• pnpm build - Build for production
• pnpm start - Start production server
• pnpm check:types - Type check with logged output
• pnpm lint - Lint code with logged output
• pnpm format - Format code with Prettier
• pnpm verify - Run all checks (types, lint, format)
• pnpm test - Run Jest tests
• pnpm test:e2e - Run Playwright E2E tests
• pnpm storybook - Start Storybook dev server

src/
├── app/              # Next.js app router pages
├── components/       # React components
│   ├── ui/          # Reusable UI components
│   └── features/    # Feature-specific components
├── lib/             # Utility functions and configs
│   ├── shipping/    # Shipping calculation logic
│   ├── tax/         # Tax calculation database
│   └── payments/    # Payment processor integrations
├── hooks/           # Custom React hooks
├── types/           # TypeScript type definitions
└── config/          # App configuration files

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel

Ensure all required environment variables are set in your deployment platform.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

For support, email [email protected] or open an issue in the repository.