Convex client for Svelte.

npm install convex-svelte 

See the example app live.

Currently exposes a setupConvex() function which takes a Convex deployment URL, a useConvexClient() function and a useQuery() function.

Call setConvex() in a component above the components that need to Convex queries and use useQuery() components where you need to listen to the query.

See +layout.svelte for setupConvex()

<script> import { PUBLIC_CONVEX_URL } from '$env/static/public';  setupConvex(PUBLIC_CONVEX_URL); </script>

and Chat.svelte for how to use useQuery()

<script> const query = useQuery(api.messages.list, () => ({ muteWords }), { useResultFromPreviousArguments: true }); </script> ... {#if query.isLoading}	Loading... {:else if query.error != null}	failed to load: {query.error.toString()} {:else}	<ul>	{#each query.data as message}	<li>	<span>{message.author}</span>	<span>{message.body}</span>	</li>	{/each}	</ul> {/if}

In production build pipelines use the build command

npx convex deploy --cmd-url-env-var-name PUBLIC_CONVEX_URL --cmd 'npm run build'

to build your Svelte app and deploy Convex functions.

Once you've created a project and installed dependencies with npm install start a development server:

npm run dev

This will run you through creating a Convex account and a deployment.

Everything inside src/lib is part of the library, everything inside src/routes is an example app.

To build the library:

npm run package

To create a production version of the showcase app:

npm run build

You can preview the production build with npm run preview.

To deploy your app, you may need to install an adapter for your target environment.

Go into the package.json and give your package the desired name through the "name" option. Also consider adding a "license" field and point it to a LICENSE file which you can create from a template (one popular option is the MIT license).

To publish your library to npm:

npm publish