# switchToApp

Change from one application to another.

## Arguments

1. `appName` (*string*): Application name equivalent to the value specified in the application's `package.json` file.
2. `queryParameters` (*Object, Optional*): Plain object with keys used query parameters with their respective values. **Note that keys will be converted from camelCase to kebab-case**.

## Returns

(`Promise<void>`): A promise that fulfills without arguments.

## Example

```javascript
import lampix from '@lampix/core';

lampix.switchToApp('trivia');

// or

lampix.switchToApp('trivia', {
  switchBackTo: 'survey',
  specialInformation: 42
});

// Query parameters can be easily accessed as follows:
// (also note the camelCase to kebab-case transformation)
// const queryParams = new URLSearchParams(window.location.search);
// queryParams.get('switch-back-to'); // survey
// queryParams.get('special-information') // '42'
```

## Notes

`switchBackTo` is a special query parameter used in the [`exit()`](https://github.com/lampix-org/lampixjs-core/tree/aae985faf1cdc0c2159f49817193a66853c0eb5d/docs/app-dev/lampixjs/api/exit.md) method to determine whether to switch to the default app (currently `app-switcher`) or the app specified as the value for this parameter.