A zero-config reverse proxy for local development with SSL support, custom domains, and more.
- Simple Reverse Proxy
- Custom Domains (with wildcard support)
- Dependency-Free
- Zero-Config Setup
bun install -d @stacksjs/reverse-proxyThere are two ways of using this reverse proxy: as a library or as a CLI.
Given the npm package is installed:
import { startProxy } from '@stacksjs/reverse-proxy'
startProxy({
from: 'localhost:3000',
to: 'my-project.localhost' // or try 'my-project.test'
})reverse-proxy --from localhost:3000 --to my-project.localhost
reverse-proxy --from localhost:8080 --to my-project.test --keyPath ./key.pem --certPath ./cert.pem
reverse-proxy --help
reverse-proxy --versionThe Reverse Proxy can be configured using a reverse-proxy.config.ts (or reverse-proxy.config.js) file and it will be automatically loaded when running the reverse-proxy command.
// reverse-proxy.config.ts (or reverse-proxy.config.js)
export default {
'localhost:3000': 'stacks.localhost'
}Then run:
reverse-proxy startTo learn more, head over to the documentation.
bun testPlease see our releases page for more information on what has changed recently.
Please review the Contributing Guide for details.
For help, discussion about best practices, or any other conversation that would benefit from being searchable:
For casual chit-chat with others using this package:
Join the Stacks Discord Server
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
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.
The MIT License (MIT). Please see LICENSE for more information.
Made with 💙