Redirect CLI commands
The commands in this section allow you to manage project assets that involve Uniform's redirect features. This includes:
| Project asset | Command | More information |
|---|---|---|
| Redirect commands | redirect | Capabilities |
Redirect commands#
These commands should be added as a script command in your project, rather than run directly in the terminal. For example, in the package.json file of a next.js project:
"scripts": {
"uniform:fetch-redirects": "uniform redirect definition list"
},
Get redirects#
uniform redirect definition get <id>
command
Fetch a redirect definition from the Uniform project.
| Command | Output details |
|---|---|
| -f, --format string (optional, default value: YAML) | Format for the output. YAML JSON |
| -o, --filename string (optional) | File name for the output. If not specified the output is written to stdout. |
| -p, --project string | Uniform project id. If not specified, the environment variable UNIFORM_CLI_PROJECT_ID is used. |
| --apiKey string | Uniform API key. If not specified, the environment variable UNIFORM_API_KEY is used. |
| --apiHost string (optional, default value: https://uniform.app) | Uniform host. If not specified, the environment variable UNIFORM_CLI_BASE_URL is used. If the environment variable isn't set, the default value is used. |
| --proxy string (optional) | Proxy server. If not specified, the following environment variables are used (with the first match being used): HTTPS_PROXY, https_proxy, ALL_PROXY, all_proxy. If no match is found, no proxy server is used. |
List Redirects#
uniform redirect definition list
command
List redirect definitions from the Uniform project.
| Command | Output details |
|---|---|
| --offset integer (optional) | Number of rows to skip before fetching. |
| --limit integer (optional, default value: 20) | Number of rows to fetch. |
| -f, --format string (optional, default value: YAML) | Format for the output. YAML JSON |
| -o, --filename string (optional) | File name for the output. If not specified the output is written to stdout. |
| -p, --project string | Uniform project id. If not specified, the environment variable UNIFORM_CLI_PROJECT_ID is used. |
| --apiKey string | Uniform API key. If not specified, the environment variable UNIFORM_API_KEY is used. |
| --apiHost string (optional, default value: https://uniform.app) | Uniform host. If not specified, the environment variable UNIFORM_CLI_BASE_URL is used. If the environment variable isn't set, the default value is used. |
| --proxy string (optional) | Proxy server. If not specified, the following environment variables are used (with the first match being used): HTTPS_PROXY, https_proxy, ALL_PROXY, all_proxy. If no match is found, no proxy server is used. |
Pull Redirect#
uniform redirect definition pull <directory or file path>
command
Fetch all Redirect definitions from the Uniform project and save them locally.
- If a directory path is specified, a separate file is created for each Redirect.
- If a file path is specified, all Redirect definitions are saved in a single file.
| Command | Output details |
|---|---|
| -w, --what-if boolean (optional) | If true, reports what would be done but changes no files. |
| -m, --mode string (optional, default value: mirror) | Specifies what kind of changes can be made.create - Create new files but don't update existing files.createOrUpdate - Create new files and update existing files but delete no files.mirror - Create new files, update existing files, and delete files that don't match components in the Uniform project. |
| -d, --diff string (optional, default value: off) | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used.off - No changes are written.update - Only update changes are written.on - Update, create, and delete changes are written. |
| -f, --format string (optional, default value: YAML) | Format for the output. YAML JSON |
| -p, --project string | Uniform project id. If not specified, the environment variable UNIFORM_CLI_PROJECT_ID is used. |
| --apiKey string | Uniform API key. If not specified, the environment variable UNIFORM_API_KEY is used. |
| --apiHost string (optional, default value: https://uniform.app) | Uniform host. If not specified, the environment variable UNIFORM_CLI_BASE_URL is used. If the environment variable isn't set, the default value is used. |
| --proxy string (optional) | Proxy server. If not specified, the following environment variables are used (with the first match being used): HTTPS_PROXY, https_proxy, ALL_PROXY, all_proxy. If no match is found, no proxy server is used. |
tip
If file name is specified, CLI will override only corresponding part of it (for example, pulling Redirect will only override Redirect section, but leave Canvas section in the same file intact). It allows you to create single file containing whole project export (Canvas + Context + Redirect). This isn't recommended for big projects. Learn about backing up to a single file.
Push redirect#
uniform redirect definition push <directory or file path>
command
Insert or update all Redirect definitions from local disk to the Uniform project.
- If a directory path is specified, the Redirect defined in the files in the directory used.
- If a file path is specified, the Redirect in the file are used.
| Command | Output details |
|---|---|
| -w, --what-if boolean (optional) | If true, reports what would be done but changes no files. |
| -m, --mode string (optional, default value: mirror) | Specifies what kind of changes can be made.create - Create new files but don't update existing files.createOrUpdate - Create new files and update existing files but delete no files.mirror - Create new files, update existing files, and delete files that don't match components in the Uniform project. |
| -d, --diff string (optional, default value: off) | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used.off - No changes are written.update - Only update changes are written.on - Update, create, and delete changes are written. |
| -p, --project string | Uniform project id. If not specified, the environment variable UNIFORM_CLI_PROJECT_ID is used. |
| --apiKey string | Uniform API key. If not specified, the environment variable UNIFORM_API_KEY is used. |
| --apiHost string (optional, default value: https://uniform.app) | Uniform host. If not specified, the environment variable UNIFORM_CLI_BASE_URL is used. If the environment variable isn't set, the default value is used. |
| --proxy string (optional) | Proxy server. If not specified, the following environment variables are used (with the first match being used): HTTPS_PROXY, https_proxy, ALL_PROXY, all_proxy. If no match is found, no proxy server is used. |
Remove Redirect#
uniform redirect definition remove <id>
command
Delete a Redirect definition from the Uniform project.
| Command | Output details |
|---|---|
| -p, --project string | Uniform project id. If not specified, the environment variable UNIFORM_CLI_PROJECT_ID is used. |
| --apiKey string | Uniform API key. If not specified, the environment variable UNIFORM_API_KEY is used. |
| --apiHost string (optional, default value: https://uniform.app) | Uniform host. If not specified, the environment variable UNIFORM_CLI_BASE_URL is used. If the environment variable isn't set, the default value is used. |
| --proxy string (optional) | Proxy server. If not specified, the following environment variables are used (with the first match being used): HTTPS_PROXY, https_proxy, ALL_PROXY, all_proxy. If no match is found, no proxy server is used. |
Update Redirect#
uniform redirect definition update <filename>
command
Insert or update a Redirect definition from a local file to the Uniform project.
| Command | Output details |
|---|---|
| -p, --project string | Uniform project id. If not specified, the environment variable UNIFORM_CLI_PROJECT_ID is used. |
| --apiKey string | Uniform API key. If not specified, the environment variable UNIFORM_API_KEY is used. |
| --apiHost string (optional, default value: https://uniform.app) | Uniform host. If not specified, the environment variable UNIFORM_CLI_BASE_URL is used. If the environment variable isn't set, the default value is used. |
| --proxy string (optional) | Proxy server. If not specified, the following environment variables are used (with the first match being used): HTTPS_PROXY, https_proxy, ALL_PROXY, all_proxy. If no match is found, no proxy server is used. |