🚀
sherpa.sh docs
HomeInfrastructureAboutPricingDocsSign Up
  • Getting Started
    • What is sherpa.sh?
    • Getting Started
    • App Configuration
    • Custom Domains
    • Regions
  • TRAINING
    • Video Courses
      • Lesson 1: Deploying your first application
  • Applications
    • Supported Frameworks
      • Sveltekit
      • Remix
      • Next.js
      • Payload CMS
      • React
      • Docker
      • Custom Setups
    • Supported AI Website Builders
    • Continuous Delivery
    • CDN & Caching
  • Promotions & Rollbacks
  • Debugging
  • Securing your Application
  • Cronjobs
  • Databases
    • Managed Databases
      • Postgres
      • MySQL
      • MongoDB
  • Architecture
    • Architecture Overview
      • Next.js Architecture
    • Compliance
  • Integration Help
    • Clerk
  • Zero Downtime Migration
  • CHANGELOG
    • v0.4.0 - 22/5/25
    • v0.3.2 - 4/5/25
    • v0.3.1 - 22/4/25
    • v0.3.0 - 9/04/25
    • v0.2.0 - 27/03/25
    • v0.1.0 - 21/03/25
Powered by GitBook
On this page
  • Why sherpa.sh is Perfect for Remix Applications
  • Quick Start Guide
  • Platform Optimizations
  • Developer Experience
  • Configuration Examples
  • Migration Guide
  • Enterprise Features
  • Troubleshooting
  • Next Steps
  1. Applications
  2. Supported Frameworks

Remix

Deploy Remix Applications with sherpa.sh

Host your full-stack Remix applications with zero configuration, significantly lower costs, and higher performance. Our platform is purpose-built for modern web frameworks, delivering superior performance at a fraction of the price of traditional cloud providers by utilizing our own dedicated servers.

Why sherpa.sh is Perfect for Remix Applications

Massive Cost Savings on Server-Side Rendering

Unlike other platforms that charge premium rates for SSR compute time, sherpa.sh offers flat-rate pricing that makes sense for Remix apps:

Cost Comparison for Typical Remix App:

Monthly Traffic: 500K page loads + 1M API requests

Traditional Cloud Providers:
- Compute time: $180-320/month
- Function invocation fees: $45-80/month
- Bandwidth: $25-40/month
Total: $250-440/month

sherpa.sh:
- Unlimited SSR compute: $0 (included)
- Zero function invocation fees: $0
- Global CDN: $0 (included)
Total: $29/month flat rate

Zero Edge Request Charges

Remix applications generate numerous requests due to their loader and action architecture:

  • Each loader call generates a server request

  • Form submissions trigger action requests

  • Resource routes create additional endpoints

Real-World Impact:

  • Remix apps average 15-25 requests per user session

  • Other platforms charge $0.40 per million requests

  • sherpa.sh: $0 for unlimited requests

Optimized for Remix Architecture

Our infrastructure is specifically tuned for Remix's unique approach to full-stack React applications:

Server-Side Rendering Performance:

  • Pre-warmed Node.js instances across regions

  • No cold starts for your server entry points

  • Intelligent routing based on geographic proximity

Performance Benchmarks:

SSR response times (95th percentile):
sherpa.sh: 89ms average globally
Traditional VPS: 340ms average
Other serverless: 180ms average (with cold starts)

Quick Start Guide

Get your Remix application deployed in under 3 minutes with automatic configuration detection.

Prerequisites

  • Remix v2.7+ project

  • Git repository (GitHub)

  • Node.js 18+ for local development

Deployment Steps

  1. Connect Repository: Link your Git repository to sherpa.sh dashboard

  2. Auto-Detection: We automatically detect your Remix configuration and build settings

  3. Deploy: Push to your main branch triggers automatic deployment

  4. Live: Your app is available at https://your-app.sherpa.software

What You Get Instantly

  • Zero Configuration: Works with your existing vite.config.js

  • Global CDN: Static assets served from 200+ edge locations

  • Automatic HTTPS: SSL certificates provisioned and renewed automatically

  • Performance Optimization: Built-in asset optimization and caching

  • Flat Rate: No idle costs - only pay for actual usage

Platform Optimizations

Automatic Configuration Enhancements

When you deploy to sherpa.sh, we make minimal but powerful optimizations to maximize performance:

Environment Variables Set Automatically:

NODE_ENV=production
PORT=3000
ORIGIN=https://your-domain.com
PROTOCOL_HEADER=x-forwarded-proto
HOST_HEADER=x-forwarded-host

Asset URL Optimization:

