Getting Started

Use Supabase with React

Learn how to create a Supabase project, add some sample data to your database, and query the data from a React app.

1

Create a Supabase project

Go to database.new and create a new Supabase project.

When your project is up and running, go to the Table Editor, create a new table and insert some data.

Alternatively, you can run the following snippet in your project's SQL Editor. This will create a instruments table with some sample data.

SQL_EDITOR
-- Create the table
create table instruments (
id bigint primary key generated always as identity,
name text not null
);
-- Insert some sample data into the table
insert into instruments (name)
values
('violin'),
('viola'),
('cello');

alter table instruments enable row level security;

Make the data in your table publicly readable by adding an RLS policy:

SQL_EDITOR
create policy "public can read instruments"
on public.instruments
for select to anon
using (true);
2

Create a React app

Create a React app using a Vite template.

Terminal
npm create vite@latest my-app -- --template react
3

Install the Supabase client library

The fastest way to get started is to use the supabase-js client library which provides a convenient interface for working with Supabase from a React app.

Navigate to the React app and install supabase-js.

Terminal
cd my-app && npm install @supabase/supabase-js
4

Query data from the app

In App.jsx, create a Supabase client using your project URL and public API (anon) key:

Project URL

To get your Project URL, log in.

Anon key

To get your Anon key, log in.

Add a getInstruments function to fetch the data and display the query result to the page.

src/App.jsx
import { useEffect, useState } from "react";
import { createClient } from "@supabase/supabase-js";

const supabase = createClient("https://<project>.supabase.co", "<your-anon-key>");

function App() {
const [instruments, setInstruments] = useState([]);

useEffect(() => {
getInstruments();
}, []);

async function getInstruments() {
const { data } = await supabase.from("instruments").select();
setInstruments(data);
}

return (
<ul>
{instruments.map((instrument) => (
<li key={instrument.name}>{instrument.name}</li>
))}
</ul>
);
}

export default App;
5

Start the app

Start the app, go to http://localhost:5173 in a browser, and open the browser console and you should see the list of instruments.

Terminal
npm run dev

Next steps

    1. We use first-party cookies to improve our services.

      Learn more•