README.md

Because real-backends matters!!

💥 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.