// Your remix.config.js gets enhanced with:
export default {
  // Your existing configuration preserved
  publicPath: "https://your-app.sherpa.software/{hash}/",
  
  // Benefits:
  // - Global CDN delivery
  // - Instant rollbacks via hash versioning
  // - Long-term caching with cache busting
};

Performance Features

Code Splitting Optimization:

  • Remix's automatic code splitting works perfectly with our HTTP/2 infrastructure

  • Route-based chunks load in parallel with zero additional configuration

  • Intelligent prefetching for faster navigation

Static Asset Acceleration:

  • Automatic Brotli and Gzip compression

  • Long-term caching for unchanged files

  • Edge caching for <50ms global load times

Caching Strategy:

Cache-Control Headers (automatically applied):
- Static assets (JS, CSS): public, max-age=31536000, immutable
- Server responses: Based on your loader configurations
- API routes: Respect your custom cache headers

Database Integration

Automatic Optimizations:

  • Connection pooling tuned for Remix patterns

  • Regional database placement matching your deployment

  • Environment variable management for database URLs

Managed Databases (optional):

  • PostgreSQL

  • MySQL

  • MongoDB

Developer Experience

Local Development Compatibility

Your existing Remix development workflow remains completely unchanged:

# Development (unchanged)
npm run dev

# Build locally (unchanged)
npm run build

# Deploy to sherpa.sh
git push origin main  # Triggers automatic deployment

Build Process Insights

Monitor your deployments in real-time through the dashboard:

  • Build Time: Typical Remix builds complete in 60-120 seconds

  • Bundle Analysis: See which routes contribute to bundle size

  • Deployment Status: Real-time updates on build progress

Monitoring & Debugging

Real-Time Application Logs:

  • Live server console output

  • Route-specific performance metrics

  • Database query timing

  • Asset loading performance

Performance Insights:

  • Loader execution times per route

  • Server response times by geographic region

  • CDN cache hit rates

  • Bundle size analysis and trends

Configuration Examples

Custom Domain Setup

// In your remix.config.js
export default {
  // Your existing config remains unchanged
  // sherpa.sh automatically handles:
  // - SSL certificate provisioning
  // - DNS configuration
  // - CDN routing
};

Environment-Specific Variables

Set environment variables directly in the sherpa.sh dashboard:

# Production environment
DATABASE_URL=postgresql://...
SESSION_SECRET=your-secret-key
API_KEY=your-api-key

# Staging environment  
DATABASE_URL=postgresql://staging...
SESSION_SECRET=staging-secret
API_KEY=staging-api-key

Migration Guide

From Other Platforms

Key Migration Steps:

  1. Repository Connection: Link your existing Git repository

  2. Environment Variables: Transfer environment variables via dashboard

  3. Custom Domain: Configure your production domain

  4. Database: Update connection strings if needed

Build Configuration Compatibility

Sherpa.sh works with standard Vite configurations supported by Remix 2.7 and onward.

Enterprise Features

Advanced Performance

  • 100% Uptime SLA: Financial backing for service availability

  • Custom Edge Logic: Run code at 200+ global locations

  • Dedicated Infrastructure: Isolated compute for enterprise workloads

Team Collaboration

  • Role-Based Access: Granular deployment permissions

  • Audit Logging: Complete deployment history tracking

  • Multiple Environments: Staging, production, and custom environments

Support & Monitoring

  • 24/7 Monitoring: Automated performance tracking

  • Priority Support: Direct access to platform experts

  • Custom Integrations: Connect with existing DevOps workflows

Troubleshooting

Common Issues

Build Failures:

  • Check Node.js version compatibility (18+ required)

  • Verify all dependencies are listed in package.json

  • Review build logs in deployment dashboard

Route Issues:

  • Ensure your routes follow Remix file-based routing conventions

  • Check for conflicting route patterns

  • Verify loader and action exports are properly configured

Performance Issues:

  • Monitor loader execution times in dashboard

  • Check database connection region vs deployment region

  • Review asset bundle sizes for optimization opportunities

Getting Help

Next Steps

After deploying your first Remix application:

  1. Custom Domain: Connect your production domain in the dashboard

  2. Environment Variables: Configure secrets and API keys securely

  3. Team Access: Invite collaborators with appropriate permissions

  4. Monitoring Setup: Configure alerts for performance and errors

  5. Database Optimization: Fine-tune connection settings and regions

PreviousSveltekitNextNext.js

Last updated 2 days ago

Documentation: Comprehensive guides in our

Support: Join our

Ready to deploy your Remix app with better performance and lower costs?

Documetation
Discord community
Create your free account →