localhostify
v0.3.3
Published
Easy HTTP reverse proxy - localhost:3001 -> prod.domain.com
Downloads
8
Readme
💥 localhostify
Concurrently Hot Reload any environments! HTTP reverse proxy with Hot Reload, CORS, cookies, origin, referer and external redirect override!
locahost:3001 === https://prod.domain.com/api/* & http://localhost:3000/*
locahost:3002 === https://staging.domain.com/api/* & http://localhost:3000/*
ℹ️ Config
.localhostify.js
module.exports = {
prod: {
port: 3001,
target: {
host: 'https://prod.domain.com',
matchUrl: '^\\/api*',
// changeOrigin: true, //default value
// autoRewrite: true, //default value
// protocolRewrite: 'http', //default value
},
local: { //optional obj if all default values
// changeOrigin: true, //default value
// autoRewrite: true, //default value
// host: 'http://localhost:3000' //default value
},
externalRedirects: [ //optional if needed
{
match: '/api/auth/callback',
replace: ['https://prod.domain.com', 'http://localhost:3001'],
},
],
// allowHeaders: 'content-type', //default cors value
},
staging: {
port: 3002,
target: {
host: 'https://staging.domain.com',
matchUrl: '^\\/api*',
},
},
};
💥 Run
your-dev-server start
npx localhostify prod
npx localhostify staging
Browse http://localhost:3001
and http://localhost:3002
to enjoy local frotend mixed with real backends enviroments! Hot reload works concurrently!!
🍭 External Redirects
If your application use external login or SSO you will need to forward browser redirect to localhost. This happens on the browser side, so we need a web extension.
npx localhostify --chrome-ext
This command will create a folder "localhostify-ext" on your project. Load it on Chrome Extensions Tab (Enable Dev Mode to see the LOAD button). That's all!.
Note: if you update your .localhostify.js config, please execute again npx localhostify --chrome-ext
to update also the ext.
It the browser is opened, refresh all the exstensions.
Disable the ext if you are on prod.domain.com
, otherwise it will redirect to locahost!
👏 Contributing
If you are interested in contributing to localhostify
, open an issue or a pr!
🎉 Credits
Thank You, Open Source! Chrome Ext inspired by requestly.io
📜 License
localhostify
is 100% free and open-source, under MIT.