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.

Set up a Supabase project with sample data

Create a new project in the Supabase Dashboard.

After your project is ready, create a table in your Supabase database using the SQL Editor in the Dashboard. Use the following SQL statement to create a countries table with some sample data.

SQL_EDITOR

 -- Create the table
 CREATE TABLE countries (
   id SERIAL PRIMARY KEY,
   name VARCHAR(255) NOT NULL
 );
 -- Insert some sample data into the table
 INSERT INTO countries (name) VALUES ('United States');
 INSERT INTO countries (name) VALUES ('Canada');
 INSERT INTO countries (name) VALUES ('Mexico');

Create a React app

Create a React app using a Vite template.

Terminal

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

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

Query data from the app

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

Add a getCountries 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 [countries, setCountries] = useState([]);
    useEffect(() => {
      getCountries();
    }, []);
    async function getCountries() {
      const { data } = await supabase.from("countries").select();
      setCountries(data);
    }
    return (
      <ul>
        {countries.map((country) => (
          <li key={country.name}>{country.name}</li>
        ))}
      </ul>
    );
  }
  export default App;

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 countries.

Terminal

npm run dev

Edit this page on GitHub