> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samplehc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common troubleshooting steps and solutions for Sample Healthcare platform

## Upgrade workflows-py

Pull the latest workflows-py version from the template:

### 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

Pull the latest samplehc version from the template:

### 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

Pull the latest samplehc-ui version from the template:

### 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

Pull the latest lambda handler from the template:

### 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

Pull the latest app.tsx from the template:

### 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

If you encounter issues not covered in this guide, please contact our support team at [support@samplehc.com](mailto:support@samplehc.com).