Guides

Step-by-step guides and best practices for working with Jose Madrid Salsa.

Getting Started Guides

• First Product Upload - Add your first product to the catalog
• Order Management - Manage orders from placement to fulfillment
• Configure Shipping - Configure shipping rates and carriers
• Tax Configuration - Set up Stripe Tax for automatic tax calculation

Admin Operations

• User Management - Manage users, roles, and permissions
• Email Campaigns - Set up and run email campaigns
• Image Hosting - Where product and content images live
• Pirate Ship - The manual shipping-label alternative
• Admin Platform Checklist - Back-office coverage
• Admin Platform Gap Analysis - What is still missing
• Automation Audit - What runs unattended, and what does not

Developer Guides

• Development Setup - Full development environment walkthrough
• Adding Features - How to add a new feature to the platform
• API Integration - Integrate with the REST API
• Custom Components - Create custom React components
• Database Queries - Common Prisma query patterns
• Database Best Practices - Database design patterns
• Code Quality - Code style, linting, and testing
• JSDoc Conventions - What to comment, and what to leave out
• Testing - Vitest, Playwright, and what to prioritise
• Versioning - How releases are cut
• Shared Code Strategy - The packages/* boundary
• Analytics Setup - Configure analytics tracking

Mobile & Native

• Mobile Setup - Mobile app overview and setup
• Desktop Apps - The Windows and macOS admin apps, and the guarded database console

Migration & History

• Ordering System Comparison - Feature parity against the legacy BigCommerce store
• Repository Migration - How the monorepo was consolidated

Troubleshooting

• Debugging Guide - Debug issues effectively
• Troubleshooting - Common problems and solutions
• FAQ - Frequently asked questions

Best Practices

• Performance Optimization - Improve application performance
• Security Best Practices - Security checklist and best practices