Troubleshooting

​

Upgrade workflows-py

​

Steps

1. Pull the latest workflows-py package from the workflow-template
2. Copy the updated package to your project
3. Verify compatibility with existing workflows

​

Common Issues

• Version conflicts: Check for incompatible dependencies
• Breaking changes: Review the changelog for any breaking changes
• Import errors: Update import statements if module structure changed
• Workflow compatibility: Ensure existing workflows work with the new version
• API changes: Check if workflow API methods have changed
• Configuration updates: Update workflow configuration files if needed
• Step definitions: Verify custom step definitions are still compatible

​

Upgrade samplehc

​

Steps

1. Pull the latest samplehc package

​

Common Issues

• API changes: Verify API endpoints are still compatible
• Configuration changes: Update configuration files if needed

​

Upgrade samplehc-ui

​

Steps

1. Pull the latest samplehc-ui package from the workflow-template
2. Copy the updated UI components to your project
3. Test UI components thoroughly

​

Common Issues

• Component props changes: Update component props according to new API
• Styling conflicts: Resolve any CSS or styling conflicts
• Theme compatibility: Ensure theme configurations are compatible

​

Pull latest lambda handler

​

Steps

1. Pull the latest lambda handler code from the workflow-template
2. Backup existing handler configurations
3. Copy the updated handler to your project
4. Merge any custom modifications
5. Deploy and test the updated handlers

​

Common Issues

• Environment variables: Update environment variables if required
• Permission changes: Verify IAM permissions are still valid
• Runtime compatibility: Check if runtime version is supported

​

Pull latest app.tsx

​

Steps

1. Pull the latest app.tsx from the workflow-template
2. Backup your current app.tsx file
3. Copy the updated app.tsx to your project
4. Merge your custom changes
5. Test the application thoroughly

​

Common Issues

• Route changes: Update routing configuration if needed
• Provider changes: Check if context providers have changed
• Hook usage: Verify custom hooks are still compatible
• State management: Update state management logic if required

​

General Troubleshooting Tips

​

Before Upgrading

• Always backup your current configuration
• Review changelogs and release notes
• Test in a development environment first

​

Getting Help