mirror of
https://github.com/supabase/supabase.git
synced 2026-05-11 19:26:38 +08:00
ed123799ca
## I have read the [CONTRIBUTING.md](https://github.com/supabase/supabase/blob/master/CONTRIBUTING.md) file. YES <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Documentation** * Clarified API key changes (new publishable/secret scheme, where to obtain each, legacy keys valid through end of 2026) and updated many getting-started tutorials with clearer setup, flow, and auth guidance. * **New Features** * Added/expanded profile photo/avatar upload and account integration steps across multiple tutorials. * **Guides** * Added guidance on auth helper methods and when to use them. * **Examples** * Example app updated to use token claims for auth state. <!-- end of auto-generated comment: release notes by coderabbit.ai --> --------- Co-authored-by: Katerina Skroumpelou <mandarini@users.noreply.github.com> Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
132 lines
3.9 KiB
Plaintext
132 lines
3.9 KiB
Plaintext
---
|
|
title: 'Build a User Management App with Svelte'
|
|
description: 'Learn how to use Supabase in your Svelte App.'
|
|
---
|
|
|
|
<$Partial path="quickstart_intro.mdx" />
|
|
|
|
|
|
|
|
<Admonition type="note">
|
|
|
|
If you get stuck while working through this guide, you can find the [full example on GitHub](https://github.com/supabase/supabase/tree/master/examples/user-management/svelte-user-management).
|
|
|
|
</Admonition>
|
|
|
|
<$Partial path="project_setup.mdx" variables={{ "framework": "sveltekit", "tab": "frameworks" }} />
|
|
|
|
## Building the app
|
|
|
|
Start building the Svelte app from scratch.
|
|
|
|
### Initialize a Svelte app
|
|
|
|
You can use the Vite Svelte TypeScript Template to initialize an app called `supabase-svelte`:
|
|
|
|
```bash
|
|
npm create vite@latest supabase-svelte -- --template svelte-ts
|
|
cd supabase-svelte
|
|
npm install
|
|
```
|
|
|
|
Install the only additional dependency: [supabase-js](https://github.com/supabase/supabase-js)
|
|
|
|
```bash
|
|
npm install @supabase/supabase-js
|
|
```
|
|
|
|
Finally, save the environment variables in a `.env`.
|
|
All you need are the API URL and the key that you copied [earlier](#get-api-details).
|
|
|
|
<$CodeTabs>
|
|
|
|
```bash name=.env
|
|
VITE_SUPABASE_URL=YOUR_SUPABASE_URL
|
|
VITE_SUPABASE_PUBLISHABLE_KEY=YOUR_SUPABASE_PUBLISHABLE_KEY
|
|
```
|
|
|
|
</$CodeTabs>
|
|
|
|
Now you have the API credentials in place, create a helper file to initialize the Supabase client. These variables will be exposed on the browser, and that's fine since you have [Row Level Security](/docs/guides/auth#row-level-security) enabled on the Database.
|
|
|
|
<$CodeSample
|
|
path="/user-management/svelte-user-management/src/supabaseClient.ts"
|
|
meta="name=src/supabaseClient.ts"
|
|
/>
|
|
|
|
### App styling (optional)
|
|
|
|
Optionally, update the CSS file `src/app.css` to make the app look better.
|
|
You can find the full contents of this file [in the example repository](https://raw.githubusercontent.com/supabase/supabase/master/examples/user-management/svelte-user-management/src/app.css).
|
|
|
|
### Set up a login component
|
|
|
|
Set up a Svelte component to manage logins and sign ups. It uses Magic Links, so users can sign in with their email without using passwords.
|
|
|
|
<$CodeSample
|
|
path="/user-management/svelte-user-management/src/lib/Auth.svelte"
|
|
meta="name=src/lib/Auth.svelte"
|
|
/>
|
|
|
|
### Account page
|
|
|
|
After a user is signed in, allow them to edit their profile details and manage their account.
|
|
Create a new component for that called `Account.svelte`.
|
|
|
|
<$CodeSample
|
|
path="/user-management/svelte-user-management/src/lib/Account.svelte"
|
|
lines={[[1, 4], [6, 79], [81, -1]]}
|
|
meta="src/lib/Account.svelte"
|
|
/>
|
|
|
|
## Profile photos
|
|
|
|
Next, add a way for users to upload a profile photo. Supabase configures every project with [Storage](/docs/guides/storage) for managing large files like photos and videos.
|
|
|
|
### Create an upload widget
|
|
|
|
Start by creating a new component:
|
|
|
|
<$CodeSample
|
|
path="/user-management/svelte-user-management/src/lib/Avatar.svelte"
|
|
lines={[[1, -1]]}
|
|
meta="name=src/lib/Avatar.svelte"
|
|
/>
|
|
|
|
### Update the account component
|
|
|
|
With the Avatar component created, update `src/lib/Account.svelte` to include it:
|
|
|
|
<$CodeSample
|
|
path="/user-management/svelte-user-management/src/lib/Account.svelte"
|
|
lines={[[1, -1]]}
|
|
meta="name=src/lib/Account.svelte"
|
|
/>
|
|
|
|
### Launch!
|
|
|
|
With all the components in place, update `App.svelte`:
|
|
|
|
<$CodeSample
|
|
path="/user-management/svelte-user-management/src/App.svelte"
|
|
meta="name=src/App.svelte"
|
|
/>
|
|
|
|
Once that's done, run this in a terminal window:
|
|
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
And then open the browser to [localhost:5173](http://localhost:5173) and you should see the completed app.
|
|
|
|
<Admonition type="tip">
|
|
|
|
Svelte uses Vite and the default port is `5173`, Supabase uses `port 3000`. To change the redirection port for Supabase go to: **Authentication > URL Configuration** and change the **Site URL** to `http://localhost:5173/`
|
|
|
|
</Admonition>
|
|
|
|
|
|
|
|
At this stage you have a fully functional application!
|