express-set-domain/README.md

Force an express app to use a particular domain

# express-set-domain

Force an express app to use a particular domain by 301 redirecting none matching requests.

## Install

```bash
npm install --save express-set-domain
```

## Usage

Add to your express application before all other routes.

```js
var express = require('express');
var app = express();
var setDomain = require('express-set-domain');

// add middleware to force requests to orcascan.com
app.use(setDomain('orcascan.com'));

// typical route
app.get('/docs/integrations/scan-barcodes-into-microsoft-excel', function(req, res) {
    res.send('How to scan barcodes into spreadsheets!');
});
```

Based on the above example, a request to:

http://www.orcascan.com/docs/integrations/scan-barcodes-into-microsoft-excel

would be 301 redirected to:

http://orcascan.com/docs/integrations/scan-barcodes-into-microsoft-excel

without having to list every potential incoming domain name.

## Contributing

Feel free to contribute, either by [raising an issue](https://github.com/john-doherty/express-set-domain/issues) or:

1. Fork it!
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -m 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request

## Star the repo

If you find this useful please star the repo, it helps us prioritize which open source bugs to fix :raised_hands:

## History

For change-log, check [releases](https://github.com/john-doherty/express-set-domain/releases).

## License

Licensed under [MIT License](LICENSE) © [John Doherty](https://twitter.com/mrjohndoherty)