Skip to main content

Troubleshooting

This page covers common issues you might encounter when using the Zopio CLI and provides solutions to resolve them.

Installation Problems

Error: EACCES: permission denied

Solution:

Error: Cannot find module ‘zopio-cli’

Solution:

Command Execution Issues

Error: Unknown command

Solution:

Error: Missing required argument

Solution:

Project Initialization Issues

Error: Directory already exists

Solution:

Error: Failed to download template

Solution:

Code Generation Issues

Error: Invalid field format

Solution:

Error: Template not found

Solution:

Internationalization Issues

Error: Locale already exists

Solution:

Error: Missing translation files

Solution:

Debugging

You can enable debug mode to get more detailed logs:

Logs

The CLI logs are stored in the following locations:
  • Windows: %USERPROFILE%\.zopio\logs
  • macOS/Linux: ~/.zopio/logs
You can view the logs to diagnose issues:

Configuration Reset

If you suspect your CLI configuration is corrupted, you can reset it: