CLI Authentication

Authenticate your CLI tool with your Zid partner account.

Description

The login command initiates the authentication process, enabling you to connect your CLI tool with your Zid partner account. Authentication is required to access most zid-theme commands.

Usage

Authentication Process

Run the Command:

Local Server Initialization:

A local Express server starts on port 4444.

Browser Redirect:

Your default web browser automatically opens, directing you to the Zid Partner Dashboard.

Log in:

Use your Zid partner account credentials to log in.

Redirect & Completion:

After successful login, the dashboard redirects you back to the local server.

Token Storage:

The CLI tool securely stores your authentication tokens locally.

Important Notes

An active internet connection is required.

Ensure port 4444 is available on your machine. If it's in use by another application, the authentication flow may not work.

Your login session is stored locally and securely. You won’t need to log in again unless:

Your session expires.

You manually log out.

Example Workflow

Output:

Starting authentication process...
Opening Zid Partner Dashboard in your default browser...
Waiting for authentication...

Final Output:

Successfully authenticated! You can now use zid-theme commands.

Troubleshooting

If you encounter issues during the login process, try the following:

Problem	Solution
Internet connection issues	Ensure you have a stable internet connection.
Port 4444 is unavailable	Check if port 4444 is free or stop other applications using the port.
Browser does not open automatically	Open your browser and manually navigate to: `http://localhost:4444`.
Persistent login issues	Clear your browser cache and cookies, then retry.

Security

Your authentication tokens are stored securely on your local machine.

To protect your account information:

Always use the official zid-theme CLI tool.

Keep your system secure.

Learn More

For more information on theme development and deployment, refer to the Zid Theme Development Documentation.

CLI Authentication

Description#

Usage#

Authentication Process#

Important Notes#

Example Workflow#

Troubleshooting#

Security#

Learn More#