Troubleshooting

Troubleshooting Common Issues

Here are solutions to common problems you might encounter when working with Flowa.

Parser Errors

"Parser error: left side of assignment must be an identifier"

Cause: Trying to use unsupported assignment operators.

Solution: Ensure assignments use a = a + 1 instead of a += 1.

// Incorrect
count += 1;
 
// Correct
count = count + 1;

Runtime Errors

"Unknown module"

Cause: Importing a module that doesn't exist or using wrong capitalization.

Solution:

  • Verify module name is correct and case-sensitive.
  • Available modules: fs, json, auth, jwt, mail, config, log, sqlite, cron, http, os.

"Undefined variable"

Cause: Using a variable that hasn't been declared with let or is out of scope.

Solution:

  • Declare with let before use.
  • Check variable scope (local vs global).
// Incorrect
x = 10;
 
// Correct
let x = 10;

Module Specific

Email sending fails

Cause: SMTP configuration issues.

Solution:

  • Verify .env SMTP configuration.
  • Gmail requires App Password, not regular password.
  • Check network connectivity.
# Check if you can reach the SMTP server
telnet smtp.gmail.com 587

Installation Issues

"Command not found: flowa"

Solution: Add the installation path to your system PATH.

export PATH="/usr/local/bin:$PATH"

Build failures

Solution: Ensure you have a C++17 compatible compiler (Clang/GCC) and CMake installed.

Still having trouble?

ExamplesAPI Reference