Separate acul config commands from universal login

CUSTOMIZATION_GUIDE.md

@@ -38,11 +38,7 @@ This document provides essential information on **configuring the rendering mode
   - When set to `false` or omitted, the default template is used.
   - The **default is `false`**.
 
-### 🔹 7. Updating Rendering Mode
-- Switching to `"standard"` **only updates the `rendering_mode`**.
-- All other fields remain unchanged.
-
-### 🔹 8. Partial Updates
+### 🔹 7. Partial Updates
 - Only **explicitly declared fields** are updated.
 - **Unspecified fields remain as they are**.
 
@@ -109,7 +105,6 @@ This document provides essential information on **configuring the rendering mode
 - **Use `"standard"` mode for creating a consistent, branded experience for users. Choosing Standard mode will open a webpage
   within your browser where you can edit and preview your branding changes.For a comprehensive list of editable parameters and their values
 - **Ensure `head_tags` includes at least one `<script>` tag** for proper functionality.
-- **When switching to `"standard"`, only update `rendering_mode`**—all other fields should remain unchanged.
 - **Use `context_configuration` values carefully** to avoid exposing sensitive data.
 - **Always validate your JSON** before applying changes to prevent syntax errors and unexpected behavior.
 

docs/auth0_acul.md

@@ -0,0 +1,16 @@
+---
+layout: default
+has_toc: false
+has_children: true
+---
+# auth0 acul
+
+Customize the Universal Login experience. This requires a custom domain to be configured for the tenant.
+
+## Commands
+
+- [auth0 acul config](auth0_acul_config.md) - Configure Advanced Customizations for Universal Login screens.
+- [auth0 acul dev](auth0_acul_dev.md) - Start development mode for ACUL project with automatic building and asset watching.
+- [auth0 acul init](auth0_acul_init.md) - Generate a new ACUL project from a template
+- [auth0 acul screen](auth0_acul_screen.md) - Manage individual screens for Advanced Customizations for Universal Login.
+

docs/auth0_acul_config.md

@@ -0,0 +1,17 @@
+---
+layout: default
+has_toc: false
+has_children: true
+---
+# auth0 acul config
+
+Manage screen-level configuration for Auth0 Universal Login using ACUL (Advanced Customizations).
+
+## Commands
+
+- [auth0 acul config docs](auth0_acul_config_docs.md) - Open the ACUL configuration documentation
+- [auth0 acul config generate](auth0_acul_config_generate.md) - Generate a stub config file for a Universal Login screen.
+- [auth0 acul config get](auth0_acul_config_get.md) - Get the current rendering settings for a specific screen
+- [auth0 acul config list](auth0_acul_config_list.md) - List Universal Login rendering configurations
+- [auth0 acul config set](auth0_acul_config_set.md) - Set the rendering settings for a specific screen
+

docs/auth0_acul_config_docs.md

@@ -0,0 +1,42 @@
+---
+layout: default
+parent: auth0 acul config
+has_toc: false
+---
+# auth0 acul config docs
+
+Open the documentation for configuring Advanced Customizations for Universal Login screens.
+
+## Usage
+```
+auth0 acul config docs [flags]
+```
+
+## Examples
+
+```
+  auth0 acul config docs
+```
+
+
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 acul config docs](auth0_acul_config_docs.md) - Open the ACUL configuration documentation
+- [auth0 acul config generate](auth0_acul_config_generate.md) - Generate a stub config file for a Universal Login screen.
+- [auth0 acul config get](auth0_acul_config_get.md) - Get the current rendering settings for a specific screen
+- [auth0 acul config list](auth0_acul_config_list.md) - List Universal Login rendering configurations
+- [auth0 acul config set](auth0_acul_config_set.md) - Set the rendering settings for a specific screen
+
+

docs/auth0_acul_config_generate.md

@@ -0,0 +1,51 @@
+---
+layout: default
+parent: auth0 acul config
+has_toc: false
+---
+# auth0 acul config generate
+
+Generate a stub config file for a Universal Login screen and save it to a file.
+If fileName is not provided, it will default to <screen-name>.json in the current directory.
+
+## Usage
+```
+auth0 acul config generate [flags]
+```
+
+## Examples
+
+```
+  auth0 acul config generate <screen-name>
+  auth0 acul config generate <screen-name> --file settings.json
+  auth0 acul config generate signup-id
+  auth0 acul config generate login-id --file login-settings.json
+```
+
+
+## Flags
+
+```
+  -f, --file string   File to save the rendering configs to.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 acul config docs](auth0_acul_config_docs.md) - Open the ACUL configuration documentation
+- [auth0 acul config generate](auth0_acul_config_generate.md) - Generate a stub config file for a Universal Login screen.
+- [auth0 acul config get](auth0_acul_config_get.md) - Get the current rendering settings for a specific screen
+- [auth0 acul config list](auth0_acul_config_list.md) - List Universal Login rendering configurations
+- [auth0 acul config set](auth0_acul_config_set.md) - Set the rendering settings for a specific screen
+
+

docs/auth0_acul_config_get.md

@@ -0,0 +1,50 @@
+---
+layout: default
+parent: auth0 acul config
+has_toc: false
+---
+# auth0 acul config get
+
+Get the current rendering settings for a specific screen.
+
+## Usage
+```
+auth0 acul config get [flags]
+```
+
+## Examples
+
+```
+  auth0 acul config get <screen-name>
+  auth0 acul config get <screen-name> --file settings.json
+  auth0 acul config get signup-id
+  auth0 acul config get login-id -f ./acul_config/login-id.json
+```
+
+
+## Flags
+
+```
+  -f, --file string   File to save the rendering configs to.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 acul config docs](auth0_acul_config_docs.md) - Open the ACUL configuration documentation
+- [auth0 acul config generate](auth0_acul_config_generate.md) - Generate a stub config file for a Universal Login screen.
+- [auth0 acul config get](auth0_acul_config_get.md) - Get the current rendering settings for a specific screen
+- [auth0 acul config list](auth0_acul_config_list.md) - List Universal Login rendering configurations
+- [auth0 acul config set](auth0_acul_config_set.md) - Set the rendering settings for a specific screen
+
+

