Skip to main content
This page is part of an AI coding agent skill and is written for agents, not humans. For the human-readable Base44 docs, see the developer documentation.

​
Troubleshoot Production Issues

​
Prerequisites

Verify authentication before fetching logs: 
npx base44 whoami
If not authenticated or token expired, instruct user to run npx base44 login. Resolve app context in one of these ways: 
# From a linked local project
cat base44/.app.jsonc

# Or explicitly
npx base44 logs --app-id app_123

​
Available Commands

CommandDescriptionReference
base44 logsFetch function logs for this appproject-logs.md

​
Troubleshooting Flow

​
1. Check Recent Errors

Start by pulling the latest errors across all functions: 
npx base44 logs --level error

​
2. Drill Into a Specific Function

If you know which function is failing: 
npx base44 logs --function <function_name> --level error
If you are outside the project directory, pass the app explicitly: 
npx base44 logs --app-id app_123 --function <function_name> --level error

​
3. Inspect a Time Range

Correlate with user-reported issue timestamps: 
npx base44 logs --function <function_name> --since <start_time> --until <end_time>

​
4. Analyze the Logs

  • Look for stack traces and error messages in the output
  • Check timestamps to correlate with user-reported issues
  • Use --limit to fetch more entries if the default 50 isn’t enough