Custom Configuration Options
The Configuration section allows developers to customize the Sequence Kit by passing options to the KitProvider wrapper.
Developers can customize the Sequence Kit experience by passing configuration options to the SequenceKit
wrapper.
Here’s how you can configure the kit using these options:
Configuration Overview
The following is the available configuration customization options, or, see below for all the options in-depth:
Custom Styling and Design
You can customize the visual appearance of Sequence Kit by providing a custom theme object to the defaultTheme
configuration option. Here’s an example of how to implement custom styling:
Available Theme Variables
The following theme variables can be customized:
You can override any combination of these variables to create your custom theme. The values can be provided in any valid CSS color format (rgba, hex, named colors, etc.).
Available Options
Sequence App Development
appName
Type | Default |
---|---|
string | undefined |
An internal software naming value that is not presented to the user.
projectAccessKey
Type | Default |
---|---|
string | undefined |
The project access key that is required, obtained from Sequence Builder
ethAuth
as EthAuthSettings
waasConfigKey
Type | Default |
---|---|
string | undefined |
The Embedded Wallet configuration key required for WaaS wallets, configured within the Sequence Builder.
Network
chainIds
Type | Default |
---|---|
number[] | undefined |
A list of chain Ids. e.g. [1, 137]
defaultChainId
Type | Default |
---|---|
number | undefined |
The chain Id that is first used for signatures and transactions.
UI
User Interface based parameters that augment the modal interface.
Sign In Modal Configuration (signIn
)
The signIn
object is used to configure the sign in modal.
signIn.logoUrl
Type | Default |
---|---|
string | undefined |
URL of the logo to be shown in the sign in modal.
signIn.projectName
Type | Default |
---|---|
string | undefined |
Name of the project to be shown in the sign in modal.
signIn.useMock
Type | Default |
---|---|
boolean | undefined |
Removes the ability to make live blockchain requests if set to true
by using the wagmi mock connector
position
Type | Default |
---|---|
string | center |
The position parameter determines the location of the various modals on the screen. Possible values include:
- center
- middle-right
- middle-left
- top-center
- top-right
- top-left
- bottom-center
- bottom-right
- bottom-left
defaultTheme
Type | Default |
---|---|
string or object | dark |
The defaultTheme determines the color palette used for styling the modal. Possible values include:
- ‘light’
- ‘dark’
- object
Specific colors can be overwritten by passing a theme override object. The Sequence Builder provides a useful playground for toying with the colors in Sequence Kit.
Wallet
Parameters that entail wallet configuration options
disableAnalytics
Type | Default |
---|---|
boolean | undefined |
Turning on and off the analytics feature that is connected to your Sequence Builder project.
displayedAssets
Type | Default |
---|---|
[{ contractAddress: string, chainId: number }, …] | undefined |
If provided, this will determine which assets are to be displayed in the in-game wallet modal main view. By passing a list of displayed assets, only assets from the provided list will be displayed in the main view. In the case that no assets are provided, all owned assets can be displayed in the main view.
enableConfirmationModal
Type | Default |
---|---|
boolean | undefined |
Enable confirmations for when sending transaction
Sign in providers
The various sign in providers that create wallet connections for the user:
walletConnect
Type | Default |
---|---|
false | { projectId: string } | undefined |
google
Type | Default |
---|---|
false | { clientId: string } | undefined |
apple
Type | Default |
---|---|
false | { clientId: string, redirectURI: string } | undefined |
email
Type | Default |
---|---|
boolean | { legacyEmailAuth: boolean } | undefined |
Create Universal Default Connectors
While we generally recommed using Embedded Wallets with SequenceKit, as an alternative, you can also use leverage our Universal Wallet configuration. When creating a wagmi connectors
variable, import the getDefaultConnectors
function from the @0xsequence/kit
package, and include a Wallet Connect ID obtained from here, a default chain ID, app name, and the projectAccessKey
, then continue with the integration from the quickstart.
Was this page helpful?