Skip to content

salvoravida/localhostify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


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!
on off




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

About

Concurrently Hot Reload any environments! HTTP reverse proxy with Hot Reload, CORS, cookies, origin, referer and external redirect override!

Resources

License

Stars

Watchers

Forks

Packages

No packages published