Skip to content

Social Card of this repo

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

bash
# 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

typescript
import { startProxy } from '@stacksjs/rpx'

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

Bun Plugin

typescript
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

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.

Credits

License

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

Made with 💙

Released under the MIT License.