npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

convex-svelte

v0.0.9

Published

[Convex](https://www.convex.dev/) is the typesafe backend-as-a-service with realtime updates, server functions, crons and scheduled jobs, file storage, vector search, and more.

Downloads

238

Readme

Convex is the typesafe backend-as-a-service with realtime updates, server functions, crons and scheduled jobs, file storage, vector search, and more.

Quickstart

convex-svelte

Receive live updates to Convex query subscriptions and call mutations and actions from Svelte with convex-svelte.

To install:

npm install convex convex-svelte

Run npx convex init to get started with Convex.

See the example app live.

convex-svelte provides a setupConvex() function which takes a Convex deployment URL, a useConvexClient() which returns a ConvexClient used to set authentication credentials and run Convex mutations and actions, and a useQuery() function for subscribing to Convex queries.

Example

Call setupConvex() 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}

Running a mutation looks like

<script>
	const client = useConvexClient();

	let toSend = $state('');
	let author = $state('me');

	function onSubmit(e: SubmitEvent) {
		const data = Object.fromEntries(new FormData(e.target as HTMLFormElement).entries());
		client.mutation(api.messages.send, {
			author: data.author as string,
			body: data.body as string
		});
	}
</script>

<form on:submit|preventDefault={onSubmit}>
	<input type="text" id="author" name="author" />
	<input type="text" id="body" name="body" bind:value={toSend} />
	<button type="submit" disabled={!toSend}>Send</button>
</form>

Deploying a Svelte App

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.

Trying out this library

Clone this repo and install dependencies with npm install then 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.

Developing this library

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.

Publishing

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