The fastest way to get started a new project with Svelte is to use the Mesh-CLI, which will scaffold a new project for you. To do this, run the following:

npx meshjs your-app-name

During the installation process, you will be asked to choose a template. Choose the Svelte template. This will scaffold a new Svelte project with Mesh pre-installed.

To manually, install the Mesh Svelte package, run the following:

npm install @meshsdk/svelte

Next, add the Mesh CSS to your application, doing so will apply the default styles to the components. You can add this in +layout.svelte.

<script lang="ts">
	import '@meshsdk/svelte/styles.css';
	let { children } = $props();
</script>

{@render children()}

In order for dApps to communicate with the user's wallet, we need a way to connect to their wallet.

Add this CardanoWallet to allow the user to select a wallet to connect to your dApp. After the wallet is connected, see Browser Wallet for a list of CIP-30 APIs.

The signature for the CardanoWallet component is as follows:

{
  label?: string;
  onConnected?: Function;
  isDark?: boolean;
}

Customization

For dark mode style, add isDark.

<CardanoWallet isDark={true} />

For a custom label, add the label prop.

<CardanoWallet label={"Connect a Wallet"} />

The customization is limited. For more customization, you can easily build your own wallet connection component. You may also take reference from this component.

onConnected

If you want to run a function after the wallet is connected, you can add the onConnected prop.

export default function Page() {

  function afterConnectedWallet() {
    // do something
  }

  return (
    <>
      <CardanoWallet onConnected={afterConnectedWallet} />
    </>
  );
}

The above code will log "Hello, World!" to the console when the wallet is connected.

Obtain information on the current wallet's state, all fields on the BrowserWalletState JavaScript object are Svelte 5 runes, meaning when using the accessor, these values are reactive.

<script lang="ts">
  import { BrowserWalletState } from "@meshsdk/svelte";
</script>

wallet is a Browser Wallet instance, which expose all CIP wallets functions from getting assets to signing tranasction.

connected, a boolean, true if user's wallet is connected.

name, a string, the name of the connect wallet.

connecting, a boolean, true if the wallet is connecting and initializing.