A Better Developer Experience

A zero-config reverse proxy for local development with SSL support, custom domains, and more.

Features

• Simple, lightweight Reverse Proxy
• Custom Domains (with wildcard support)
• Zero-Config Setup
• SSL Support (HTTPS by default)
• Auto HTTP-to-HTTPS Redirection
• Self /etc/hosts Management
• Bun Plugin for seamless integration

Usage Options

CLI

# Simple usage
rpx --from localhost:3000 --to my-app.test

# With HTTPS (enabled by default)
rpx --from localhost:5173 --to my-app.test --https

Library

import { startProxy } from '@stacksjs/rpx'

startProxy({
  from: 'localhost:3000',
  to: 'my-app.test',
  https: true
})

Bun Plugin

import rpxPlugin from 'bun-plugin-rpx'

export default {
  plugins: [
    rpxPlugin({
      domain: 'my-app.test', // Optional, uses package.json name if not specified
      https: true // Optional, default is true
    })
  ]
}

Changelog

Please see our releases page for more information on what has changed recently.

Stargazers

Contributing

Please review the Contributing Guide for details.

Community

For help, discussion about best practices, or any other conversation that would benefit from being searchable:

Discussions on GitHub

For casual chit-chat with others using this package:

Join the Stacks Discord Server

Postcardware

Two things are true: Stacks OSS will always stay open-source, and we do love to receive postcards from wherever Stacks is used! 🌍 We also publish them on our website. And thank you, Spatie

Our address: Stacks.js, 12665 Village Ln #2306, Playa Vista, CA 90094

Sponsors

We would like to extend our thanks to the following sponsors for funding Stacks development. If you are interested in becoming a sponsor, please reach out to us.

• JetBrains
• The Solana Foundation

Credits

• Chris Breuer
• All Contributors

License

The MIT License (MIT). Please see LICENSE for more information.

Made with 💙