Roxy

Roxy is a lightweight and efficient local development proxy that streamlines the process of handling custom domains and automatically handles HTTPS for local projects. With Roxy, there's no need to deal with multiple localhost ports or certificate warnings; simply access your projects using real .roxy domains with trusted HTTPS.

Key Features

• Custom .roxy Domains: Easily create memorable domains like myapp.roxy instead of complex localhost:3000 URLs.
• Trusted HTTPS: Roxy automatically generates SSL certificates that are recognized by your browser, eliminating certificate warnings.
• Path-based Routing: Configure different paths to route requests to various services and ports effortlessly.
• Built-in DNS Server: Roxy incorporates a built-in DNS server to manage .roxy domain resolutions without additional dependencies such as dnsmasq.
• Wildcard Subdomains: Register wildcard domains to manage subdomains without additional setup, allowing for testing of multi-tenant applications seamlessly.
• Real-time Traffic Visibility: Monitor HTTP requests and WebSocket connections with detailed logging capabilities.
• Single Binary with Zero Dependencies: Roxy is an all-in-one solution that requires no additional software like nginx or Docker, making it straightforward to use.

Perfect For

Roxy is especially beneficial for:

• Full-stack Developers: Conveniently run front-end and back-end services under memorable domains.
• Mobile App Developers: Test APIs that require HTTPS without needing tunnels.
• OAuth/Webhook Development: Seamless local testing for services like Stripe and GitHub.
• Team Collaboration: Easily share projects across devices on the same network.
• Microservices Development: Eliminate the need to memorize service ports.
• Multi-tenant SaaS Testing: Effortlessly use wildcard subdomains for tenant routing.

Example Usage

Register a new project and configure routing effortlessly:

# Register project with different routes
git register myapp.roxy --route "/=3000" --route "/api=3001"

Testing Stripe Webhooks

Easily register an e-commerce app to handle Stripe webhooks:

roxy register shopify-clone.roxy --route "/=3000" --route "/api=3001"

Just set your webhook URL to https://shopify-clone.roxy/api/webhooks and everything just works.

Installation

Installing Roxy is straightforward with Homebrew:

brew tap rbas/roxy
brew install roxy

Roxy's setup process creates trusted Root Certificates and configures the DNS to resolve .roxy domains automatically, requiring minimal setup from the user.

For evolving projects, Roxy is perfect for developers who wish to reduce complexity in their local development environment, offering a seamless experience simplified to register, route, and start the proxy—allowing developers to focus on building rather than configuring.