docs/auth0_acul_config_list.md

@@ -0,0 +1,58 @@
+---
+layout: default
+parent: auth0 acul config
+has_toc: false
+---
+# auth0 acul config list
+
+List Universal Login rendering configurations with optional filters and pagination.
+
+## Usage
+```
+auth0 acul config list [flags]
+```
+
+## Examples
+
+```
+  auth0 acul config list --prompt reset-password
+  auth0 acul config list --rendering-mode advanced --include-fields true --fields head_tags,context_configuration
+```
+
+
+## Flags
+
+```
+      --fields string           Comma-separated list of fields to include or exclude in the result (based on value provided for include_fields) 
+      --include-fields          Whether specified fields are to be included (true) or excluded (false). (default true)
+      --include-totals          Return results inside an object that contains the total result count (true) or as a direct array of results (false).
+      --json                    Output in json format.
+      --json-compact            Output in compact json format.
+      --page int                Page index of the results to return. First page is 0.
+      --per-page int            Number of results per page. Default value is 50, maximum value is 100. (default 50)
+      --prompt string           Filter by the Universal Login prompt.
+  -q, --query string            Advanced query.
+      --rendering-mode string   Filter by the rendering mode (advanced or standard).
+      --screen string           Filter by the Universal Login screen.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 acul config docs](auth0_acul_config_docs.md) - Open the ACUL configuration documentation
+- [auth0 acul config generate](auth0_acul_config_generate.md) - Generate a stub config file for a Universal Login screen.
+- [auth0 acul config get](auth0_acul_config_get.md) - Get the current rendering settings for a specific screen
+- [auth0 acul config list](auth0_acul_config_list.md) - List Universal Login rendering configurations
+- [auth0 acul config set](auth0_acul_config_set.md) - Set the rendering settings for a specific screen
+
+

docs/auth0_acul_config_set.md

@@ -0,0 +1,50 @@
+---
+layout: default
+parent: auth0 acul config
+has_toc: false
+---
+# auth0 acul config set
+
+Set the rendering settings for a specific screen.
+
+## Usage
+```
+auth0 acul config set [flags]
+```
+
+## Examples
+
+```
+  auth0 acul config set <screen-name>
+  auth0 acul config set <screen-name> --file settings.json
+  auth0 acul config set signup-id --file settings.json
+  auth0 acul config set login-id
+```
+
+
+## Flags
+
+```
+  -f, --file string   File to save the rendering configs to.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 acul config docs](auth0_acul_config_docs.md) - Open the ACUL configuration documentation
+- [auth0 acul config generate](auth0_acul_config_generate.md) - Generate a stub config file for a Universal Login screen.
+- [auth0 acul config get](auth0_acul_config_get.md) - Get the current rendering settings for a specific screen
+- [auth0 acul config list](auth0_acul_config_list.md) - List Universal Login rendering configurations
+- [auth0 acul config set](auth0_acul_config_set.md) - Set the rendering settings for a specific screen
+
+

docs/auth0_acul_dev.md

@@ -0,0 +1,78 @@
+---
+layout: default
+parent: auth0 acul
+has_toc: false
+---
+# auth0 acul dev
+
+Start development mode for an ACUL project. This command:
+- Runs 'npm run build' to build the project initially
+- Watches the dist directory for asset changes
+- Automatically patches screen assets when new builds are created
+- Supports both single screen development and all screens
+
+The project directory must contain package.json with a build script.
+
+DEV MODE (default):
+- Requires: --port flag for the local development server
+- Runs your build process (e.g., npm run screen <name>) for HMR development
+
+CONNECTED MODE (--connected):
+- Requires: --screens flag to specify screens to patch in Auth0 tenant  
+- Updates advance rendering settings of the chosen screens in your Auth0 tenant
+- Runs initial build and expects you to host assets locally
+- Optionally runs build:watch in the background for continuous asset updates
+- Watches and patches assets automatically when changes are detected
+
+⚠️  Connected mode should only be used on stage/dev tenants, not production!
+
+## Usage
+```
+auth0 acul dev [flags]
+```
+
+## Examples
+
+```
+  # Dev mode
+  auth0 acul dev --port 55444
+  auth0 acul dev -p 55444 --dir ./my_project
+
+  # Connected mode
+  auth0 acul dev --connected
+  auth0 acul dev --connected --debug --dir ./my_project
+  auth0 acul dev --connected --screens all
+  auth0 acul dev -c --dir ./my_project
+  auth0 acul dev --connected --screens login-id
+  auth0 acul dev -c -s login-id,signup
+```
+
+
+## Flags
+
+```
+  -c, --connected         Enable connected mode to update advance rendering settings of Auth0 tenant. Use only on stage/dev tenants.
+  -d, --dir string        Path to the ACUL project directory (must contain package.json).
+  -p, --port string       Port for the local development server.
+  -s, --screens strings   Specific screens to develop and watch.
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 acul config](auth0_acul_config.md) - Configure Advanced Customizations for Universal Login screens.
+- [auth0 acul dev](auth0_acul_dev.md) - Start development mode for ACUL project with automatic building and asset watching.
+- [auth0 acul init](auth0_acul_init.md) - Generate a new ACUL project from a template
+- [auth0 acul screen](auth0_acul_screen.md) - Manage individual screens for Advanced Customizations for Universal Login.
+
+