view release on metacpan or  search on metacpan

CLI.md  view on Meta::CPAN

trickster server --port 3000
```

## Tips

### Project Structure

Keep your code organized:

```
myapp/
├── lib/
│   └── Myapp/
│       ├── Controller/      # HTTP handlers
│       ├── Model/           # Business logic
│       ├── Service/         # External services
│       └── Util/            # Utilities
├── templates/
│   ├── layouts/             # Page layouts
│   ├── partials/            # Reusable components
│   └── [feature]/           # Feature templates
└── public/
    ├── css/
    ├── js/
    └── images/
```

### Development Workflow

1. **Start with auto-reload:**
   ```bash
   trickster server --reload
   ```

2. **Generate components as needed:**
   ```bash
   trickster generate controller Feature
   ```

3. **Test frequently:**
   ```bash
   prove -l t/
   ```

4. **Use version control:**
   ```bash
   git init
   git add .
   git commit -m "Initial commit"
   ```

### Production Deployment

For production, use a production-grade PSGI server:

```bash
# Install Starman
cpanm Starman

# Run with multiple workers
starman --workers 10 --port 5678 app.psgi
```

Or with uWSGI:

```bash
uwsgi --http :5678 --psgi app.psgi --master --processes 4
```

## Troubleshooting

### Command not found

If `trickster` command is not found after installation:

```bash
# Check if it's installed
which trickster

# If not, ensure Perl bin directory is in PATH
export PATH="$HOME/perl5/bin:$PATH"

# Or use full path
perl -Ilib bin/trickster
```

### Permission denied

Make sure the script is executable:

```bash
chmod +x bin/trickster
```

### Module not found

Install dependencies:

```bash
cpanm --installdeps .
```

## Future Enhancements

Planned features for future versions:

- Interactive mode for project creation
- Database migration commands
- Test generation
- API documentation generation
- Deployment helpers
- Plugin management
- Route inspection and testing
- Performance profiling

## Contributing

Have ideas for CLI improvements? Contributions are welcome!

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.