General Troubleshooting Steps

Before diving into specific issues, try these general troubleshooting steps:

Svelte applications require configuring some additional polyfills for svelte and react preprocessing. The following example should cover these requirements.

Adding Svelte and React + Vite Preprocessing

First, ensure svelteKit is installed and configured correctly within the project’s vite.config.ts file.

npm i @sveltejs/kit

Then you’ll need to add the appropriate preprocessing and adapter dependencies to the project’s svelte.config.ts file.

npm i @sveltejs/vite-plugin-svelte @sveltejs/adapter-auto @svelte-preprocess @svelte-preprocess-react

Last, configure the vite.config.js and svelte.config.js project files to add preprocessing.

See the below code files for reference examples.

For more info, including CommonJS style configs, please see the Svelte-Preprocess Library Documentation

Example

Explore our example implementation of SvelteKit and Svelte with Vite:

Best Practices

  1. Use the Latest Versions: Always use the latest versions of Svelte, React, and Capsule SDK to ensure compatibility and access to the latest features.

  2. Error Handling: Implement error boundaries to gracefully handle any runtime errors related to Capsule integration.

  3. Development vs Production: Use environment-specific configurations to manage different settings for development and production builds. Capsule provides environment-specific API keys.

By following these troubleshooting steps and best practices, you should be able to resolve most common issues when integrating Capsule with your React application using Vite.

Integration Support

If you’re experiencing issues that aren’t resolved by our troubleshooting resources, please contact our team for assistance. To help us resolve your issue quickly, please include the following information in your request:

  1. 1

    A detailed description of the problem you’re encountering.

  2. 2

    Any relevant error messages or logs.

  3. 3

    Steps to reproduce the issue.

  4. 4

    Details about your system or environment (e.g., device, operating system, software version).

Providing this information will enable our team to address your concerns more efficiently.