nuxt3-supabase

Nuxt 3 module and composables for Supabase.

🚧 Nuxt 3 is currently in beta, keep in mind that it is not yet production ready.

Installation

$ yarn add nuxt3-supabase
# or
$ npm install --save nuxt3-supabase

Getting Started

Add the following to your nuxt.config.ts file.

export default defineNuxtConfig({
  modules: ['nuxt3-supabase/module'],
  supabase: {
    supabaseUrl: process.env.SUPABASE_URL,
    supabaseKey: process.env.SUPABASE_KEY,
    supabaseOptions: process.env.SUPABASE_OPTIONS // not required
  }
});

Usage

<script setup>
  const { $supabase } = useNuxtApp();

  const { data, pending } = await useAsyncData('posts', () => {
    return $supabase.from('posts').select();
  });
</script>

<template>
  <div v-if="pending">Loading...</div>
  <div v-else>{{ data }}</div>
</template>

Composables

useSupabase

Supabase client composable.

import { useSupabase } from 'nuxt3-supabase';

const supabase = useSupabase();

useAuth

Supabase Auth composable.

import { useAuth } from 'nuxt3-supabase';

const { user, signIn, signOut } = useAuth();

useStorage

Supabase Storage composable.

import { useStorage } from 'nuxt3-supabase';

const storage = useStorage();

useFrom

Supabase Database composable.

import { useFrom } from 'nuxt3-supabase';

const from = useFrom();

useOnAuthStateChange

Behaves similarly to onAuthStateChange but also sets/unsets auth cookie to the server.

import { useOnAuthStateChange } from 'nuxt3-supabase';

useOnAuthStateChange((event, session) => {
  console.log(event, session);
});

getSession

Get the server session that was set by useOnAuthStateChange.

<script setup>
  import { useOnAuthStateChange, getSession } from 'nuxt3-supabase';

  const nuxtApp = useNuxtApp();

  const { data } = await useAsyncData('user', () =>
    getSession(nuxtApp.ssrContext)
  );

  useOnAuthStateChange();
</script>

TIP: You can use getSession to check if a user is authenticated before route load.

getServerSession

A helper function to get current user in API routes. This requires passing of the key and url again.

export default defineNuxtConfig({
  modules: ['nuxt3-supabase/module'],
  supabase: {
    supabaseUrl: process.env.SUPABASE_URL,
    supabaseKey: process.env.SUPABASE_KEY
  },
  privateRuntimeConfig: {
    supabaseUrl: process.env.SUPABASE_URL,
    supabaseKey: process.env.SUPABASE_KEY
  }
});

import runtimeConfig from '#config';
import { getServerSession } from 'nuxt3-supabase';

export default async (req, res) => {
  const user = await getServerSession(req, {
    supabaseUrl: runtimeConfig.supabaseUrl,
    supabaseKey: runtimeConfig.supabaseKey
  });

  if (!user) {
    res.statusCode = 400;
    res.end('Unauthorized!');
  }

  return {
    user
  };
};

License

MIT