Jose Madrid Salsa Documentation
Complete documentation for the Jose Madrid Salsa e-commerce platform
Welcome to the Jose Madrid Salsa Developer Docs
Everything you need to understand, build upon, and deploy the Jose Madrid Salsa e-commerce platform. Start with Getting Started or jump straight to the section you need.
Repository
jordolang/josemadridsalsa
Quick Navigation
Getting Started
Set up your dev environment and run the project locally
API Reference
REST API endpoints, authentication, and request schemas
Features
Checkout, payments, shipping, battle arena, and more
Integrations
Stripe, PayPal, Square, Google Maps, and email services
Deployment
Deploy to Vercel, manage environments, and CI/CD
Configuration
Environment variables, database, and service setup
Platform Overview
Jose Madrid Salsa is a full-featured e-commerce platform built with Next.js 16, Prisma, and TypeScript.
- E-commerce — Product catalog, shopping cart, checkout, and order management
- Payment Processing — Stripe, PayPal, and Square for flexible payments
- Shipping & Fulfillment — Calculated rates, label generation, tracking
- Admin Dashboard — Full management suite for products, orders, and users
- Fundraiser Battle Arena — Gamified fundraising system with leaderboards
- Email Marketing — Automated campaigns, templates, and engagement tracking
- Framework: Next.js 16 (App Router, Server Components)
- Database: PostgreSQL via Prisma ORM (Neon serverless)
- Auth: NextAuth.js with Google, GitHub, Facebook, Apple OAuth
- Styling: Tailwind CSS with custom design system
- Deployment: Vercel with Fluid Compute
- Monitoring: Sentry error tracking, Vercel Analytics
- Payments: Stripe, PayPal, Square
- Email: Nodemailer, Resend, React Email templates
- Maps: Google Maps Platform (Places, Geocoding)
- Storage: Vercel Blob, UploadThing
- Analytics: Google Analytics, Amplitude, PostHog
- AI: Anthropic Claude API for content generation
Project Structure
Getting Started
Clone the Repository
git clone https://github.com/jordolang/josemadridsalsa.git
cd josemadridsalsaInstall Dependencies
npm installConfigure Environment
Copy the example environment file and add your credentials:
cp .env.example .env.localSee the Configuration Guide for all required variables.
Database Required
You'll need a PostgreSQL database to run the project. We recommend Neon for serverless Postgres. See the Database Setup guide.
Documentation Map
Explore how every section of the docs connects. Click a node to jump to that page.
Getting Help
How is this guide?