Overview
Salesive storefronts use a hybrid routing model where certain routes are handled by your frontend application, while others are automatically managed by the Salesive platform. This allows you to maintain full control over your product catalog and browsing experience while delegating authentication, checkout, and account management to Salesive.Manual Routes
These routes must be implemented in your frontend application with React Router. You have complete control over the UI, data fetching, and user experience.Home and Products
Homepage - Display featured products, banners, and promotional content. Typically shows a curated selection of products using the Products API.
All Products - List all available products with filtering, sorting, and pagination. Use the
GET /products endpoint with query parameters for search and filters.Product Detail - Display detailed product information, images, variants, pricing, and add-to-cart functionality. Accepts either product ID or URL slug.
Categories
All Categories - Display all product categories as a browsable list or grid. Use the Categories API to fetch the category tree.
Category Products - Show all products within a specific category with filtering options. Accepts either category ID or URL slug.
Automatic Routes
These routes are handled by the Salesive platform and always render with Salesive’s default theme — a custom theme cannot override them, and any sub-paths (for example/blog/my-post or /orders/123) are protected too. Link to these paths from your application, but do not implement them yourself.
The protected paths are:
Cart and Blog
Cart - The shopper’s cart, including quantity, add-on editing, and item selection, served by the platform’s default theme.
Blog - The shop’s blog index listing published posts.
Blog Post - A single blog post, resolved by its slug.
Checkout and Payment
Checkout Flow - Shipping address, payment method selection, and order review for a created order. (Service/business orders are non-shippable, so the shipping step is skipped.)
Payment Processing - Payment gateway integration and transaction processing. Salesive manages payment collection and verification.
Invoice - Order invoices and receipts.
Account and Orders
Account Dashboard - User account overview including profile information, order history, and saved addresses.
Account Settings - User preferences, notification settings, and account configuration.
Order History - Complete list of user orders with status tracking.
Order Detail - A single order with its items and current status.
Login - Customer sign-in and verification.
Logout - Handles user session termination and redirects to the appropriate page.
Legal Pages
Privacy Policy - Displays your shop’s privacy policy configured in the Salesive dashboard.
Terms and Conditions - Shows your shop’s terms and conditions configured in the Salesive dashboard.
About Us - Displays information about your business configured in the Salesive dashboard.
Return Policy - Shows your shop’s return and refund policy configured in the Salesive dashboard.
Implementation Guide
Setting Up Manual Routes
Use your preferred routing library to implement manual routes. Here’s an example with React Router:Linking to Automatic Routes
Link to automatic routes from your application without implementing the pages:Cart to Checkout Flow
Checkout is keyed to an order, so create the order from the cart first, then send the shopper to the automatic/checkout/{orderId} route:
Dynamic Routes
Use React Router path params for your product and category detail pages, and let the automatic routes fall through to the Salesive platform. A typical organization:Automatic routes (
/checkout, /account, /orders, legal pages, etc.) are handled
by Salesive’s platform — do not add React Router routes for them. Just link to
those paths and the platform serves them.Best Practices
SEO Optimization
Use URL slugs instead of IDs in manual routes for better SEO. Generate slugs from product and category names.
Loading States
Implement skeleton screens and loading indicators in manual routes while fetching data from the API.
Error Handling
Handle 404 errors gracefully when products or categories are not found. Suggest alternative products or redirect to relevant pages.
Authentication Guards
Check authentication status before showing links to automatic routes like
/account or /orders. Use the Auth API to verify user sessions.Route Protection
Some automatic routes require authentication. Check user authentication status in your frontend:Next Steps
Store API Reference
Explore Products, Categories, and Cart endpoints for implementing manual routes.
Salesive API Axios Client
Use typed API wrappers for seamless integration with your routing logic.
Development Guide
Learn about Salesive dev tools and configuration management.
Quickstart
Get started with a complete Salesive storefront setup.

