create-svelte

Everything you need to build a Svelte project with WunderGraph + SvelteQuery + SSR, powered by create-svelte.

Creating a project

If you're seeing this, you've probably already done this step. Congrats!

# create a new project in the current directory
npm create svelte@latest

# create a new project in my-app
npm create svelte@latest my-app

Developing

Once you've created a project and installed dependencies with npm install (or pnpm install or yarn), start a development server:

npm run dev

# or start the server and open the app in a new browser tab
npm run dev -- --open

Building

To create a production version of your app:

npm run build

Using Wundergraph

SSR

// In lib/wundergraph
import { createSvelteClient } from '@wundergraph/svelte-query';
import { createClient } from '../../.wundergraph/generated/client';
import type { Operations } from '../../.wundergraph/generated/client';

const client = createClient();

const { createFileUpload, createMutation, createQuery, createSubscription, getAuth, getUser, queryKey } =
  createSvelteClient<Operations>(client);

export { createFileUpload, createMutation, createQuery, createSubscription, getAuth, getUser, queryKey };

// In +page.ts file
import { prefetchQuery } from '$lib/wundergraph';
import type { PageLoad } from './$types';

export const load: PageLoad = async ({ parent }) => {
  const { queryClient } = await parent();

  await prefetchQuery(
    {
      operationName: 'Dragons',
    },
    queryClient
  );
};

Client side

<!-- In +page.svelte -->
<script lang="ts">
	import { createQuery } from '$lib/wundergraph';

	const dragonsQuery = createQuery({
		operationName: 'Dragons',
	});
</script>

<div class="results">
	{#if $dragonsQuery.isLoading}
		<p>Loading...</p>
	{:else if $dragonsQuery.error}
		<pre>Error: {JSON.stringify($dragonsQuery.error, null, 2)}</pre>
	{:else}
		<pre>{JSON.stringify($dragonsQuery.data, null, 2)}</pre>
	{/if}
</div>

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.