Common Issues

File Generation Issue

Problem: Files are not being generated

No files were generated

Solution:

• Check file permissions in your Laravel project directories

• Ensure the YAML file exists and is readable

• Verify the paths in config/sketch.php are correct

'paths' => [
    'models' => app_path('Models'),
    'migrations' => database_path('migrations'),
    'actions' => app_path('Actions'),
    'requests' => app_path('Http/Requests'),
],

YAML Parsing Issue

Problem: Invalid YAML syntax error

Failed to parse YAML file: Unable to parse at line 2

Solution:

• Check indentation (use spaces, not tabs)

• Validate YAML syntax using online tools

• Ensure all required fields are present

# Correct
model: Post
fields:
    - { name: title, type: string }

# Incorrect
model: Post
fields:
- {name:title,type:string}  # Missing spaces

Relationships Issue

Problem: Invalid relationship configuration

Unknown relationship type or missing required fields

Solution:

• Verify model names exist

• Check relationship type spelling

• Ensure all required relationship fields are present

# Correct
relationships:
    - { type: belongsTo, model: User, foreignKey: user_id }

# Incorrect
relationships:
    - { type: belongs_to, model: user }  # Wrong type format and missing foreignKey