SPAship Router

Proxies paths to the right SPA location or pass to different origin.

Testing

| Command | Purpose | | --------------------- | --------------------------------------------- | | npm test | Run tests. | | npm test -- --watch | Run tests, and re-run them when files change. |

Pull requests and commit messages

This repo follows Conventional Commits, a standard format for writing commit messages. Each commit message becomes an entry in CHANGELOG.md, and the commit messages are also used to determine what version bump to apply.

Read more about Conventional Commits for a description and examples!

If you are working on a pull request, don't worry about commit message format. Commit early and often.

When your pull request is merged, "squash and merge" should be used, and a Conventional Commit message written at that point. In this way, your pull request will become a single commit in the master branch and one entry in the CHANGELOG will be created.

Configuration

Configuration can be provided by CLI flags, environment variables, or a configuration file. Arguments are processed in that order, so CLI flags take precedence over environment variables, which take precedence over the configuration file.

| Option | Description | CLI | Env | config.json | Default | | ------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------ | ---------------------------- | ------------------ | ----------------------- | | config file | Where to find the config file. | --config-file | SPASHIP_ROUTER_CONFIG_FILE | N/A | none | | webroot | Directory to extract/deploy SPAs. | --webroot | SPASHIP_WEBROOT | "webroot" | /var/www/html | | target | Proxy target, httpd location | --target | SPASHIP_TARGET | "target" | http://localhost:8080 | | port | Port to run on. | --port | SPASHIP_ROUTER_PORT | "port" | 8080 | | fallback | Optional fallback target if no spa route found | --fallback | SPASHIP_FALLBACK | "fallback" | none | | forwarded_host | Optional forwarded host if the router is behind a proxy | --forwarded_host | SPASHIP_FORWARDED_HOST | "forwarded_host" | none | | log-level | Granularity of log messages to print. Options are: fatal, error, warn, info, debug, trace or silent. | --log-level | SPASHIP_LOG_LEVEL | "log_level" | info | | log-format | pretty for human-friendly logs, json for machine-friendly logs. | --log-format | SPASHIP_LOG_FORMAT | "log_format" | pretty |

Note about the filepath configurations, config file and webroot: they must be absolute paths when defined in an environment variable or config file. When defined in CLI options like, they can be written relative to CWD. Example: --config-file=./config.json

Working behind a Proxy

If your setup any proxy before SPAship router, Router have to know the incoming host to send the correct host name to the SPA. There are 2 ways to do it

1. If your proxy support set x-forwarded-host, You should set up the user facing host on it.

   Ex: www.example.com

   x-forwarded-host: www.example.com

2. If your proxy not be able to custom, you can use the forwarded_host config parameter.

   Ex: www.example.com

   --forwarded_host=www.example.com

   or

   export SPASHIP_FORWARDED_HOST=www.example.com